#### 2.1 Core Persistent Handle Infrastructure
```
Package: jcifs.internal.smb2.persistent
├── PersistentHandleContext.java     - Persistent handle create context
├── PersistentHandleManager.java     - Handle persistence management
├── DurableHandleRequest.java        - Durable handle v1 support
├── DurableHandleV2Request.java      - Durable handle v2 with timeout
└── HandleReconnector.java           - Automatic handle reconnection
```

import jakarta.annotation.Resource;

/**
 * Service class for managing favorite log operations.
 * Provides functionality to add URLs to user favorites and retrieve favorite URL lists.
 * This service handles the persistence and retrieval of favorite log entries in the search system.
 */
public class FavoriteLogService {

    /**
     * Default constructor.
     */
    public FavoriteLogService() {
        // Default constructor

	httpStats := newHTTPStats()
	// Simulate the concurrent scenario from the original race condition:
	// Multiple HTTP request handlers updating stats concurrently,
	// while background processes are reading the stats for persistence.
	const numWriters = 100 // Simulate many HTTP request handlers.
	const numReaders = 50  // Simulate background stats readers.
	const opsPerGoroutine = 100

	var wg sync.WaitGroup
	for i := range numWriters {

 * These changes might break things in subtle ways otherwise.
 */
val keepPatterns = mapOf(
    "it.unimi.dsi:fastutil" to setOf(
        // For persistence cache
        "it.unimi.dsi.fastutil.longs.Long2IntOpenHashMap",
        // For Java compilation incremental analysis
        "it.unimi.dsi.fastutil.ints.IntOpenHashSet",
        "it.unimi.dsi.fastutil.ints.IntSets",

"^smb://.*"        → smbClient
"^storage://.*"    → storageClient
```

### Services

**UrlQueueService**: URL queue management (FIFO), duplicate detection via `visited()`
**DataService**: Access result persistence, iteration

**Implementations**:
- `UrlQueueServiceImpl`, `DataServiceImpl`: In-memory (default)
- `OpenSearchDataService`: OpenSearch backend (persistent)

### Processing Pipeline

```

            log.error("Failed to create handle state directory: " + stateDirectory, e);
        }

        // Load persisted handles on startup
        loadPersistedHandles();

        // Schedule periodic persistence and cleanup
        scheduler.scheduleAtFixedRate(this::periodicMaintenance, 30, 30, TimeUnit.SECONDS);
    }

    /**
     * Request a new durable handle
     * @param path the file path

        return CacheStrategy(request, null)
      }

      // If this response shouldn't have been stored, it should never be used as a response source.
      // This check should be redundant as long as the persistence store is well-behaved and the
      // rules are constant.
      if (!isCacheable(cacheResponse, request)) {
        return CacheStrategy(request, null)
      }

      val requestCaching = request.cacheControl

            cb.query().setName_Equal(username);
        });
    }

    /**
     * Stores (inserts or updates) a user in the system.
     * Handles user authentication setup and database persistence.
     * If the surname is blank, it will be set to the user's name.
     *
     * @param user the user entity to store
     */
    public void store(final User user) {

- **Extensible Architecture**: Plugin system for custom extractors, transformers, and clients
- **Rate Limiting**: Politeness policies and interval controllers
- **URL Filtering**: Regex-based inclusion/exclusion patterns
- **Data Persistence**: Multiple backend options including OpenSearch integration

## Technology Stack

- **Java**: 21+ (requires Java 21 or higher)
- **Build System**: Maven 3.x
- **DI Container**: LastaFlute DI

        // Field modification should be reflected in getter
        transformer.name = "modifiedField";
        assertEquals("modifiedField", transformer.getName());
    }

    /**
     * Test name persistence across operations
     */
    public void test_namePersistence() {
        testTransformer.setName("persistentName");

        // Perform multiple transforms
        for (int i = 0; i < 10; i++) {