Package org.gradle.caching

Schnittstelle BuildCacheService

Alle Superschnittstellen:
AutoCloseable, Closeable
Alle bekannten Implementierungsklassen:
MapBasedBuildCacheService
public interface BuildCacheService extends Closeable
Protocol interface to be implemented by a client to a build cache backend.

Build cache implementations should report a non-fatal failure as a BuildCacheException. Non-fatal failures could include failing to retrieve a cache entry or unsuccessfully completing an upload a new cache entry. Gradle will not fail the build when catching a BuildCacheException, but it may disable caching for the build if too many failures occur.

All other failures will be considered fatal and cause the Gradle build to fail. Fatal failures could include failing to read or write cache entries due to file permissions, authentication or corruption errors.

Every build cache implementation should define a org.gradle.caching.configuration.BuildCache configuration and BuildCacheServiceFactory factory.

Seit:
3.5

  • Methodenübersicht

    Modifizierer und Typ
    Methode
    Beschreibung
    void
    close()
    Clean up any resources held by the cache once it's not used anymore.
    boolean
    load(BuildCacheKey key, BuildCacheEntryReader reader)
    Load the cached entry corresponding to the given cache key.
    void
    store(BuildCacheKey key, BuildCacheEntryWriter writer)
    Store the cache entry with the given cache key.

  • Methodendetails

    • load

      boolean load(BuildCacheKey key, BuildCacheEntryReader reader) throws BuildCacheException
      Load the cached entry corresponding to the given cache key. The reader will be called if an entry is found in the cache.
      Parameter:
      key - the cache key.
      reader - the reader to read the data corresponding to the cache key.
      Gibt zurück:
      true if an entry was found, false otherwise.
      Löst aus:
      BuildCacheException - if the cache fails to load a cache entry for the given key

    • store

      void store(BuildCacheKey key, BuildCacheEntryWriter writer) throws BuildCacheException
      Store the cache entry with the given cache key. The writer will be called to actually write the data.
      Parameter:
      key - the cache key.
      writer - the writer to write the data corresponding to the cache key.
      Löst aus:
      BuildCacheException - if the cache fails to store a cache entry for the given key

    • close

      void close() throws IOException
      Clean up any resources held by the cache once it's not used anymore.
      Angegeben von:
      close in Schnittstelle AutoCloseable
      Angegeben von:
      close in Schnittstelle Closeable
      Löst aus:
      IOException - if the cache fails to close cleanly.