再起動後も残るキャッシュ

spring.cache.type: disk はエントリを 1 件ずつディスクに保持します。そのため結果はアプリを再起動しても残ります。昨日スマートフォンが受け取った API の応答も、次の起動ではネットワークなしで手元にあります。

なぜ

メモリ上のキャッシュは起動のたびに空になります。スマートフォンではユーザーがアプリを開くたび、Web ではページを読み込むたびです。同じ応答をまた問い合わせることになります。ディスク上のストアならそれを保持できます。ただしメモリより応答が遅いので、このキャッシュは Future を返すメソッド向けです。

例

spring:
  cache:
    type: disk                # simple: メモリ、disk: 再起動をまたいで保持
    disk:
      time-to-live: 1h        # 実時間で数える(再起動をまたぐ)
      max-size: 50MB          # キャッシュごと。古く書かれたものから消える
      version: 2.1.0          # 別のバージョンのエントリは読まない
      caches:
        profiles: { time-to-live: 10m }
@Component()
class Profiles {
  Profiles(this.api);
  final PassportApi api;

  @Cacheable('profiles')
  Future<Profile> find(String steamId) => api.profile(steamId);
}

仕組み

@Configuration()
class CacheConfig {
  @Bean()
  @Primary()
  CacheManager memory() => InMemoryCacheManager(
        defaultSpec: const CacheSpec(timeToLive: Duration(minutes: 1)),
      );

  @Bean()
  CacheManager disk(CacheStore store, ObjectMapper mapper,
          Introspector introspector) =>
      DiskCacheManager(store: store, mapper: mapper,
          introspector: introspector, timeToLive: const Duration(days: 1));

  @Bean()
  CacheManager layered(CacheManager memory, CacheManager disk) =>
      LayeredCacheManager([memory, disk]);
}

プロパティ

キー 既定値 意味
spring.cache.type simple disk でエントリをディスクに保持
spring.cache.disk.time-to-live なし エントリの寿命(実時間)
spring.cache.disk.caches.<name>.time-to-live 全体の値 1 つのキャッシュの寿命
spring.cache.disk.max-size なし キャッシュごとの最大バイト数
spring.cache.disk.directory .spring/cache CacheStore の Bean がない場合のフォルダー
spring.cache.disk.version なし エントリを書き、読むときのバージョン
spring.cache.resource-version false リソースを内容のバージョンで鍵にする