クラス CaffeineCacheManager
- 実装されているすべてのインターフェース:
CacheManager
getCache(java.lang.String) リクエストごとに CaffeineCache インスタンスを遅延ビルドする CacheManager 実装。また、キャッシュ名のセットが setCacheNames(java.util.Collection<java.lang.String>) を介して事前に定義されている「静的」モードもサポートしています。実行時に追加のキャッシュ領域を動的に作成することはありません。 基礎となるキャッシュの構成は、Caffeine ビルダーまたは CaffeineSpec を介して微調整でき、setCaffeine(com.github.benmanes.caffeine.cache.Caffeine<java.lang.Object, java.lang.Object>)/setCaffeineSpec(com.github.benmanes.caffeine.cache.CaffeineSpec) を介してこの CacheManager に渡されます。CaffeineSpec -compliant 式の値は、"cacheSpecification" Bean プロパティを介して適用することもできます。
Caffeine 2.1 以上が必要です。
- 導入:
- 4.3
- 作成者:
- Ben Manes, Juergen Hoeller, Stephane Nicoll, Sam Brannen, Brian Clozel
- 関連事項:
コンストラクターの概要
コンストラクターコンストラクター説明動的な CaffeineCacheManager を構築し、リクエストされているキャッシュインスタンスを遅延作成します。CaffeineCacheManager(StringSE... cacheNames) 静的 CaffeineCacheManager を構築し、指定されたキャッシュ名のみのキャッシュを管理します。メソッドのサマリー
修飾子と型メソッド説明protected CacheadaptCaffeineCache(StringSE name, com.github.benmanes.caffeine.cache.Cache<ObjectSE, ObjectSE> cache) 指定された新しいネイティブ Caffeine キャッシュインスタンスを、指定されたキャッシュ名の Spring のCache抽象化に適合させます。protected CachecreateCaffeineCache(StringSE name) このキャッシュマネージャーで指定された共通の Caffeine 構成を使用して、指定されたキャッシュ名の共通のCaffeineCacheインスタンスを構築します。このキャッシュマネージャーで指定された共通の Caffeine 構成を使用して、指定されたキャッシュ名の共通の Caffeine キャッシュインスタンスを構築します。指定された名前に関連付けられたキャッシュを取得します。このマネージャーが知っているキャッシュ名のコレクションを取得します。booleanこのキャッシュマネージャーが、すべてのキャッシュのnull値を受け入れて変換するかどうかを返します。voidregisterCustomCache(StringSE name, com.github.benmanes.caffeine.cache.Cache<ObjectSE, ObjectSE> cache) 指定されたネイティブ Caffeine キャッシュインスタンスをこのキャッシュマネージャーに登録し、Spring のキャッシュ API に適応させて、getCache(java.lang.String)を介して公開します。voidsetAllowNullValues(boolean allowNullValues) このキャッシュマネージャーのすべてのキャッシュのnull値を受け入れて変換するかどうかを指定します。voidsetCacheLoader(com.github.benmanes.caffeine.cache.CacheLoader<ObjectSE, ObjectSE> cacheLoader) Caffeine CacheLoader を設定して、個々のCaffeineCacheインスタンスを作成し、LoadingCache に変換します。voidsetCacheNames(CollectionSE<StringSE> cacheNames) この CacheManager の「静的」モードのキャッシュ名のセットを指定します。voidsetCacheSpecification(StringSE cacheSpecification) 個々のCaffeineCacheインスタンスを構築するために使用する Caffeine キャッシュ仕様文字列を設定します。voidsetCaffeine(com.github.benmanes.caffeine.cache.Caffeine<ObjectSE, ObjectSE> caffeine) Caffeine を設定して、個々のCaffeineCacheインスタンスを作成します。voidsetCaffeineSpec(com.github.benmanes.caffeine.cache.CaffeineSpec caffeineSpec) 個々のCaffeineCacheインスタンスの構築に使用するCaffeineSpecを設定します。
コンストラクターの詳細
CaffeineCacheManager
public CaffeineCacheManager()動的な CaffeineCacheManager を構築し、リクエストされているキャッシュインスタンスを遅延作成します。CaffeineCacheManager
静的 CaffeineCacheManager を構築し、指定されたキャッシュ名のみのキャッシュを管理します。
メソッドの詳細
setCacheNames
この CacheManager の「静的」モードのキャッシュ名のセットを指定します。キャッシュの数とその名前は、このメソッドの呼び出し後に修正され、実行時にさらにキャッシュ領域が作成されることはありません。
nullコレクション引数でこれを呼び出すと、モードが「動的」にリセットされ、キャッシュをさらに作成できるようになります。setCaffeine
Caffeine を設定して、個々のCaffeineCacheインスタンスを作成します。- 関連事項:
createNativeCaffeineCache(java.lang.String)Caffeine.build()
setCaffeineSpec
public void setCaffeineSpec(com.github.benmanes.caffeine.cache.CaffeineSpec caffeineSpec) 個々のCaffeineCacheインスタンスの構築に使用するCaffeineSpecを設定します。- 関連事項:
createNativeCaffeineCache(java.lang.String)Caffeine.from(CaffeineSpec)
setCacheSpecification
個々のCaffeineCacheインスタンスを構築するために使用する Caffeine キャッシュ仕様文字列を設定します。指定された値は、Caffeine のCaffeineSpecに準拠する必要があります(javadoc を参照)。- 関連事項:
createNativeCaffeineCache(java.lang.String)Caffeine.from(String)
setCacheLoader
public void setCacheLoader(com.github.benmanes.caffeine.cache.CacheLoader<ObjectSE, ObjectSE> cacheLoader) Caffeine CacheLoader を設定して、個々のCaffeineCacheインスタンスを作成し、LoadingCache に変換します。- 関連事項:
createNativeCaffeineCache(java.lang.String)Caffeine.build(CacheLoader)LoadingCache
setAllowNullValues
public void setAllowNullValues(boolean allowNullValues) このキャッシュマネージャーのすべてのキャッシュのnull値を受け入れて変換するかどうかを指定します。Caffeine 自体が
null値をサポートしていないにもかかわらず、デフォルトは "true" です。内部ホルダーオブジェクトは、ユーザーレベルのnullを格納するために使用されます。isAllowNullValues
public boolean isAllowNullValues()このキャッシュマネージャーが、すべてのキャッシュのnull値を受け入れて変換するかどうかを返します。getCacheNames
インターフェースからコピーされた説明:CacheManagerこのマネージャーが知っているキャッシュ名のコレクションを取得します。- 次で指定:
- インターフェース
CacheManagerのgetCacheNames - 戻り値:
- キャッシュマネージャーが知っているすべてのキャッシュの名前
getCache
インターフェースからコピーされた説明:CacheManager指定された名前に関連付けられたキャッシュを取得します。ネイティブプロバイダーがサポートしている場合、キャッシュは実行時に遅延して作成される場合があることに注意してください。
- 次で指定:
- インターフェース
CacheManagerのgetCache - パラメーター:
name- キャッシュ識別子 (nullであってはなりません)- 戻り値:
- 関連するキャッシュ、またはそのようなキャッシュが存在しないか作成できない場合は
null
registerCustomCache
public void registerCustomCache(StringSE name, com.github.benmanes.caffeine.cache.Cache<ObjectSE, ObjectSE> cache) 指定されたネイティブ Caffeine キャッシュインスタンスをこのキャッシュマネージャーに登録し、Spring のキャッシュ API に適応させて、getCache(java.lang.String)を介して公開します。このようなカスタムキャッシュはいくつでも並べて登録できます。これにより、キャッシュごとのカスタム設定が可能になり(キャッシュマネージャーの構成で共通設定を共有するすべてのキャッシュとは対照的)、通常は Caffeine ビルダー API である
registerCustomCache("myCache", Caffeine.newBuilder().maximumSize(10).build())で使用されます。他のキャッシュは、
setCacheNames(java.util.Collection<java.lang.String>)で静的に指定されているか、オンデマンドで動的に作成されているかに関係なく、キャッシュマネージャーの構成の共通設定で動作します。- パラメーター:
name- キャッシュの名前cache- 登録するカスタム Caffeine キャッシュインスタンス- 導入:
- 5.2.8
- 関連事項:
adaptCaffeineCache
protected Cache adaptCaffeineCache(StringSE name, com.github.benmanes.caffeine.cache.Cache<ObjectSE, ObjectSE> cache) 指定された新しいネイティブ Caffeine キャッシュインスタンスを、指定されたキャッシュ名の Spring のCache抽象化に適合させます。- パラメーター:
name- キャッシュの名前cache- ネイティブ Caffeine キャッシュインスタンス- 戻り値:
- Spring CaffeineCache アダプター (またはそのデコレータ)
- 導入:
- 5.2.8
- 関連事項:
createCaffeineCache
このキャッシュマネージャーで指定された共通の Caffeine 構成を使用して、指定されたキャッシュ名の共通のCaffeineCacheインスタンスを構築します。Spring のキャッシュ抽象化への適応方法として
adaptCaffeineCache(java.lang.String, com.github.benmanes.caffeine.cache.Cache<java.lang.Object, java.lang.Object>)にデリゲートし(一元化された装飾などを許可)、新しく構築されたネイティブ Caffeine キャッシュインスタンスを渡します。- パラメーター:
name- キャッシュの名前- 戻り値:
- Spring CaffeineCache アダプター (またはそのデコレータ)
- 関連事項:
createNativeCaffeineCache
protected com.github.benmanes.caffeine.cache.Cache<ObjectSE,ObjectSE> createNativeCaffeineCache(StringSE name) このキャッシュマネージャーで指定された共通の Caffeine 構成を使用して、指定されたキャッシュ名の共通の Caffeine キャッシュインスタンスを構築します。- パラメーター:
name- キャッシュの名前- 戻り値:
- ネイティブ Caffeine キャッシュインスタンス
- 関連事項: