きり丸アドベントカレンダー2020の21記事目です。

弊社の試験環境のシステムには、月跨ぎや年跨ぎのテストを行いやすいように業務日付という概念があります。処理日等の項目を業務日付に合わせて連携しないと、対向システムのバリデーション等にひっかかってしまいます。他にも面倒な点として、月跨ぎや年跨ぎのテストをやりやすいようにするための概念ですので、業務日付は毎日変わります。

ですので、現在のシステムでは業務日付を導き出せるように「現在日付 + X日 = 業務日付」の「X日」をDBに保存しています。

ただし、1回のリクエストで複数回の業務日付をDBから取得する必要があるので、何もしなければ無駄にパフォーマンスが悪くなってしまいます。業務日付は試験のためのロジックで、本番環境は現在日付と同じです。試験のための項目で、本番環境の性能悪化させてしまうのは悪手です。

そういう時に、データをキャッシュすることで高速化が見込めます。

今回の記事ではSpringでキャッシュする仕組みをSpring Cacheで実装します。

ゴール

Spring Cacheで目的の値をキャッシュにする
キャッシュをクリアする

できないこと

キャッシュを更新する

環境

Java
- 15
org.springframework.boot:spring-boot-starter-cache
- 2.4.0
（Lombok）

手順

Spring Cacheを依存関係に含める

Spring Cacheを依存関係に含めます。

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-cache'
}

Spring Cacheを有効にする

@SpringBootApplicationを付与しているファイルに対して、@EnableCachingを付与します。

@SpringBootApplication
@EnableCaching
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

}

業務日付をキャッシュにする

@Cachenableでキャッシュを登録します。今回はパラメータが無いですが、パラメータがある場合はパラメータがキャッシュのキーになります。初回実行時はキャッシュが無いので、業務日付を導くための「X日」をDBから取得します。2回目以降はキャッシュがあるので、DBからではなくキャッシュから読み込みます。

@CacheEvictでキャッシュを削除します。業務日付が更新されたタイミングでキャッシュを削除することで、古いキャッシュを読み込ませることはありません。

@Repository
@RequiredArgsConstructor
public class BusinessDateComponentImpl implements BusinessDateComponent {
  private final BusinessDateRepository businessDateRepository;

  @Cacheable("businessDate")
  @Override
  public int getBusinessDate() {
    return businessDateRepository.getBusinessDate();
  }

  @CacheEvict("businessDate")
  @Override
  public void deleteCache() {
  }
}

その他にもキャッシュを更新するためのCachePutがあります。

ただし、今回の「業務日付をキャッシュ化する」という目的では、パラメータが無いせいかうまく更新できませんでした。他の記事で参考にしていただけると助かります。

アノテーション	説明
Cacheable	キャッシュを登録する
CacheEvict	キャッシュをクリアする
CachePut	キャッシュを更新する

動作確認用

今回の記事とは直接関係がありませんが、キャッシュが効いていることの確認するためのロジックをGitHubのソースに含めています。今回の記事で検証した結果を次に記します。

// 業務日付の確認
curl -X GET http://localhost:8080/v1/businessDate/ -u admin:pass
// 業務日付のキャッシュ削除
curl -X GET http://localhost:8080/v1/businessDate/clear -u admin:pass

結果：

curl -X GET http://localhost:8080/v1/businessDate/ -u admin:pass
3000 # DBの値
# DBを更新して300にする
curl -X GET http://localhost:8080/v1/businessDate/ -u admin:pass
3000 # キャッシュの値
# 業務日付のキャッシュ削除
curl -X GET http://localhost:8080/v1/businessDate/clear -u admin:pass

curl -X GET http://localhost:8080/v1/businessDate/ -u admin:pass
300