ネットワーク上のリソース
ResourceLoader の http: / https: リソース(@Value の Resource、getResource、ResourceView、ResourceImage)は、一度ダウンロードされるとアプリのファイルに保持されます。以後は再起動後もディスクから読み、期限を過ぎるとバックグラウンドで問い合わせ直します。
なぜ
iOS、Android、デスクトップでは、Image.network は画像をメモリにしか保持しません。そのため起動のたびにアバターや画像を再びダウンロードします。ブラウザーでは HTTP キャッシュが保持しますが、それもサーバーのヘッダーが許す範囲だけです。アプリのファイルに保持したリソースなら次の起動でもネットワークなしで使えて、サーバーへの確認はときどきで済みます。
例
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
// どんなリソースも。いまは画像、独自の種類はレンダラーの 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/caches/)はファイルではなくデータです。上限も別のキャッシュなので、ここには数えられず、リソースと一緒に消えることもありません。 - アプリ自身のリソース(
asset:、resources:)はここにはコピーしません。ブラウザーでは Web ビルドのヘッダーに従って HTTP キャッシュが保持します。 - ウィジェットは 1 つ。
ResourceViewはリソースを読み、メディアタイプ(サーバーが返したもの、なければ拡張子)を調べ、それを表示できる最初のResourceRendererの Bean を選びます。プレースホルダー、エラー、フェード、サイズ、形、セマンティクスはどの種類でも同じように扱います。画像はスターターのもの(ImageResourceRenderer)です。文書や動画のレンダラーは、アプリが Bean を 1 つ追加して加えます。
@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:、初回は次回のために保持している間の元のアドレスです。
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 のフェード |