# Interface BuildCacheServiceFactory.Describer

Enclosing interface:
  `BuildCacheServiceFactory<T extends BuildCache>`

@Incubating 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.

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