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 を渡します。リクエストが入り、レスポンスが出て、その間でアプリケーションのフィルターとコントローラーが動きます。エントリーは手で書くものではありません。
セットアップ
dependencies:
spring_boot_starter_edge: ^0.9.0 # brings and exports the web starter
例
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);
dart run build_runner build
dart run spring_boot_starter_edge:build --platform supabase --name api
dart run bin/main.dart で実行すると、同じ main が server.port で通常のサーバーを起動します。関数の開発とデバッグは、この方法で行います。
内容
- 空のディレクトリから関数を作る: Supabase のテーブルに対する小さな REST API を、実行し、テストし、ローカルで動かし、デプロイする。
- ビルド: コマンド、オプション、プラットフォームごとに書かれるもの、WebAssembly、デプロイのワークフロー、サイズ。
- 関数のデプロイ: Supabase、Cloudflare、AWS の手順。手作業と GitHub Actions、シークレット、デプロイした関数の確認。
- Supabase Edge Functions: コンテキストパス、環境、
verify_jwt、anon キー、ローカルスタック。 - Cloudflare Workers: バインディング (KV、D1)、D1 のレートリミッター、cron トリガー。
- AWS Lambda: 四つのトリガー、base64、クッキー、
--streaming、EventBridge のスケジュール。 - Deno Deploy、Netlify、Vercel
- 関数が異なる点: 一覧、
waitUntil、スケジュールによる処理、警告のリスト、レートリミッター。 - すべてのプロパティ
- テスト:
FetchApplication、FetchRequest、FetchResponse、スターター自身のテストが動く場所。
まだないもの
- Cloudflare のその他のバインディング (キュー、R2、Durable Objects)。
- Azure Functions と Google Cloud Functions (それぞれ独自のリクエスト型を持ちます。コンテナープラットフォームでは通常のサーバーが動きます)。
- Deno Deploy、Netlify、Vercel のデプロイワークフロー。
Spring (Java) との対応
サーバーレスの Java コンテナー (SpringBootLambdaContainerHandler) と、Spring Cloud Function のアダプターです。