# Interface BuildCacheServiceFactory.Describer

Enclosing interface:
  `BuildCacheServiceFactory<T extends BuildCache>`

public static interface BuildCacheServiceFactory.Describer
Builder-style object that allows build cache service factories to describe the cache service.

The description is for human consumption. It may be logged and displayed by tooling.

Since:
  4.0

- ## Method Summary

  Modifier and Type
  Method
  Description
  `BuildCacheServiceFactory.Describer`
  `config(String name, String value)`
  Sets a configuration param of the cache being used.
  `BuildCacheServiceFactory.Describer`
  `type(String type)`
  Sets the description of the type of cache being used.

- ## Method Details

  - ### type

    BuildCacheServiceFactory.Describer type(String type)
    Sets the description of the type of cache being used.

    The value should not include particulars about the cache; only a human friendly description of the kind of cache. For example, instead of `"HTTP @ https://some/cache"` it should be just `"HTTP"`. Particular configuration should be set via `config(String, String)`.

    `BuildCacheServiceFactory` implementations should always return the same value for the same cache "type". All implementations should call this method.

    Values should be lowercase, except where using an acronym (e.g. HTTP).

    Subsequent calls to this method replace the previously set value.

    Since:
      4.0

  - ### config

    BuildCacheServiceFactory.Describer config(String name, String value)
    Sets a configuration param of the cache being used.

    e.g. `config("location", "https://some/cache")`.

    Values may be logged. Secrets (e.g. passwords) should not be declared with this method.

    Implementations should describe their config where possible.

    Subsequent calls to this method with the same `name` argument will replace the previously supplied `value` argument.

    Subsequent calls to this method with different `name` arguments will append values.

    Since:
      4.0