テスト

キャッシュされた結果は呼び出しの間で持ち越されるため、テストで動作を隠すことがあります。プロパティでキャッシュを無効にするか、有効のままにして CacheManager の Bean を通してキャッシュを確認します。有効期限をテストするには、待つ代わりに時計を進めます。

使う理由

前のテストがキャッシュを埋めたおかげで通るテストや、結果が古いせいで失敗するテストは、不安定なテストです。キャッシュを無効にすればメソッドをテストでき、有効のままにすればキャッシュのルールをテストできます。有効期限のテストでスリープしてはいけません。有効期間は単調なストップウォッチで動くため、自分で制御できる時計をキャッシュに与えます。

例

import 'package:spring_boot_starter_test/spring_boot_starter_test.dart';
import 'package:test/test.dart';

import 'spring_gen/main.test.spring.dart';

void main() {
  // キャッシュなしの、メソッドそのもの。
  final plain = springBootTest(springApplication, properties: {'spring.cache.type': 'none'});

  // キャッシュのルール: 2 回目の呼び出しはキャッシュを読む。
  final cached = springBootTest(springApplication);

  test('find is cached by isbn', () async {
    final books = cached.getBean<Books>();
    await books.find('978-0');
    expect(cached.getBean<CacheManager>().getCache('books')!.get('978-0'), isNotNull);
  });
}

有効期限

InMemoryCache や InMemoryCacheManager に与えた clock は、有効期限を前に進めます。エントリーは、その有効期間がストップウォッチまたは時計の上で経過すると期限切れになります。

var now = DateTime.utc(2026);
final cache = InMemoryCache(
  'books',
  spec: const CacheSpec(timeToLive: Duration(minutes: 10)),
  clock: () => now,
);
cache.put('978-0', book);
now = now.add(const Duration(minutes: 9));
expect(cache.get('978-0')?.value, book);
now = now.add(const Duration(minutes: 1)); // 有効期間全体
expect(cache.get('978-0'), isNull);
fakeAsync((async) {
  final cache = InMemoryCache(
    'books',
    spec: const CacheSpec(timeToLive: Duration(minutes: 10)),
    clock: () => clock.now(),
  );
  cache.put('978-0', book);
  async.elapse(const Duration(minutes: 10));
  expect(cache.get('978-0'), isNull);
});

Spring (Java) との対応

@SpringBootTest(properties = "spring.cache.type=none")
class BooksTest { ... }

プロパティは同じです。Spring の ConcurrentMapCacheManager にはテストすべき有効期限がありません。Caffeine では、Ticker が時計の役割を果たします。

関連項目