Package com.broadleafcommerce.common.extension.cache

Class CacheStateManager

java.lang.Object
com.broadleafcommerce.common.extension.cache.CacheStateManager
public class CacheStateManager extends Object
Provides functionality to support interaction with the CacheManager. This includes detection of ability to cache, as well as cache acquisition functionality.
Author:
Jeff Fischer

  • Field Details

    • NULL_VALUE_WRAPPER

      public static final org.springframework.cache.Cache.ValueWrapper NULL_VALUE_WRAPPER

    • KEY_LIST

      public static final String KEY_LIST
      See Also:

  • Constructor Details

  • Method Details

    • isEnabled

      public boolean isEnabled(List<?> caches)
      Whether or not cache should be leveraged for the current call using the candidate caches.
      Parameters:
      caches - The caches to evaluate for enablement for the current call.
      Returns:
      Whether or not cache should be leveraged.

    • isEnabled

      public boolean isEnabled(List<?> caches, Object... params)
      Whether or not cache should be leveraged for the current call using the candidate caches.
      Parameters:
      caches - The caches to evaluate for enablement for the current call.
      params - The params passed to that method.
      Returns:
      Whether or not cache should be leveraged.

    • isForceCompile

      public boolean isForceCompile()
      Whether or not the cache should be ignored and all members computed and placed into cache.
      Returns:
      Whether or not the cache should be ignored and all members computed and placed into cache.

    • computeIfAbsent

      public <P> List<P> computeIfAbsent(@NonNull Function<List<String>,List<P>> computeFunction, @NonNull ImperativeListCacheInfo cacheInfo)
      Given a Function instance meant to generate values that are cacheable, check the cache using keys based on a collection of imperative key fragments. If a cache value is available for the complex key generated based on one of the imperative keys combined with the args, then that cache value is used. Any cached values not found will utilize the computeFunction to generate the uncached values, and those generated values will be cached. The sum of originally found cache and generated values are returned.

      Note, the results are not automatically sorted, and it's possible they'll be returned in a different order than how they were originally computed (for example, if the values are computed via database query employing a sort). If reliable sorting is required, then the results should be sorted in the calling method. Also, features like sorting can be universally applied via one or more implementations of CacheResultPostProcessor, which are executed before results are returned from here.
      Type Parameters:
      P - The return type
      Parameters:
      computeFunction - The Function instance responsible for generating uncached values
      cacheInfo - Required information to generate keys and interact with the CacheManager.
      Returns:
      The sum of cache hits and generated values

    • computeIfAbsent

      public <P> P computeIfAbsent(@NonNull Supplier<P> computeFunction, @NonNull CacheInfo cacheInfo)
      Given a Supplier instance meant to generate values that are cacheable, check the cache using a key based on a collection of key fragments. If a cache value is available for the complex key generated based on the args, then that cache value is used. If a cached values is not found it will utilize the computeFunction to generate the uncached value, and that generated value will be cached. The cached or generated value is returned. Also, additional processing can be universally applied via one or more implementations of CacheResultPostProcessor, which are executed before the result is returned from here.
      Type Parameters:
      P - The return type
      Parameters:
      computeFunction - The Function instance responsible for generating uncached values
      cacheInfo - Required information to generate keys and interact with the CacheManager.
      Returns:
      The sum of cache hits and generated values

    • get

      @Nullable public <P> P get(CacheInfo cacheInfo)
      Given the supplied cacheInfo object, return an object if it is in the cache.
      Parameters:
      cacheInfo - Required information to generate keys and interact with the CacheManager.
      Returns:
      The object if it is in the cache, otherwise null.

    • evict

      public Map<String,org.springframework.cache.Cache.ValueWrapper> evict(String cacheName, EntityInfo entityInfo)
      Evict a discrete cache member
      Parameters:
      cacheName - The name of the cache region
      entityInfo - The identifying information for the specific entity-related cache to evict
      Returns:
      Map of all cache members evicted from the cache, arranged by the cache key string value.

    • invalidate

      public void invalidate(String cacheName)
      Invalidate an entire cache region, effectively evicting every member contained in that cache
      Parameters:
      cacheName - The cache region to invalidate