
# Spring との違い

`spring_boot_starter_cache` は Spring のキャッシュ抽象化と Spring Boot の自動構成に従っています。アノテーション、SpEL の変数、インターフェース、プロパティは同じです。このページでは、そうでない箇所とその理由を列挙します。

## 使う理由

違いは、Dart (リフレクションがない、オーバーロードがない、同一性で比較されるコレクション、`Future` と `Stream`) と、有効期限とサイズの上限を持つ組み込みのストアから来ています。そのため、ほとんどのアプリケーションは追加のライブラリを必要としません。

## 例

```dart
@Cacheable.of(cacheNames: ['books', 'isbn'], key: '#isbn')
Future<Book> find(String isbn) => api.load(isbn);
```

```java
@Cacheable(cacheNames = {"books", "isbn"}, key = "#isbn")
public Book find(String isbn) { ... }
```

## 違い

| Spring | ここでは | 理由 |
|---|---|---|
| `@EnableCaching` | 不要。`spring.cache.type=none` はキャッシュを無効にする | スターターだけで足りる。 |
| `@Cacheable({"a", "b"})` | `@Cacheable('a')`、または `@Cacheable.of(cacheNames: [...])` | Dart のコンストラクターは任意の位置引数と名前付き引数を混ぜられない。 |
| `#root.caches` は `Cache` オブジェクト、`#root.targetClass` は `Class`、`#root.method` は `Method` | キャッシュ名、クラス名、(テキストとしての) `MethodSignature` | リフレクションがない。 |
| `CacheManagerCustomizer<T>` | ジェネリックではない。カスタマイザーがマネージャーの型をチェックする | コンテナは Bean をその正確な型で見つける。 |
| `CompletableFuture` は値としてキャッシュされる (6.1) | `Future` は値としてキャッシュされる | |
| `sync` はメソッドごとに待つ | キャッシュとキーごと: 同じキャッシュとキーを持つ 2 つの `sync` メソッドは一つの保留中の結果を共有する | |
| `sync` の待機はキャッシュが行う (`Cache.get(key, Callable)`) | インターセプターが実行中の呼び出しをキャッシュ名とキーで保持する。渡されたキーとは別のキー (呼び出し元やテナントを加えたもの) で保存するキャッシュは `KeyScopingCache` を実装し、その `storedKey(key)` が呼び出しを共有する単位になる | `Cache` には値ローダーがない。`KeyScopingCache` がないと、キャッシュが分けている呼び出し元どうしが一つの応答を共有してしまう。このインターフェースはこのスターター独自のもの。 |
| 有効期限もサイズもない `ConcurrentMapCacheManager`。それらには Caffeine | メモリ上のキャッシュは有効期間とサイズの上限を持つ (`spring.cache.simple.*`) | 長時間動くサーバーが際限なく大きくならないように。 |
| 多くのストアを持つ `spring.cache.type` | `generic`、`simple`、`disk`、`none`。`disk` はこのスターター独自のもので、エントリーをディスクに保持し、再起動後も残す ([再起動後も残るキャッシュ](disk-caches.md)) | まだ Caffeine、Redis、JCache はない。 |
| `SimpleKeyGenerator` は配列だけを包む | 単一のリスト、セット、マップも `SimpleKey` に包む | Dart のコレクションは同一性で比較される。キーは内容で比較する。 |
| `Flux` は集められて再生される (6.1) | `Stream` のメソッドの `@Cacheable` / `@CachePut` はビルドを失敗させる | 汎用のインターセプターは、リフレクションなしに正しい型の `Stream<T>` を作れない。 |
| `get(key, Class)`、`get(key, Callable)`、`retrieve`、`getNativeCache` を持つ `Cache` | `name`、`get`、`put`、`putIfAbsent`、`evict`、`evictIfPresent`、`clear`、`invalidate`。`retrieve` は、ストアの応答が後から来るキャッシュ (ディスク上のキャッシュ) の `AsyncCache` にある | |
| `invalidate()` はエントリーが取り除かれたかどうかを示す | `CacheDefaults` は常に `true` を返す。`InMemoryCache` はまだ掃き出されていない期限切れのエントリーも数える | |
| `CachingConfigurer` のメソッドは `@Bean` でもよい | そうであってはならない: 一度だけ呼ばれる | Dart には `@Configuration` のプロキシがない。 |
| `CacheErrorHandler` は例外を受け取る | スタックトレースも受け取る | |
| `sync` のルールは最初の呼び出しでチェックされる | すべてのアノテーションのルールは Bean の生成時にチェックされる | 起動時に失敗させる。 |

## まだ対応していないもの

- Caffeine、Redis、JCache、Hazelcast のキャッシュタイプ。
- 値のローダー (`get(key, Callable)`)。
- `Stream` の結果のキャッシュ。

## 関連項目

- [概要](index.md)
- [すべてのプロパティ](properties.md)
- [アノテーション](annotations.md)
