Package com.launchdarkly.sdk.server.integrations

Enum PersistentDataStoreBuilder.StaleValuesPolicy

java.lang.Object
java.lang.Enum<PersistentDataStoreBuilder.StaleValuesPolicy>
com.launchdarkly.sdk.server.integrations.PersistentDataStoreBuilder.StaleValuesPolicy
All Implemented Interfaces:
java.io.Serializable, java.lang.Comparable<PersistentDataStoreBuilder.StaleValuesPolicy>, java.lang.constant.Constable
Enclosing class:
PersistentDataStoreBuilder
public static enum PersistentDataStoreBuilder.StaleValuesPolicy
extends java.lang.Enum<PersistentDataStoreBuilder.StaleValuesPolicy>
Possible values for PersistentDataStoreBuilder.staleValuesPolicy(StaleValuesPolicy).

  • Nested Class Summary

    Nested classes/interfaces inherited from class java.lang.Enum

    java.lang.Enum.EnumDesc<E extends java.lang.Enum<E>>

  • Enum Constant Summary

    Enum Constants 
    Enum Constant Description
    EVICT
    Indicates that when the cache TTL expires for an item, it is evicted from the cache.
    REFRESH
    Indicates that the cache should refresh stale values instead of evicting them.
    REFRESH_ASYNC
    Indicates that the cache should refresh stale values asynchronously instead of evicting them.

  • Method Summary

    Modifier and Type Method Description
    static PersistentDataStoreBuilder.StaleValuesPolicy valueOf​(java.lang.String name)
    Returns the enum constant of this type with the specified name.
    static PersistentDataStoreBuilder.StaleValuesPolicy[] values()
    Returns an array containing the constants of this enum type, in the order they are declared.

    Methods inherited from class java.lang.Enum

    clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

  • Enum Constant Details

    • EVICT

      public static final PersistentDataStoreBuilder.StaleValuesPolicy EVICT
      Indicates that when the cache TTL expires for an item, it is evicted from the cache. The next attempt to read that item causes a synchronous read from the underlying data store; if that fails, no value is available. This is the default behavior.
      See Also:
      CacheBuilder.expireAfterWrite(long, TimeUnit)

    • REFRESH

      public static final PersistentDataStoreBuilder.StaleValuesPolicy REFRESH
      Indicates that the cache should refresh stale values instead of evicting them.

      In this mode, an attempt to read an expired item causes a synchronous read from the underlying data store, like EVICT--but if an error occurs during this refresh, the cache will continue to return the previously cached values (if any). This is useful if you prefer the most recently cached feature rule set to be returned for evaluation over the default value when updates go wrong.

      See: CacheBuilder for more specific information on cache semantics. This mode is equivalent to expireAfterWrite.

    • REFRESH_ASYNC

      public static final PersistentDataStoreBuilder.StaleValuesPolicy REFRESH_ASYNC
      Indicates that the cache should refresh stale values asynchronously instead of evicting them.

      This is the same as REFRESH, except that the attempt to refresh the value is done on another thread (using a Executor). In the meantime, the cache will continue to return the previously cached value (if any) in a non-blocking fashion to threads requesting the stale key. Any exception encountered during the asynchronous reload will cause the previously cached value to be retained.

      This setting is ideal to enable when you desire high performance reads and can accept returning stale values for the period of the async refresh. For example, configuring this feature store with a very low cache time and enabling this feature would see great performance benefit by decoupling calls from network I/O.

      See: CacheBuilder for more specific information on cache semantics.

  • Method Details

    • values

      public static PersistentDataStoreBuilder.StaleValuesPolicy[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared

    • valueOf

      public static PersistentDataStoreBuilder.StaleValuesPolicy valueOf​(java.lang.String name)
      Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
      java.lang.NullPointerException - if the argument is null