
# ネットワーク上のリソース

`ResourceLoader` の `http:` / `https:` リソース(`@Value` の `Resource`、`getResource`、`ResourceView`、`ResourceImage`)は、一度ダウンロードされるとアプリのファイルに保持されます。以後は再起動後もディスクから読み、期限を過ぎるとバックグラウンドで問い合わせ直します。

## なぜ

iOS、Android、デスクトップでは、`Image.network` は画像をメモリにしか保持しません。そのため起動のたびにアバターや画像を再びダウンロードします。ブラウザーでは HTTP キャッシュが保持しますが、それもサーバーのヘッダーが許す範囲だけです。アプリのファイルに保持したリソースなら次の起動でもネットワークなしで使えて、サーバーへの確認はときどきで済みます。

## 例

```yaml
spring:
  flutter:
    resources:
      cache:
        max-size: 300MB          # 保持するリソース全体の上限
        max-age: 7d              # 過ぎたら使いつつ問い合わせ直す
        max-entry-size: 50MB     # これより大きいものは毎回ネットワークから
        locations:               # 最初に一致した規則が勝つ
          - pattern: https://avatars.steamstatic.com/**
            max-age: 1d
          - pattern: https://api.example.com/**
            enabled: false
      view:
        fade: 200ms
```

```dart
// どんなリソースも。いまは画像、独自の種類はレンダラーの Bean で。
ResourceView(
  player.avatarUrl,
  width: 40,
  height: 40,
  fit: BoxFit.cover,
  shape: const CircleBorder(),
  placeholder: const AvatarPlaceholder(),
  error: (context, error) => const AvatarPlaceholder(),
)

// ImageProvider を受け取る Flutter のウィジェット向け。
CircleAvatar(backgroundImage: ResourceImage(player.avatarUrl))
```

## 仕組み

- **置き場所。** ファイルの `cache` の場所(システムが消すことがある。ブラウザーでは IndexedDB)の `spring/resources/<アドレスの sha256>/` です。バイト列を `data` に、アドレス、バイト列のダイジェスト、メディアタイプ、取得日時、`ETag`、`Last-Modified` を `meta.json` に保存します。
- **鮮度。** 保持したリソースはディスクから読みます。期限を過ぎてもディスクから読み、バックグラウンドで `If-None-Match` / `If-Modified-Since` を付けて問い合わせ直します。変わっていなければダウンロードは発生しません。ダイジェストと合わないバイト列はダウンロードし直します。
- **専用の上限。** `spring.flutter.resources.cache.max-size` はリソースだけ、つまりフォルダー `spring/resources/` に対する上限です。超えると、最も長く使われていないものから消えます。ディスクに保持する `@Cacheable` の結果([`spring.cache.type: disk`](../spring-boot-starter-cache/disk-caches.md)、`spring/caches/`)はファイルではなくデータです。上限も別のキャッシュなので、ここには数えられず、リソースと一緒に消えることもありません。
- **アプリ自身のリソース**(`asset:`、`resources:`)はここにはコピーしません。ブラウザーでは [Web ビルドのヘッダー](cache-headers.md)に従って HTTP キャッシュが保持します。
- **ウィジェットは 1 つ。** `ResourceView` はリソースを読み、メディアタイプ(サーバーが返したもの、なければ拡張子)を調べ、それを表示できる最初の `ResourceRenderer` の Bean を選びます。プレースホルダー、エラー、フェード、サイズ、形、セマンティクスはどの種類でも同じように扱います。画像はスターターのもの(`ImageResourceRenderer`)です。文書や動画のレンダラーは、アプリが Bean を 1 つ追加して加えます。

```dart
@Component()
class PdfRenderer implements ResourceRenderer {
  @override
  bool supports(String mediaType) => mediaType == 'application/pdf';

  @override
  Widget build(BuildContext context, LoadedResource resource,
          ResourceLayout layout) =>
      PdfView(bytes: resource.bytes);
}
```

## 選んだプレーヤーで動画を再生する

フレームワークはプレーヤーを持ちません。保持したリソースは `playableUri()` で、プレーヤーが再生できるアドレスを返します。保持したファイル(`file:`)、ブラウザーではその `blob:`、初回は次回のために保持している間の元のアドレスです。

```dart
final clip = resources.getResource(highlightUrl) as CachedResource;
final uri = await clip.playableUri();
final controller = uri.scheme == 'file'
    ? VideoPlayerController.file(File(uri.toFilePath()))
    : VideoPlayerController.networkUrl(uri);
await controller.initialize();
```

保持するのは単一のファイル(mp4、webm)です。断片のプレイリスト(HLS、DASH)は保持しません。書き込み中のファイルはネットワークから再生します。

## プロパティ

| キー | 既定値 | 意味 |
|---|---|---|
| `spring.flutter.resources.cache.enabled` | `true` | `http(s)` のリソースを保持するか |
| `spring.flutter.resources.cache.max-age` | `7d` | そのまま使う期間 |
| `spring.flutter.resources.cache.max-entry-size` | `50MB` | 保持する最大のサイズ |
| `spring.flutter.resources.cache.max-size` | なし | 保持するリソース全体の最大バイト数 |
| `spring.flutter.resources.cache.locations` | なし | アドレスごとの規則: `pattern`、`max-age`、`enabled` |
| `spring.flutter.resources.view.fade` | `200ms` | `ResourceView` のフェード |
