テスト
キャッシュされた結果は呼び出しの間で持ち越されるため、テストで動作を隠すことがあります。プロパティでキャッシュを無効にするか、有効のままにして 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);
fake_asyncだけでは何も期限切れになりません。async.elapseは偽の時間を進めますが、ストップウォッチは進めません。偽の時間に従う時計() => clock.now()(fakeAsyncが偽装するclockパッケージ) をキャッシュに与え、同じfakeAsyncの中で書き込みと読み取りを行ってください。クロージャーを書いてください。ティアオフのclock.nowは、それが取られたゾーンの時計を保ちます。
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);
});
- 長い有効期間を選んでください。 時計にかかわらず実時間もエントリーを期限切れにするため、1 秒の有効期間は、遅いマシンではテストがまだ期待しているエントリーを期限切れにしてしまうことがあります。数分を指定し、時計をそれより先に進めてください。書き込みより前に戻した時計も、期限切れとみなされます。
- アプリケーションのテストでは、スターターがプロパティから作る
cacheManagerには時計がありません。仕様とclockを持つ独自のInMemoryCacheManagerの Bean を宣言し (スターターのものを置き換えます)、その時計を進めてください。
Spring (Java) との対応
@SpringBootTest(properties = "spring.cache.type=none")
class BooksTest { ... }
プロパティは同じです。Spring の ConcurrentMapCacheManager にはテストすべき有効期限がありません。Caffeine では、Ticker が時計の役割を果たします。