キャッシュ

このスターターでは、すべてのキャッシュキーが、キャッシュされた呼び出しが誰として行われたかを含みます。anon、user:<id>、service のいずれかです。そのために @Cacheable に何かを書く必要はありません。

使う理由

行レベルセキュリティがあると、一つの呼び出しがユーザーごとに違う答えを返します。findByListId('l1') は、各ユーザーに自分の行だけを返します。引数だけで作ったキャッシュキーでは、あるユーザーの行が次の呼び出し元に渡ったり、サービスロールとして読んだ答えがユーザーに渡ったりします。Flutter アプリでは、新しくログインしたユーザーが前のユーザーのエントリーを読むことになります。

例

@Service()
class Reports {
  Reports(this.functions);

  final Functions functions;

  @Cacheable('reports')                              // one entry per caller and year
  Future<String> byYear(int year) => functions.report(year);

  @Cacheable('reports', key: "'explicit:' + #year")  // kept apart per caller too
  Future<String> byYearWithKey(int year) => functions.report(year);

  @Cacheable('catalog')                              // the same for everyone, see below
  Future<String> shared(int year) => functions.report(year);
}
spring:
  supabase:
    cache:
      shared: [catalog]

byYear(2026) を呼び出す二人のユーザーは、それぞれ別のエントリーを得ます。anon キーとサービスロールも同じです。

仕組み

スターターは、二つのデフォルトを持つ CachingConfigurer (Bean 名は supabaseCachingConfigurer) を宣言します。

Bean すること
supabaseKeyGenerator (SupabaseKeyGenerator、KeyGenerator の一つ) key: のない呼び出しのキーは SupabaseCacheKey になる。誰が呼び出しているか (SupabaseCredentials.caller) と、SimpleKeyGenerator が引数から作るものの組み合わせ。
supabaseCacheResolver (SupabaseCacheResolver、CacheResolver の一つ) 明示的な key: は、どのキージェネレーターも通らない。そこで、このリゾルバーが返すキャッシュは、そのようなキーに呼び出し元を加え、すでに呼び出し元を含むキーはそのままにする。キーに呼び出し元が二重に付くことはない。

共有キャッシュ

すべての人にとって同じデータのキャッシュは、spring.supabase.cache.shared に名前を書きます。そのキャッシュのキーは呼び出し元を含まないので、一つのエントリーがすべての人に使われます。

キャッシュを共有するのは、キャッシュされた呼び出しがすべての呼び出し元に同じ答えを返す場合だけにしてください。公開のテーブルや、行レベルセキュリティのない関数です。

独自の CachingConfigurer

スターターの configurer は、アプリケーションの CachingConfigurer の Bean に譲ります。二つの Bean は残るので、使いたい場所で名前を指定します。

@Cacheable('todos', keyGenerator: 'supabaseKeyGenerator')
Future<List<Todo>> open(String listId) => todos.findByListId(listId);

独自のキージェネレーターは、SupabaseKeyGenerator を呼び出すことも、credentials.caller.key を自分で読むこともできます。

キャッシュされないもの

ストリームは、キャッシュスターターと同じく、キャッシュできません。Stream のダウンロードや、Realtime のストリームです。署名付き URL は、期限が切れると使えなくなります。その expiresIn より短い時間だけキャッシュしてください。スターターはこれを検査しません。

プロパティ

キー 型 デフォルト 意味
spring.supabase.cache.shared List<String> 空 エントリーがすべてのユーザーで同じキャッシュ。

Spring (Java) との対応

KeyGenerator、CacheResolver、CachingConfigurer は Spring のものです。Spring には、ユーザーをキーに入れるデフォルトはありません。アプリケーションがそのための KeyGenerator を書きます。

関連項目