関数が異なる点

コードはサーバーのものです。コンパイルは通るが動作が異なるものを、以下に示します。

一覧

サーバー 関数
起動 プロセスの開始時に一度 インスタンスごとに一度、最初のリクエストで (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();
    }
  }
}

失敗したハンドラーは、ほかのハンドラーが実行された後で、その実行を失敗させます。

警告のリスト

コンパイルは通るが動作が異なるものは、関数の起動時に一度だけ表示されます。

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 から来ます。スターターには三つあります。

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 で省略できます。 レート制限 を参照してください。

関連項目