インターフェース CachingConfigurer

すべての既知のサブインターフェース:
JCacheConfigurer
すべての既知の実装クラス:
CachingConfigurerSupport, JCacheConfigurerSupport

public interface CachingConfigurer
アノテーション駆動型キャッシュ管理のためにキャッシュが解決される方法とキーが生成される方法を明示的に指定するために実装されるインターフェース。

通常、@EnableCaching アノテーションが付与された @Configuration クラスによって実装されます。一般的な例とコンテキストについては @EnableCaching を参照してください。詳細な手順については、cacheManager()cacheResolver()keyGenerator()errorHandler() を参照してください。

注意: CachingConfigurer は早期に初期化されます。共通の依存関係をオートワイヤーフィールドに直接挿入しないでください。代わりに、それらに対して遅延 ObjectProvider を宣言することを検討してください。

導入:
3.1
作成者:
Chris Beams, Stephane Nicoll
関連事項:
  • メソッドの詳細

    • cacheManager

      default @Nullable CacheManager cacheManager()
      アノテーション駆動型のキャッシュ管理に使用するキャッシュマネージャー Bean を返します。デフォルトの CacheResolver は、このキャッシュマネージャーでバックグラウンドで初期化されます。キャッシュ解決をより細かく管理するには、CacheResolver を直接設定することを検討してください。

      実装では、キャッシュマネージャーがコンテキストのライフサイクルに参加できるように、@Bean を明示的に宣言する必要があります。たとえば

      @Configuration
      @EnableCaching
      class AppConfig implements CachingConfigurer {
          @Bean // important!
          @Override
          CacheManager cacheManager() {
              // configure and return CacheManager instance
          }
          // ...
      }
      
      より完全な例については、@EnableCaching を参照してください。
    • cacheResolver

      default @Nullable CacheResolver cacheResolver()
      CacheResolver Bean を返し、アノテーション駆動型キャッシュ管理の通常のキャッシュを解決するために使用します。これは、使用する CacheManager を指定する代替のより強力なオプションです。

      cacheManager() と cacheResolver() の両方が設定されている場合、キャッシュマネージャーは無視されます。

      実装では、キャッシュリゾルバーがコンテキストのライフサイクルに参加できるように、@Bean を明示的に宣言する必要があります。たとえば

      @Configuration
      @EnableCaching
      class AppConfig implements CachingConfigurer {
          @Bean // important!
          @Override
          CacheResolver cacheResolver() {
              // configure and return CacheResolver instance
          }
          // ...
      }
      
      より完全な例については、EnableCaching を参照してください。
    • keyGenerator

      default @Nullable KeyGenerator keyGenerator()
      アノテーション駆動型キャッシュ管理に使用するキージェネレーター Bean を返します。

      デフォルトでは、SimpleKeyGenerator が使用されます。より完全な例については、@EnableCaching を参照してください。

    • errorHandler

      default @Nullable CacheErrorHandler errorHandler()
      キャッシュ関連エラーの処理に使用する CacheErrorHandler を返します。

      デフォルトでは、例外をクライアントに返す SimpleCacheErrorHandler が使用されています。より完全な例については、@EnableCaching を参照してください。