Spring との違い
spring_boot_starter_cache は Spring のキャッシュ抽象化と Spring Boot の自動構成に従っています。アノテーション、SpEL の変数、インターフェース、プロパティは同じです。このページでは、そうでない箇所とその理由を列挙します。
使う理由
違いは、Dart (リフレクションがない、オーバーロードがない、同一性で比較されるコレクション、Future と Stream) と、有効期限とサイズの上限を持つ組み込みのストアから来ています。そのため、ほとんどのアプリケーションは追加のライブラリを必要としません。
例
@Cacheable.of(cacheNames: ['books', 'isbn'], key: '#isbn')
Future<Book> find(String isbn) => api.load(isbn);
@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 はこのスターター独自のもので、エントリーをディスクに保持し、再起動後も残す (再起動後も残るキャッシュ) |
まだ 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の結果のキャッシュ。