
# キャッシュ

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

## 使う理由

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

## 例

```dart
@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);
}
```

```yaml
spring:
  supabase:
    cache:
      shared: [catalog]
```

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

## 仕組み

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

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

- `evict` と `put` は同じキーを使うので、`@CacheEvict` は呼び出し元のエントリーを削除します。
- `clear` (`@CacheEvict(allEntries: true)`) は、すべての呼び出し元についてキャッシュを空にします。
- 存在しないキャッシュは、その名前を示す `StateError` になります。

## 共有キャッシュ

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

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

## 独自の CachingConfigurer

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

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

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

## キャッシュされないもの

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

## プロパティ

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

## Spring (Java) との対応

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

## 関連項目

- [spring_boot_starter_cache](../spring-boot-starter-cache/index.md)
- [キャッシュのアノテーション](../spring-boot-starter-cache/annotations.md)
- [誰として呼び出すか](credentials.md)
