ASP.NET HTTP モジュールと HTTP ハンドラー

[アーティクル]
03/20/2024

この記事では、ハイパーテキスト転送プロトコル (HTTP) モジュールと HTTP ハンドラー ASP.NET について説明します。

元の製品バージョン: ASP.NET
元の KB 番号: 307985

概要

HTTP モジュールと HTTP ハンドラーは、ASP.NET アーキテクチャの不可欠な部分です。要求が処理されている間、各要求は複数の HTTP モジュール (認証モジュールやセッションモジュールなど) によって処理され、1 つの HTTP ハンドラーによって処理されます。ハンドラーが要求を処理すると、要求は HTTP モジュールを介してフローバックされます。

HTTP モジュールの概要

モジュールは、ハンドラーの実行前と実行後に呼び出されます。モジュールを使用すると、開発者は個々の要求をインターセプト、参加、または変更できます。モジュールは、名前空間にある IHttpModule インターフェイスを System.Web 実装します。

HTTP モジュールが同期できる使用可能なイベント

クラスは HttpApplication 、モジュールが同期できる多数のイベントを提供します。各要求で同期するモジュールでは、次のイベントを使用できます。これらのイベントは、順番に一覧表示されます。

BeginRequest: 要求が開始されました。要求の開始時に何かを行う必要がある場合 (たとえば、各ページの上部に広告バナーを表示する)、このイベントを同期します。
AuthenticateRequest: 独自のカスタム認証スキームをプラグインする場合 (たとえば、データベースに対してユーザーを検索してパスワードを検証する)、このイベントを同期してユーザーの認証方法を認証するモジュールを構築します。
AuthorizeRequest: このイベントは、承認メカニズムを実装するために内部的に使用されます (たとえば、アクセス制御リスト (ACL) をファイルシステムではなくデータベースに格納する場合など)。このイベントをオーバーライドすることはできますが、そうする理由はあまりありません。
ResolveRequestCache: このイベントは、出力キャッシュからページを提供できるかどうかを決定します。独自のキャッシュモジュールを記述する場合 (たとえば、メモリキャッシュではなくファイルベースのキャッシュを構築する) 場合は、このイベントを同期して、キャッシュからページを処理するかどうかを判断します。
AcquireRequestState: セッション状態は状態ストアから取得されます。独自の状態管理モジュールを構築する場合は、このイベントを同期して、状態ストアからセッション状態を取得します。
PreRequestHandlerExecute: このイベントは、HTTP ハンドラーが実行される前に発生します。
PostRequestHandlerExecute: このイベントは、HTTP ハンドラーが実行された後に発生します。
ReleaseRequestState: セッション状態は状態ストアに保存されます。カスタムセッション状態モジュールを構築する場合は、状態を状態ストアに格納し直す必要があります。
UpdateRequestCache: このイベントは、出力キャッシュに出力を書き戻します。カスタムキャッシュモジュールをビルドする場合は、出力をキャッシュに書き戻します。
EndRequest: 要求が完了しました。要求全体で情報を収集し、その情報をページに書き込むデバッグモジュールを構築することもできます。

次のイベントは、各要求転送で同期するモジュールで使用できます。これらのイベントの順序は決定論的ではありません。

PreSendRequestHeaders: このイベントは、ヘッダーが送信される前に発生します。ヘッダーを追加する場合は、カスタムモジュールからこのイベントを同期できます。
PreSendRequestContent: このイベントは、メソッドが Response.Flush 呼び出されたときに発生します。追加のコンテンツを追加する場合は、カスタムモジュールからこのイベントを同期できます。
Error: このイベントは、未処理の例外が発生したときに発生します。カスタムエラーハンドラーモジュールを記述する場合は、このイベントを同期します。

HTTP モジュールを構成する

<httpModules>構成セクションハンドラーは、アプリケーション内で HTTP モジュールを構成する役割を担います。これは、コンピューター、サイト、またはアプリケーションレベルで宣言できます。セクションハンドラーには、次の構文を <httpModules> 使用します。

<httpModules>
    <add type="[COM+ Class], [Assembly]" name="[ModuleName]" />
    <remove type="[COM+ Class], [Assembly]" name="[ModuleName]" />
    <clear />
</httpModules>

HTTP モジュールを作成する

HTTP モジュールを作成するには、インターフェイスを実装する IHttpModule 必要があります。 IHttpModuleインターフェイスには、次のシグネチャを持つ 2 つのメソッドがあります。

void Init(HttpApplication);
void Dispose();

HTTP ハンドラーの概要

ハンドラーは、個々のエンドポイント要求を処理するために使用されます。ハンドラーを使用すると、ASP.NET フレームワークは、アプリケーション内の個々の HTTP URL または URL 拡張機能のグループを処理できます。モジュールとは異なり、要求の処理に使用されるハンドラーは 1 つだけです。すべてのハンドラーは、内にある IHttpHandler インターフェイスを System.Web namespace実装します。ハンドラーは、インターネットサーバーアプリケーションプログラミングインターフェイス (ISAPI) 拡張機能に似ています。

HTTP ハンドラーを構成する

<httpHandlers>構成セクションハンドラーは、受信 URL をまたは IHttpHandlerFactory クラスにマッピングする役割をIHttpHandler担います。これは、コンピューター、サイト、またはアプリケーションレベルで宣言できます。サブディレクトリは、これらの設定を継承します。

管理者は、タグディレクティブを <add> 使用してセクションを <httpHandlers> 構成します。 <Add> ディレクティブは、トップダウン順に解釈および処理されます。セクションハンドラーには、次の構文を <httpHandler> 使用します。

<httpHandlers>
    <add verb="[verb list]" path="[path/wildcard]" type="[COM+ Class], [Assembly]" validate="[true/false]" />
    <remove verb="[verb list]" path="[path/wildcard]" />
    <clear />
</httpHandlers>

HTTP ハンドラーを作成する

HTTP ハンドラーを作成するには、インターフェイスを実装する IHttpHandler 必要があります。インターフェイスには IHttpHandler 、次のシグネチャを持つ 1 つのメソッドと 1 つのプロパティがあります。

void ProcessRequest(HttpContext);
bool IsReusable {get;}

注:

HTTP ハンドラーでセッション状態が必要な場合は、インターフェイスも実装 IRequiresSessionState する必要があります。

次の方法で共有