ASP.NET Web API（C#）の組み込みメッセージハンドラーとは？仕組みと種類を解説

メッセージハンドラー（Message Handler）とは、HTTPリクエストを受け取り、HTTPレスポンスを返す役割を持つクラスのことです。すべてのメッセージハンドラーは、抽象クラス HttpMessageHandler から派生します。このハンドラーを利用することで、リクエストが HttpControllerDispatcher に到達する前に、その内容を処理・編集、あるいは拒否することができます。

メッセージハンドラーは、リクエスト処理パイプラインのごく早い段階で実行されるため、Web APIにおける横断的関心事（クロスカッティングコンサーン）を実装するのに最適な場所です。メッセージハンドラーとは、パイプラインを通じてHTTPリクエストとレスポンスを順次処理していく、一連のクラスの連鎖（システム定義のものでも、開発者が独自に定義したものでも可）にほかなりません。

メッセージハンドラーの基本的な流れ

例えば、あるHTTPリクエストがHTTPサーバーに到着した場合、まず最初のハンドラー（HandlerA）に渡され、そこでの処理が完了すると次のハンドラー（HandlerB）へと引き継がれていきます。この仕組みの大きな利点は、ビジネス要件に応じて各ハンドラー内で特定のタスクを実行できる点にあります。

メッセージハンドラーの2つの種類

ASP.NET Web APIフレームワークでは、以下の2種類のメッセージハンドラーが利用できます。

• サーバーサイドHTTPメッセージハンドラー
• クライアントサイドHTTPメッセージハンドラー

サーバーサイドのメッセージハンドラー

サーバーサイドでは、Web APIパイプラインが次のような組み込みメッセージハンドラーを使用します。

• HttpServer： ホストからリクエストを受け取ります。
• HttpRoutingDispatcher： ルート情報に基づいてリクエストを振り分けます。
• HttpControllerDispatcher： リクエストをWeb APIコントローラーへ送信します。

これらのパイプラインには、開発者が作成したカスタムハンドラーを自由に追加することも可能です。メッセージハンドラーは、コントローラーアクションではなくHTTPメッセージそのもののレベルで動作する横断的関心事の実装に適しています。具体的には、次のような用途が挙げられます。

• リクエストヘッダーの読み取りや変更
• レスポンスへのカスタムヘッダーの追加
• リクエストがコントローラーに到達する前の事前検証（認証チェックなど）

クライアントサイドのメッセージハンドラー

クライアントサイドでは、HttpClient クラスがメッセージハンドラーを使ってリクエストを処理します。既定のハンドラーは HttpClientHandler であり、ネットワーク経由でリクエストを送信し、サーバーからレスポンスを受け取る役割を担います。クライアント側のパイプラインにも、カスタムメッセージハンドラーを挿入できます。

まとめ

メッセージハンドラーは、HTTPリクエスト／レスポンスの流れの中で早期に処理を介入できる強力な拡張ポイントです。認証、ログ出力、ヘッダー操作など、API全体で共通して必要となる処理をハンドラーとして切り出すことで、コードの再利用性と保守性を高めることができます。