Class CacheBuilderSpec

guava/src/com/google/common/cache/CacheBuilderSpec.java:85–494

A specification of a {@link CacheBuilder} configuration. <p>{@code CacheBuilderSpec} supports parsing configuration off of a string, which makes it especially useful for command-line configuration of a {@code CacheBuilder}. <p>The string syntax is a series of comma-separated keys or key-value pair

 * @since 12.0
 */
@SuppressWarnings(class="st">"GoodTime") class="cm">// lots of violations (nanosecond math)
@GwtIncompatible
public final class CacheBuilderSpec {
  /** Parses a single value. */
  private interface ValueParser {
    void parse(CacheBuilderSpec spec, String key, @Nullable String value);
  }

  /** Splits each key-value pair. */
  private static final Splitter KEYS_SPLITTER = Splitter.on(class="st">',').trimResults();

  /** Splits the key from the value. */
  private static final Splitter KEY_VALUE_SPLITTER = Splitter.on(class="st">'=').trimResults();

  /** Map of names to ValueParser. */
  private static final ImmutableMap<String, ValueParser> VALUE_PARSERS =
      ImmutableMap.<String, ValueParser>builder()
          .put(class="st">"initialCapacity", new InitialCapacityParser())
          .put(class="st">"maximumSize", new MaximumSizeParser())
          .put(class="st">"maximumWeight", new MaximumWeightParser())
          .put(class="st">"concurrencyLevel", new ConcurrencyLevelParser())
          .put(class="st">"weakKeys", new KeyStrengthParser(Strength.WEAK))
          .put(class="st">"softValues", new ValueStrengthParser(Strength.SOFT))
          .put(class="st">"weakValues", new ValueStrengthParser(Strength.WEAK))
          .put(class="st">"recordStats", new RecordStatsParser())
          .put(class="st">"expireAfterAccess", new AccessDurationParser())
          .put(class="st">"expireAfterWrite", new WriteDurationParser())
          .put(class="st">"refreshAfterWrite", new RefreshDurationParser())
          .put(class="st">"refreshInterval", new RefreshDurationParser())
          .buildOrThrow();

  @VisibleForTesting @Nullable Integer initialCapacity;
  @VisibleForTesting @Nullable Long maximumSize;
  @VisibleForTesting @Nullable Long maximumWeight;
  @VisibleForTesting @Nullable Integer concurrencyLevel;
  @VisibleForTesting @Nullable Strength keyStrength;
  @VisibleForTesting @Nullable Strength valueStrength;
  @VisibleForTesting @Nullable Boolean recordStats;
  @VisibleForTesting long writeExpirationDuration;
  @VisibleForTesting @Nullable TimeUnit writeExpirationTimeUnit;
  @VisibleForTesting long accessExpirationDuration;
  @VisibleForTesting @Nullable TimeUnit accessExpirationTimeUnit;
  @VisibleForTesting long refreshDuration;
  @VisibleForTesting @Nullable TimeUnit refreshTimeUnit;

  /** Specification; used for toParseableString(). */
  private final String specification;

  private CacheBuilderSpec(String specification) {
    this.specification = specification;
  }

  /**
   * Creates a CacheBuilderSpec from a string.
   *
   * @param cacheBuilderSpecification the string form
   */
  public static CacheBuilderSpec parse(String cacheBuilderSpecification) {