
# 関数が異なる点

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

## 一覧

| | サーバー | 関数 |
|---|---|---|
| 起動 | プロセスの開始時に一度 | インスタンスごとに一度、最初のリクエストで (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` は、処理が終わるまでインスタンスを保ちます。

```dart
@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 を呼びます。

```dart
@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` で省略できます。 [レート制限](../spring-boot-starter-web/rate-limiting.md) を参照してください。

## 関連項目

- [すべてのプロパティ](properties.md)
- [Supabase Edge Functions](supabase.md)
- [Cloudflare Workers](cloudflare.md)
