Dart で書く Edge Function
Edge Function は TypeScript でなくてもかまいません。spring_boot_starter_edge は、Spring for Dart のアプリケーションを JavaScript にコンパイルし、Supabase の Edge Runtime が必要とする index.ts を書きます。アプリケーションにこのスターターがあれば、関数は呼び出し元としてプロジェクトに届きます。設定は Supabase Edge Functions を参照してください。
example/supabase/function がそのような関数で、名前は api です。その main は次のとおりです。
@SpringBootApplication()
void main() => runFetchApplication(() => springApplication);
dart run build_runner build
dart run spring_boot_starter_edge:build \
--platform supabase --name api \
--output ../supabase/functions/api
示しているもの
- 呼び出し元としての、REST パスによる todos。
Todosリポジトリ (ListCrudRepository<Todo, int>) に、findByListIdOrderByIdと@Procedure('close_all')があります。リクエストのトークンはプロジェクトにそのまま渡されるので、呼び出し元に何が見えるかはプロジェクトの行レベルセキュリティが決めます。関数にはソケットがないため、使えるのは REST パスだけで、SQL は使えません。 - ロール。
/healthは誰にでも開かれています。/meは、リソースサーバーがプロジェクトのトークンから読んだ ID とロールを返します。/adminは@PreAuthorize("hasRole('ADMIN')")です。ベアラートークンはプロジェクトのアクセストークンで、Supabase スターターのデフォルトに従います。 - ユーザーごとに 1 分 10 回のレート制限。 todo の追加には
@RateLimiter('10/1m', key: '#{authentication.name}', name: 'add-todo')が付いています。カウンターはプロジェクトのデータベースにあり、サービスロールとして呼ばれるデータベース関数rate_limit_acquireを通して数えるので、関数のすべてのインスタンスが同じ数を共有します。spring.web.rate-limit.enabled: trueのとき、これは Supabase スターターのデフォルトのストアです。
@PostMapping()
@ResponseStatus(HttpStatus.created)
@RateLimiter('10/1m', key: '#{authentication.name}', name: 'add-todo')
Future<Todo> add(@RequestBody() @Valid() NewTodo todo) => todos.save(
Todo(
title: todo.title,
listId: todo.listId,
createdAt: DateTime.now().toUtc(),
),
);
- アプリとサーバーが呼ぶもの。
GET /statsは、誰が呼んだか (リソースサーバーが検証済みのトークンから読んだユーザーとロール、そしてapikeyヘッダーが届いたかどうか) を返します。from=failは 422 を返します。POST /send-inviteは{email}を受け取り、呼び出し元の ID とアドレスからなる{id}を返します。アプリとサーバーは、それぞれの@EdgeFunctionsインターフェースの@EdgeFunction('api/stats')と@EdgeFunction('api/send-invite')を通してこれらを呼びます。アプリはブラウザーでも動き、プロジェクトとは別のオリジンになるため、コントローラーには@CrossOriginがあり、プリフライトに応答します。
サンプルのプロジェクトには、TypeScript で書かれた関数はありません。この二つは、この関数のエンドポイントです。
関数は、サンプルの config.toml で verify_jwt = false の [functions.api] となり、ローカルスタックのために [edge_runtime.secrets] に SPRING_SUPABASE_AUTH_ISSUER があります。