関数が異なる点
コードはサーバーのものです。コンパイルは通るが動作が異なるものを、以下に示します。
一覧
| サーバー | 関数 | |
|---|---|---|
| 起動 | プロセスの開始時に一度 | インスタンスごとに一度、最初のリクエストで (Supabase、AWS: ロード時) |
| TLS、HTTP/2、圧縮、接続数の制限 | server.* |
プラットフォーム |
server.max-http-request-body-size、server.request-timeout |
適用される | 適用される |
%2F、%5C、%00、.、.. を含むターゲット |
400 | 400 (requestTargetProblem、同じチェック) |
| クライアントのアドレス | ソケットの相手 | プラットフォームが示すもの。クライアントが設定できるヘッダーは決して使わない |
| サーバー送信イベント、ダウンロード | ストリーミングされる | ストリーミングされる (AWS: --streaming のとき) |
| WebSocket エンドポイント | あり | なし: UnsupportedError |
| マルチパートのアップロード | しきい値を超えるとディスク | メモリ上 |
dart:io、アイソレート、データベースドライバー |
使える | JavaScript にコンパイルできない: コンパイラーがそう伝える |
| セッション | メモリ上 | インスタンスごと: トークンを使う (SessionCreationPolicy.stateless) |
応答後の処理
プラットフォームは、レスポンスが送られるとすぐにインスタンスを止めることがあります。EdgeRuntime.waitUntil は、処理が終わるまでインスタンスを保ちます。
@PostMapping('/orders')
Order place(@RequestBody() Order order) {
runtime.waitUntil(mail.confirm(order)); // after the response
return order;
}
Supabase では EdgeRuntime.waitUntil、Cloudflare、Netlify、Vercel では ctx.waitUntil です。AWS では、処理が終わったときに呼び出しが終わります。サーバーと Deno Deploy では、処理はそのまま実行されます。EdgeRuntime.platform は、supabase、cloudflare、aws、deno、netlify、vercel、サーバーでは null です。
スケジュールによる処理
タイマーはリクエストより長くは生きないので、@Scheduled のメソッドはリクエストの合間には動きません。その処理はプラットフォームのスケジュールが行います。スケジュールが関数を実行し、関数がすべての EdgeScheduledHandler の Bean を呼びます。
@Component()
class NightlyReport implements EdgeScheduledHandler {
NightlyReport(this.reports);
final Reports reports;
@override
Future<void> onScheduled(EdgeScheduledEvent event) async {
if (event.schedule == '0 3 * * *') {
await reports.send();
}
}
}
- Cloudflare: cron トリガー。
event.scheduleはその式です。 - AWS: この関数をターゲットにした EventBridge のルールまたはスケジュール。
event.scheduleはルールの ARN です。 - Supabase:
pg_cronが HTTP で関数のエンドポイントを呼びます。これは通常のリクエストです。
失敗したハンドラーは、ほかのハンドラーが実行された後で、その実行を失敗させます。
警告のリスト
コンパイルは通るが動作が異なるものは、関数の起動時に一度だけ表示されます。
WARN Running as a function; these work differently here:
- the rate limiter counts in memory: every instance has its own counters, ...
- @Scheduled Rates.refresh (PeriodicTrigger(fixedRate: 1:00:00.000000)): timers do not outlive a request; ...
- cached values (bean 'cacheManager'): kept in the memory of each short-lived instance, ...
- sessions (bean 'httpSessionRepository'): kept in the memory of each short-lived instance, ...
各行は EdgeWarningContributor の Bean から来ます。スターターには三つあります。
RateLimitStoreEdgeWarning: メモリ上のレートリミッター。TimerWorkEdgeWarning: すべての@Scheduledのメソッド (TimerDrivenWorkである Bean)。InstanceStateEdgeWarning: 状態をインスタンスのメモリに持つすべての Bean (IsolateLocalStateである Bean: メモリ上のキャッシュとセッション。ほかの場所に置かれたキャッシュは載りません)。
TimerDrivenWork と IsolateLocalState は spring_core_dart のもので、プラットフォームについては何も述べません。アイソレートのプールも、同じ Bean について警告します。コントリビューターの型の Bean を加えると、自分の行を追加できます。spring.edge.warnings: false でリストを止められます。
このリストは起動時チェックです。edgeWarnings と三つのコントリビューターは独立したモジュールにあり、ジェネレーターは spring.main.startup-checks.enabled でそれをビルドに含めます。true (application.yml または application.properties で): すべてのビルドに含める。false: どのビルドにも含めない。コードがないので、リストもない。未設定: デバッグビルドとプロファイルビルドだけ。dart compile js と wasm は dart.vm.product を定義しないので、それらでコンパイルした関数は、キーが false でない限りリストを残します。ビルドに含まれている場合は、spring.edge.warnings でリストを止められます。
レートリミッター
spring.web.rate-limit.* と @RateLimiter はサーバーと同じように動きますが、インスタンスのメモリは数える場所ではありません。共有ストアを使ってください。
| プラットフォーム | ストア |
|---|---|
| Supabase (Supabase スターターあり) | プロジェクトのデータベース関数 (rate_limit_acquire、サービスロールとして呼ばれます) |
| Cloudflare | D1 データベース (spring.edge.cloudflare.rate-limit.database、ストア名 d1) |
| それ以外 | RateLimitStore の Bean を宣言する |
ストアが失敗したときは、リクエストは拒否されます (on-store-failure: deny、デフォルト)。
ストアは関数の起動時、つまりインスタンスの最初のリクエストで確認されます。Supabase プロジェクトのデータベース関数が一度呼ばれ、D1 のバインディングが求められてテーブルが作られます。マイグレーションされていない関数 (Supabase スターターの sql/rate_limit.sql) や、wrangler.toml にないバインディングは起動を失敗させます。リクエストには 500 が返り、ログが実行すべきものを示し、次のリクエストで再び起動を試みます。コールドスタートごとにストアへの呼び出しが 1 回増えます。spring.web.rate-limit.verify-store: false で省略できます。 レート制限 を参照してください。