Caching
=======

OkHttp implements an optional, off by default, Cache. OkHttp aims for RFC correct and
pragmatic caching behaviour, following common real-world browser like Firefox/Chrome and
server behaviour when ambiguous.

# Basic Usage

```kotlin
  private val client: OkHttpClient = OkHttpClient.Builder()
      .cache(Cache(
          directory = File(application.cacheDir, "http_cache"),
          // $0.05 worth of phone storage in 2020

public class Smb2LeaseState {

    /**
     * No lease caching
     */
    public static final int SMB2_LEASE_NONE = 0x00;

    /**
     * Read caching lease (R)
     */
    public static final int SMB2_LEASE_READ_CACHING = 0x01;

    /**
     * Handle caching lease (H)
     */
    public static final int SMB2_LEASE_HANDLE_CACHING = 0x02;

    /**
     * Write caching lease (W)
     */

import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.services.Request;
import org.apache.maven.api.services.Result;

/**
 * Interface for caching request results in Maven. This cache implementation provides
 * methods for executing and optionally caching both single requests and batches of requests.
 * <p>
 * The cache behavior is determined by the cache retention specified in the request's metadata.

 * under the License.
 */

/**
 * Provides a caching infrastructure for Maven requests and their results.
 * <p>
 * This package contains the core components for implementing and managing caches in Maven:
 * <ul>
 *   <li>{@link org.apache.maven.api.cache.RequestCache} - The main interface for caching request results</li>

#
# Maven Cache Configuration
#
# Controls caching behavior for different request types during Maven builds.
# Format: RequestType { scope:SCOPE ref:REFERENCE_TYPE }
#
# SCOPE OPTIONS:
#   session - Cache for entire Maven session (all modules in multi-module build)
#   request - Cache only for current request + its child requests
#   none    - Disable caching entirely
#
# REFERENCE OPTIONS:

 * It implements the Closeable interface to ensure that resources are properly released.
 *
 * <p>This class supports two types of content caching:
 * <ul>
 *   <li>In-memory caching using a byte array</li>
 *   <li>File-based caching using a File object</li>
 * </ul>
 *
 * <p>When an instance of ContentCache is created with a byte array, the content is cached in memory.

        // Should return true when read caching is enabled
        assertTrue(DirectoryLeaseState.canCacheEnumeration(Smb2LeaseState.SMB2_LEASE_READ_CACHING));
        assertTrue(DirectoryLeaseState.canCacheEnumeration(DirectoryLeaseState.DIRECTORY_READ_HANDLE));
        assertTrue(DirectoryLeaseState.canCacheEnumeration(DirectoryLeaseState.DIRECTORY_FULL));

        // Should return false when read caching is not enabled

        assertEquals(0x05, Smb2LeaseState.SMB2_LEASE_READ_WRITE);
        assertEquals(0x07, Smb2LeaseState.SMB2_LEASE_FULL);
    }

    @Test
    @DisplayName("Should detect read caching correctly")
    void testHasReadCaching() {
        assertTrue(Smb2LeaseState.hasReadCaching(Smb2LeaseState.SMB2_LEASE_READ_CACHING));
        assertTrue(Smb2LeaseState.hasReadCaching(Smb2LeaseState.SMB2_LEASE_READ_HANDLE));

    /**
     * Share flag indicating manual caching of documents.
     */
    public static final int SMB2_SHAREFLAG_MANUAL_CACHING = 0x0;
    /**
     * Share flag indicating automatic caching of documents.
     */
    public static final int SMB2_SHAREFLAG_AUTO_CACHING = 0x10;
    /**
     * Share flag indicating automatic caching of programs and documents.
     */

     * - 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: