import static com.google.common.base.Preconditions.checkNotNull;

import java.util.Map;
import org.jspecify.annotations.Nullable;

/**
 * A {@link MapIteratorCache} that adds additional caching. In addition to the caching provided by
 * {@link MapIteratorCache}, this structure caches values for the two most recently retrieved keys.
 *
 * @author James Sexton
 */
final class MapRetrievalCache<K, V> extends MapIteratorCache<K, V> {

     * - Build-wide configuration
     * - Project model caching
     * - Inter-module metadata
     */
    SESSION_SCOPED,

    /**
     * Data should only be retained for the current build request.
     * Suitable for:
     * - Plugin execution results
     * - Temporary build artifacts
     * - Phase-specific data
     */
    REQUEST_SCOPED,

    /**
     * Caching should be disabled for this data.
     * Suitable for:

import static com.google.common.base.Preconditions.checkNotNull;

import java.util.Map;
import org.jspecify.annotations.Nullable;

/**
 * A {@link MapIteratorCache} that adds additional caching. In addition to the caching provided by
 * {@link MapIteratorCache}, this structure caches values for the two most recently retrieved keys.
 *
 * @author James Sexton
 */
final class MapRetrievalCache<K, V> extends MapIteratorCache<K, V> {

- Support for query parameters, headers, body (String or stream), compression, SSL configuration, proxies, and timeouts
- Automatic in-memory or on-disk caching of request/response bodies
- Synchronous and asynchronous (callback) execution
- Minimal dependencies (only Apache Commons IO)

## Installation

### Maven

        this.leaseState = leaseState;
    }

    /**
     * Gets the cache scope for directory enumeration caching
     * @return the cache scope
     */
    public DirectoryCacheScope getCacheScope() {
        return cacheScope;
    }

    /**
     * Sets the cache scope for directory enumeration caching
     * @param cacheScope the cache scope to set
     */

        /**
         * Check if lease has read caching
         *
         * @return true if read caching is enabled
         */
        public boolean hasReadCache() {
            return Smb2LeaseState.hasReadCaching(leaseState);
        }

        /**
         * Check if lease has write caching
         *
         * @return true if write caching is enabled
         */

	// Parameters:
	//   ctx: The context for the request, which can carry deadlines, cancellation signals, etc.
	//   key: The key representing the SQL query, used for caching and preparing the statement.
	//   isTransaction: Indicates whether this operation is part of a transaction, which may affect the caching strategy.
	//   connPool: A connection pool that provides database connections.

org.gradle.caching=true
org.gradle.parallel=true

android.useAndroidX=true
kotlin.mpp.applyDefaultHierarchyTemplate=false

androidBuild=false
graalBuild=false
loomBuild=false
containerTests=false

- [ ] Implement directory metadata caching
- [ ] Add directory change notification integration
- [ ] Create parent-child lease relationships
- [ ] Implement directory lease break handling
- [ ] Add directory enumeration caching

#### 4.3 Integration Points
- Extend `SmbFile` for directory lease support
- Modify directory listing operations for caching
- Update change notification handling

---

/**
 * A builder of {@link LoadingCache} and {@link Cache} instances.
 *
 * <h2>Prefer <a href="https://github.com/ben-manes/caffeine/wiki">Caffeine</a> over Guava's caching
 * API</h2>
 *
 * <p>The successor to Guava's caching API is <a
 * href="https://github.com/ben-manes/caffeine/wiki">Caffeine</a>. Its API is designed to make it a