
# テスト

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

## 使う理由

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

## 例

```dart
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` は、有効期限を前に進めます。エントリーは、その有効期間がストップウォッチ**または**時計の上で経過すると期限切れになります。

- **待たずに、時計を進めてください:**

```dart
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` は、それが取られたゾーンの時計を保ちます。

```dart
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) との対応

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

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

## 関連項目

- [メモリ上のキャッシュ](in-memory-caches.md)
- [Web スターターでのテスト](../spring-boot-starter-web/testing.md)
