Contents
Rust生態系におけるミドルウェア設計の重要性
RustでWebアプリケーションを構築する際、ミドルウェアはリクエスト処理の柔軟性と拡張性を左右する重要な要素です。Axumやtower-httpといったフレームワークでは、ミドルウェアを通じてログ出力や認証処理などの共通機能を効率的に実装できます。特に中級エンジニア向けに、「Axum ミドルウェア tower-http 比較」というキーワードで検索する方は、フレームワーク選択時の設計パターンの違いに着目していると考えられます。本記事では、両者のミドルウェア構造や実装手順を比較し、プロジェクトに応じた選び方を解説します。
Axumとtower-httpのミドルウェア構造比較
Axumとtower-httpは、同じRust生態系内でもミドルウェア設計のアプローチが根本的に異なります。この違いを理解することで、フレームワークの使いどころを明確にできます。
デコレーター/チェーン型設計の基本的差異
Axumとtower-httpは共にミドルウェア構造において独自なパターンを採用していますが、その設計思想や実装方法には顕著な違いがあります。以下に両者の特徴を比較します。
| 項目 | Axum（デコレーター型） | tower-http（チェーン型） |
|---|---|---|
| ミドルウェアの適用方式 | サービスにlayer()で装飾 |
map()やand_then()でフローを制御 |
| 非同期処理対応 | 可能（async fn使用） | 本質的に非同期設計 |
| 実装の柔軟性 | 複数ミドルウェアを順番に適用可能 | リクエストフローを細かく調整可能 |
注意: Axumは「デコレーターパターン」、tower-httpは「チェーン型（Chain Pattern）」と呼ばれる設計モデルを採用しています。この差異が両フレームワークの特徴となっています。
Axumのデコレーター型設計
Axumは「デコレーター（Decorator）パターン」を採用しており、ミドルウェアを関数チェーン形式で積み重ねる形で実装します。このアプローチでは、layer()メソッドを使って任意の処理をサービスに追加できます。
- 特徴:
- ミドルウェアがサービスに対して「装飾」を施すように適用される
- 順序付きで複数のミドルウェアを積み重ね可能
tower::Layerトレイトを通じて統一的なインターフェースを持つ
実装サンプル（Axum）
以下はログ出力ミドルウェアの例です。Body型のimportとライフタイム制約に注意してください。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
use axum::{middleware::Next, Request, Response}; use std::time::{Instant}; async fn log_middleware<F>(req: Request<Body>, next: Next<F>) -> Result<Response<Body>, Infallible> where F: FnOnce(Request<Body>) -> Pin<Box<dyn Future<Output = Result<Response<Body>, Infallible>> + Send + 'static>>, { let start_time = Instant::now(); // 次のミドルウェア/ルートハンドラを実行 let response = next.run(req).await; let duration = start_time.elapsed(); println!("Request took: {:?}", duration); Ok(response) } |
ライフタイム制約:
Fに'staticのboundを追加する必要があります。これは、async関数内でのクロージャがスコープを超えて使用される可能性を防ぐためです。
tower-httpのチェーン型設計
一方、tower-httpは「チェーン（Chain）パターン」を採用しており、ミドルウェアがリクエストを連鎖的に処理する仕組みです。この方式では、map()やand_then()などの演算子を使ってフローを制御します。
- 特徴:
- ミドルウェアがリクエストを「つなぐ」ようにして順次処理
- 非同期処理に強い設計となっている
tower::Serviceとtower::Layerの2つのトレイトを使うことで、拡張性が高い
実装サンプル（tower-http）
以下は認証ミドルウェアの例です。Body型やRequest/Responseのimportを確認してください。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
use tower::{Service, Layer}; use http::{Request, Response, header::HeaderValue}; use std::future::Future; use std::pin::Pin; struct AuthMiddleware; impl<F> Layer<F> for AuthMiddleware where F: Service<Request<Body>, Response = Response<Body>>, { type Service = AuthMiddlewareService<F>; fn layer(&self, inner: F) -> Self::Service { AuthMiddlewareService { inner } } } struct AuthMiddlewareService<F> { inner: F, } impl<F> Service<Request<Body>> for AuthMiddlewareService<F> where F: Service<Request<Body>, Response = Response<Body>>, { type Response = Response<Body>; type Error = Infallible; type Future = Pin<Box<dyn Future<Output = Self::Response> + Send + 'static>>; fn poll_ready(&mut self, cx: &mut std::task::Context<'_>) -> std::task::Poll<Result<(), Self::Error>> { self.inner.poll_ready(cx) } fn call(&mut self, req: Request<Body>) -> Self::Future { if let Some(token) = req.headers().get("Authorization") { if token == "valid_token" { return Box::pin(self.inner.call(req)); } } Box::pin(std::future::ready(Response::builder().status(401).body(Body::empty()))) } } |
ライフタイム制約:
Pin<Box<...>>は'staticのライフタイムを明示的に指定しています。これはFutureがスコープを超えて使用されることを防ぐためです。
Service/Layerトレイトの利用方法
Axumとtower-httpは共にtower::Serviceとtower::Layerという2つのトレイトを使ってミドルウェアを構築しますが、実装方法や設計上の利点には違いがあります。
Axumでのasync fnベースの実装
Axumでは、ミドルウェアはasync fnで定義され、Next型を介して次の処理に進みます。この方式により、コードが簡潔かつ直感的になります。
- 利点:
- 非同期処理の実装がラクチン
- 標準ライブラリやエコシステムとの親和性が高い
- エラー処理を
Result型で明示的に管理できる
ただし、ライフタイムや送信可能な型（Send）の制約があるため、複雑な処理には注意が必要です。
tower-httpでのFutureトレイト活用
tower-httpでは、tower::Serviceインターフェースを実装し、Futureを通じて非同期処理を行います。この方式は柔軟性が高い反面、初期設定がやや手間になります。
- 利点:
- リクエストの処理フローを細かくカスタマイズ可能
- 複雑な処理にも耐えられる設計
tower::Layerトレイトを使ってミドルウェアを再利用しやすい
制約:
- 初期設定がやや複雑（
ServiceとLayerの実装が必要） - ライフタイム管理に注意が必要
パフォーマンス・拡張性比較
Axumとtower-httpは、設計思想や性能特性に微妙な違いがあります。プロジェクトの規模や要件によって選ぶべきフレームワークが異なります。
ライフタイム管理の違い
- Axum:
async fnベースなのでライフタイム管理が自動的になる傾向にあり、シンプルなアプリケーションには適しています。 - tower-http: より柔軟なライフタイム制御が可能ですが、初期設定がやや複雑です。
非同期処理の扱い方
- Axum:
async/awaitによる非同期処理が非常に直感的で、ライブラリ側もサポートを強化しています。 - tower-http: リクエストをFutureとして扱うことで、並列処理や遅延評価の最適化が可能です。
適したユースケースと選択基準
プロジェクトの規模や目的に応じて、Axumかtower-httpのどちらを選ぶべきか考察します。
軽量API開発向けのAxum
- 特徴: シンプルなミドルウェア構成、
async fnによる直感的な非同期処理 - 適した用途: ミドルウェアが必要最小限で、高速なリクエスト処理が求められるAPI開発
複雑な処理が必要なtower-http
- 特徴:
ServiceとLayerの柔軟性を活かしたカスタムミドルウェア実装可能 - 適した用途: カスタムHTTPヘッダの検証や、非同期処理に優れたリクエストフローが必要なプロジェクト
| 選択基準 | Axum | tower-http |
|---|---|---|
| ミドルウェアの柔軟性 | シンプルなチェーン構成 | 高度なカスタマイズ可能 |
| 非同期処理の扱いやすさ | 直感的（async/await） | 初期設定がやや複雑 |
| 開発効率 | 快適 | ある程度の学習コストあり |
プロジェクトの規模や要件に応じて、Axumとtower-httpのミドルウェア設計を比較し、最適な選択肢を見極めましょう。