
# spring_boot_starter_edge

`spring_boot_starter_edge` は、同じ Spring for Dart のアプリケーションを**関数**として実行します。Supabase Edge Functions、Cloudflare Workers、AWS Lambda、Deno Deploy、Netlify Edge Functions、Vercel Functions で動かせます。アプリケーションは JavaScript (または WebAssembly) にコンパイルされ、ソケットの代わりにプラットフォームの fetch API で応答します。コントローラー、フィルター、Spring Security、Feign クライアント、その他のスターターは、サーバーのものと同じです。

## 使う理由

関数プラットフォームは、リクエストが来るとインスタンスを起動し、そのリクエストを渡して JavaScript のエントリーファイルを呼び出します。Dart のサーバーはそのファイルになれません。ソケットを開くためです。スターターは `dart compile js` でアプリケーションをコンパイルし、結果の隣にプラットフォームのエントリーファイルを書き、エントリーに `FetchApplication` を渡します。リクエストが入り、レスポンスが出て、その間でアプリケーションのフィルターとコントローラーが動きます。エントリーは手で書くものではありません。

## セットアップ

```yaml
dependencies:
  spring_boot_starter_edge: ^0.9.0   # brings and exports the web starter
```

## 例

```dart
import 'package:spring_boot_starter_edge/spring_boot_starter_edge.dart';

import 'spring_gen/main.spring.dart';

@RestController()
class BooksController {
  @GetMapping('/books')
  Future<List<Book>> list() => books.all();
}

@SpringBootApplication()
void main() => runFetchApplication(() => springApplication);
```

```bash
dart run build_runner build
dart run spring_boot_starter_edge:build --platform supabase --name api
```

`dart run bin/main.dart` で実行すると、同じ `main` が `server.port` で通常のサーバーを起動します。関数の開発とデバッグは、この方法で行います。

## 内容

- [空のディレクトリから関数を作る](first-function.md): Supabase のテーブルに対する小さな REST API を、実行し、テストし、ローカルで動かし、デプロイする。
- [ビルド](building.md): コマンド、オプション、プラットフォームごとに書かれるもの、WebAssembly、デプロイのワークフロー、サイズ。
- [関数のデプロイ](deploying.md): Supabase、Cloudflare、AWS の手順。手作業と GitHub Actions、シークレット、デプロイした関数の確認。
- [Supabase Edge Functions](supabase.md): コンテキストパス、環境、`verify_jwt`、anon キー、ローカルスタック。
- [Cloudflare Workers](cloudflare.md): バインディング (KV、D1)、D1 のレートリミッター、cron トリガー。
- [AWS Lambda](aws.md): 四つのトリガー、base64、クッキー、`--streaming`、EventBridge のスケジュール。
- [Deno Deploy、Netlify、Vercel](other-platforms.md)
- [関数が異なる点](differences.md): 一覧、`waitUntil`、スケジュールによる処理、警告のリスト、レートリミッター。
- [すべてのプロパティ](properties.md)
- [テスト](testing.md): `FetchApplication`、`FetchRequest`、`FetchResponse`、スターター自身のテストが動く場所。

## まだないもの

- Cloudflare のその他のバインディング (キュー、R2、Durable Objects)。
- Azure Functions と Google Cloud Functions (それぞれ独自のリクエスト型を持ちます。コンテナープラットフォームでは通常のサーバーが動きます)。
- Deno Deploy、Netlify、Vercel のデプロイワークフロー。

## Spring (Java) との対応

サーバーレスの Java コンテナー (`SpringBootLambdaContainerHandler`) と、Spring Cloud Function のアダプターです。

## 関連項目

- [spring_boot_starter_web](../spring-boot-starter-web/index.md)
- [spring_boot_starter_supabase](../spring-boot-starter-supabase/index.md)
- [Dart で書く Edge Function](../spring-boot-starter-supabase/edge-function.md)
- [ビルドに含まれるもの](optimizations.md)
