Actix Web を整える。

雛形

エンドポイントの一覧から main.rs を作る

1行に1つ「メソッド パス [名前]」を書くと、#[get] などのマクロ付きの関数と、それを .service() で登録した main.rs の雛形を作ります。パスの値は {id} でも :id でも構いません。

そもそも Actix Web とは

Rust で、速くて型に厳しい Web サーバーを作る道具。

どこで・どんな場面で使うか

• 処理速度が求められる API

  同時にたくさんのアクセスをさばく API やバックエンドで、性能を重視するときに候補になります。

• Rust で作るサービスの入り口

  ほかの部分を Rust で書いているシステムに、HTTP の受け口をつけるときに使われます。

• 型で守られた入力の受け取り

  パスの値やクエリ、JSON を型で受けるので、形の違う入力を早い段階で止めたい場面に向きます。

• Rust の学習・実践

  所有権などの Rust の基本を覚えたあと、実際に動く Web サービスを作る題材として選ばれます。

• 長く動かすサーバー

  コンパイル時にチェックされる範囲が広いので、運用中の思わぬ不具合を減らしたいときに向きます。

向いている場面・向いていない場面

• 向いている：速さと安全性を重視する API。型で受けるぶん、書く手間と引き換えに間違いを早く見つけられます。
• 向いている：Rust をすでに使っているチーム。同じ言語でサーバーまで書けます。
• 注意：Rust 自体の学習コストがあります。短期間で画面まで作りたい場合は、より手軽な道具のほうが合うことがあります。

上の練習場で main.rs を書き、リクエストがどの関数に届くか、引数に何が入るかを試してみてください。

理由

Actix Web のルーティングの決まりごと

Actix Web は「登録した順に照合し、最初の一致が勝つ」が基本。そのうえで、つまずきやすい4つの決まりがあります。

• ①

  マクロを付けただけでは届かない

  #[get("/health")] を付けた関数も、App::new().service(health) で登録しなければどこからも呼ばれず 404 になります。この練習場は登録漏れを警告します。

• ②

  404 と 405 は登録の仕方で変わる

  マクロや .route("/x", web::get()…) はメソッドの条件を持ったまま照合されるので、メソッド違いは次へ進み、最後まで無ければ 404。web::resource("/x") にまとめた場合は、パスが合ってメソッドだけ違うと 405 Method Not Allowed（メソッド不許可） を返します。

• ③

  scope に入ったら、外には戻らない

  web::scope("/api") は前方一致で入り、中のどれにも一致しなければその場で 404。後ろに書いた /api/… の受け皿には落ちてきません。

• ④

  引数の型が「入口の検査」になる

  web::Path<u32> に /users/abc は入らず 404、web::Json<T> は Content-Type が違うか JSON が壊れていると 400。どちらも関数の中身が動く前に止まります。

説明

このページについて

Rust のプログラムはブラウザの中でコンパイルも実行もできないため、Actix Web 本体は動かしていません。このページは、あなたが書いた main.rs を文字として読み取り、App::new() から続く登録と、#[get] などのマクロを Actix Web 4 の照合規則に沿って解きます。

ガード（.guard()）・ミドルウェア（.wrap()）・.configure()・JSON の項目の型の検査・関数の戻り値は再現していません。cargo run での本番の挙動は Actix Web の公式ドキュメントで確かめてください。

書いたコードとリクエストは端末内で処理し、外部へ送信しません（送信ゼロ）。外部のライブラリも読み込みません。