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

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

	// 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.

import java.net.http.HttpRequest
import java.net.http.HttpResponse


private
data class GradleServicesVersion(val version: String, val buildTime: String)


@DisableCachingByDefault(because = "Not worth caching")
abstract class PreparePatchRelease : DefaultTask() {

    @get:Internal
    abstract val versionFile: RegularFileProperty

    @get:Internal
    abstract val releasedVersionsFile: RegularFileProperty

import org.gradle.api.provider.Property
import org.gradle.api.tasks.Internal
import org.gradle.api.tasks.TaskAction
import org.gradle.work.DisableCachingByDefault


@DisableCachingByDefault(because = "Not worth caching")
abstract class UpdateReleasedVersions : DefaultTask() {

    @get:Internal
    abstract val releasedVersionsFile: RegularFileProperty

    @get:Internal

        // No matching host header
        String key = virtualHostHelper.getVirtualHostKey();
        assertEquals("", key);

        // Matching host header
        request.addHeader("Host", "example.com");
        key = virtualHostHelper.getVirtualHostKey();
        assertEquals("", key); // Still empty due to caching

        // Test caching by calling again - should return cached value

    "linux" : 771,
    "windows" : 939,
    "macOs" : 557
  } ]
}, {
  "scenario" : "org.gradle.performance.regression.android.AndroidIncrementalExecutionPerformanceTest.abi change with configuration caching",
  "durations" : [ {
    "testProject" : "nowInAndroidBuild",
    "linux" : 384,
    "windows" : 479,
    "macOs" : 368
  }, {
    "testProject" : "santaTrackerAndroidBuild",
    "linux" : 673,

            // Clean up system property
            System.clearProperty(Constants.FESS_CONFIG_PREFIX + testKey);
        }
    }

    // Test caching mechanism
    @Test
    public void test_get_caching() {
        // Get property twice to test caching behavior
        String testKey = "domain.title";
        String value1 = fessConfig.get(testKey);
        String value2 = fessConfig.get(testKey);

import org.gradle.work.DisableCachingByDefault
import java.text.SimpleDateFormat
import java.util.Date
import java.util.Properties
import java.util.TimeZone


@DisableCachingByDefault(because = "Not worth caching")
abstract class BuildReceipt : DefaultTask() {
    companion object {
        private
        val timestampFormat = newSimpleDateFormatUTC("yyyyMMddHHmmssZ")

        private

        valueParser.parse(spec, key, value);
      }
    }

    return spec;
  }

  /** Returns a CacheBuilderSpec that will prevent caching. */
  public static CacheBuilderSpec disableCaching() {
    // Maximum size of zero is one way to block caching
    return CacheBuilderSpec.parse("maximumSize=0");
  }

  /** Returns a CacheBuilder configured according to this instance's specification. */