类 CaffeineCacheManager
- java.lang.Object
- org.springframework.cache.caffeine.CaffeineCacheManager
- 所有已实现的接口:
CacheManager
public class CaffeineCacheManager extends Object implements CacheManager
CacheManager
implementation that lazily buildsCaffeineCache
instances for eachgetCache(java.lang.String)
request. Also supports a 'static' mode where the set of cache names is pre-defined throughsetCacheNames(java.util.Collection<java.lang.String>)
, with no dynamic creation of further cache regions at runtime.The configuration of the underlying cache can be fine-tuned through a
Caffeine
builder orCaffeineSpec
, passed into this CacheManager throughsetCaffeine(com.github.benmanes.caffeine.cache.Caffeine<java.lang.Object, java.lang.Object>)
/setCaffeineSpec(com.github.benmanes.caffeine.cache.CaffeineSpec)
. ACaffeineSpec
-compliant expression value can also be applied via the"cacheSpecification"
bean property.Requires Caffeine 2.1 or higher.
- 从以下版本开始:
- 4.3
- 作者:
- Ben Manes, Juergen Hoeller, Stephane Nicoll, Sam Brannen
- 另请参阅:
CaffeineCache
构造器概要
构造器 构造器 说明 CaffeineCacheManager()
Construct a dynamic CaffeineCacheManager, lazily creating cache instances as they are being requested.CaffeineCacheManager(String... cacheNames)
Construct a static CaffeineCacheManager, managing caches for the specified cache names only.
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 protected Cache
adaptCaffeineCache(String name, com.github.benmanes.caffeine.cache.Cache<Object,Object> cache)
Adapt the given new native Caffeine Cache instance to Spring'sCache
abstraction for the specified cache name.protected Cache
createCaffeineCache(String name)
Build a commonCaffeineCache
instance for the specified cache name, using the common Caffeine configuration specified on this cache manager.protected com.github.benmanes.caffeine.cache.Cache<Object,Object>
createNativeCaffeineCache(String name)
Build a common Caffeine Cache instance for the specified cache name, using the common Caffeine configuration specified on this cache manager.Cache
getCache(String name)
Get the cache associated with the given name.Collection<String>
getCacheNames()
Get a collection of the cache names known by this manager.boolean
isAllowNullValues()
Return whether this cache manager accepts and convertsnull
values for all of its caches.void
registerCustomCache(String name, com.github.benmanes.caffeine.cache.Cache<Object,Object> cache)
Register the given native Caffeine Cache instance with this cache manager, adapting it to Spring's cache API for exposure throughgetCache(java.lang.String)
.void
setAllowNullValues(boolean allowNullValues)
Specify whether to accept and convertnull
values for all caches in this cache manager.void
setCacheLoader(com.github.benmanes.caffeine.cache.CacheLoader<Object,Object> cacheLoader)
Set the Caffeine CacheLoader to use for building each individualCaffeineCache
instance, turning it into a LoadingCache.void
setCacheNames(Collection<String> cacheNames)
Specify the set of cache names for this CacheManager's 'static' mode.void
setCacheSpecification(String cacheSpecification)
Set the Caffeine cache specification String to use for building each individualCaffeineCache
instance.void
setCaffeine(com.github.benmanes.caffeine.cache.Caffeine<Object,Object> caffeine)
Set the Caffeine to use for building each individualCaffeineCache
instance.void
setCaffeineSpec(com.github.benmanes.caffeine.cache.CaffeineSpec caffeineSpec)
Set theCaffeineSpec
to use for building each individualCaffeineCache
instance.
构造器详细资料
CaffeineCacheManager
public CaffeineCacheManager()
Construct a dynamic CaffeineCacheManager, lazily creating cache instances as they are being requested.
CaffeineCacheManager
public CaffeineCacheManager(String... cacheNames)
Construct a static CaffeineCacheManager, managing caches for the specified cache names only.
方法详细资料
setCacheNames
public void setCacheNames(@Nullable Collection<String> cacheNames)
Specify the set of cache names for this CacheManager's 'static' mode.The number of caches and their names will be fixed after a call to this method, with no creation of further cache regions at runtime.
Calling this with a
null
collection argument resets the mode to 'dynamic', allowing for further creation of caches again.
setCaffeine
public void setCaffeine(com.github.benmanes.caffeine.cache.Caffeine<Object,Object> caffeine)
Set the Caffeine to use for building each individualCaffeineCache
instance.- 另请参阅:
createNativeCaffeineCache(java.lang.String)
,Caffeine.build()
setCaffeineSpec
public void setCaffeineSpec(com.github.benmanes.caffeine.cache.CaffeineSpec caffeineSpec)
Set theCaffeineSpec
to use for building each individualCaffeineCache
instance.- 另请参阅:
createNativeCaffeineCache(java.lang.String)
,Caffeine.from(CaffeineSpec)
setCacheSpecification
public void setCacheSpecification(String cacheSpecification)
Set the Caffeine cache specification String to use for building each individualCaffeineCache
instance. The given value needs to comply with Caffeine'sCaffeineSpec
(see its javadoc).- 另请参阅:
createNativeCaffeineCache(java.lang.String)
,Caffeine.from(String)
setCacheLoader
public void setCacheLoader(com.github.benmanes.caffeine.cache.CacheLoader<Object,Object> cacheLoader)
Set the Caffeine CacheLoader to use for building each individualCaffeineCache
instance, turning it into a LoadingCache.- 另请参阅:
createNativeCaffeineCache(java.lang.String)
,Caffeine.build(CacheLoader)
,LoadingCache
setAllowNullValues
public void setAllowNullValues(boolean allowNullValues)
Specify whether to accept and convertnull
values for all caches in this cache manager.Default is "true", despite Caffeine itself not supporting
null
values. An internal holder object will be used to store user-levelnull
s.
isAllowNullValues
public boolean isAllowNullValues()
Return whether this cache manager accepts and convertsnull
values for all of its caches.
getCacheNames
public Collection<String> getCacheNames()
从接口复制的说明:CacheManager
Get a collection of the cache names known by this manager.- 指定者:
getCacheNames
在接口中CacheManager
- 返回:
- the names of all caches known by the cache manager
getCache
@Nullable public Cache getCache(String name)
从接口复制的说明:CacheManager
Get the cache associated with the given name.Note that the cache may be lazily created at runtime if the native provider supports it.
- 指定者:
getCache
在接口中CacheManager
- 参数:
name
- the cache identifier (must not benull
)- 返回:
- the associated cache, or
null
if such a cache does not exist or could be not created
registerCustomCache
public void registerCustomCache(String name, com.github.benmanes.caffeine.cache.Cache<Object,Object> cache)
Register the given native Caffeine Cache instance with this cache manager, adapting it to Spring's cache API for exposure throughgetCache(java.lang.String)
. Any number of such custom caches may be registered side by side.This allows for custom settings per cache (as opposed to all caches sharing the common settings in the cache manager's configuration) and is typically used with the Caffeine builder API:
registerCustomCache("myCache", Caffeine.newBuilder().maximumSize(10).build())
Note that any other caches, whether statically specified through
setCacheNames(java.util.Collection<java.lang.String>)
or dynamically built on demand, still operate with the common settings in the cache manager's configuration.- 参数:
name
- the name of the cachecache
- the custom Caffeine Cache instance to register- 从以下版本开始:
- 5.2.8
- 另请参阅:
adaptCaffeineCache(java.lang.String, com.github.benmanes.caffeine.cache.Cache<java.lang.Object, java.lang.Object>)
adaptCaffeineCache
protected Cache adaptCaffeineCache(String name, com.github.benmanes.caffeine.cache.Cache<Object,Object> cache)
Adapt the given new native Caffeine Cache instance to Spring'sCache
abstraction for the specified cache name.- 参数:
name
- the name of the cachecache
- the native Caffeine Cache instance- 返回:
- the Spring CaffeineCache adapter (or a decorator thereof)
- 从以下版本开始:
- 5.2.8
- 另请参阅:
CaffeineCache
,isAllowNullValues()
createCaffeineCache
protected Cache createCaffeineCache(String name)
Build a commonCaffeineCache
instance for the specified cache name, using the common Caffeine configuration specified on this cache manager.Delegates to
adaptCaffeineCache(java.lang.String, com.github.benmanes.caffeine.cache.Cache<java.lang.Object, java.lang.Object>)
as the adaptation method to Spring's cache abstraction (allowing for centralized decoration etc), passing in a freshly built native Caffeine Cache instance.- 参数:
name
- the name of the cache- 返回:
- the Spring CaffeineCache adapter (or a decorator thereof)
- 另请参阅:
adaptCaffeineCache(java.lang.String, com.github.benmanes.caffeine.cache.Cache<java.lang.Object, java.lang.Object>)
,createNativeCaffeineCache(java.lang.String)
createNativeCaffeineCache
protected com.github.benmanes.caffeine.cache.Cache<Object,Object> createNativeCaffeineCache(String name)
Build a common Caffeine Cache instance for the specified cache name, using the common Caffeine configuration specified on this cache manager.- 参数:
name
- the name of the cache- 返回:
- the native Caffeine Cache instance
- 另请参阅:
createCaffeineCache(java.lang.String)