(轉)HTTP 模块介绍

落日映苍穹つ 2022-08-25 10:56 134阅读 0赞

本文轉自:http://msdn2.microsoft.com/zh-cn/library/ms178468(VS.80).aspx

HTTP 模块介绍

HTTP 模块是一个在每次针对应用程序发出请求时调用的程序集。HTTP 模块作为 ASP.NET 请求管线的一部分调用，它们能够在整个请求过程中访问寿命周期事件。因此，HTTP 模块使您有机会检查传入的请求并根据该请求采取操作。它们还使您有机会检查出站响应并修改它。

ASP.NET HTTP 模块针对所有的请求运行，这与 ISAPI 筛选器类似。但是它们是用托管代码编写的，而且可以与 ASP.NET 应用程序的生命周期完全集成。

HTTP 模块典型的用法包括：

*  安全性。因为您可以检查传入的请求，所以 HTTP 模块可以在请求页、XML Web services 或调用处理程序之前执行自定义的身份验证或其他安全检查。
 *  统计信息和日志记录。因为 HTTP 模块是在每次请求时调用的，所以，您可以将请求统计信息和日志记录信息收集到一个集中的模块中，而不是收集到各页中。
 *  自定义的页眉或页脚。因为您可以修改出站响应，所以可以在每一个页面或 XML Web services 响应中注入内容，如自定义的标头信息。

ASP.NET 使用模块来实现各个应用程序功能，包括 Forms 身份验证、缓存、会话状态和客户端脚本服务。在每种情况下，如果这些服务处于启用状态，模块会作为请求的一部分调用，并执行在任何单一页请求范围之外的任务。模块可以使用应用程序事件，可能会引发可在 Global.asax 文件中处理的事件。有关应用程序事件的更多信息，请参见 [ASP.NET 应用程序生命周期概述][ASP.NET]。

<table> 
 <tbody> 
  <tr> 
   <th align="left"><img alt="Note" src="http://msdn2.microsoft.com/zh-cn/library/ms178468.note%28zh-cn,VS.80%29.gif">注意 </th> 
  </tr> 
  <tr> 
   <td> <p>HTTP 模块不同于 HTTP 处理程序。对于所有的请求和响应都可调用 HTTP 模块，而 HTTP 处理程序仅在响应特定的请求时才运行。有关更多信息，请参见 <a href="http://msdn2.microsoft.com/zh-cn/library/ms227675%28VS.80%29.aspx" rel="nofollow">HTTP 处理程序介绍</a>。</p> </td> 
  </tr> 
 </tbody> 
</table>

# HTTP 模块的工作方式 #

在应用程序的 Web.config 文件中注册自定义的 HTTP 模块。当 ASP.NET 创建表示您的应用程序的 [HttpApplication][] 类的实例时，将创建已注册的任何模块的实例。在创建模块时，将调用它的 [Init][] 方法，并且模块会自行初始化。有关更多信息，请参见 [ASP.NET 应用程序生命周期概述][ASP.NET]。

在模块的 **Init** 方法内，可以订阅各种应用程序事件（如 [BeginRequest][] 或 [EndRequest][]），这可以通过将事件绑定到模块中已创建的方法来完成。当这些事件被引发时，会调用模块中适当的方法，并且模块可以执行所需的任何逻辑，如身份验证检查或记录请求信息。在事件处理过程中，模块能够访问当前请求的 [Context][] 属性。这使您可以将请求重定向到其他页、修改请求或者执行任何其他请求操作。例如，如果您的模块中包括身份验证检查，则模块可能会检查凭据，如果凭据不正确的话，会重定向到登录页或错误页。否则，当模块的事件处理程序完成运行时，ASP.NET 会调用管线中的下一个进程，这可能是另一个模块，也可能是用于该请求的 HTTP 处理程序（如 .aspx 文件）。

# HTTP 模块与 Global.asax 文件 #

可以在应用程序的 Global.asax 文件中实现模块的许多功能，这使您可以响应应用程序事件。但是，模块相对于 Global.asax 文件具有如下优点：模块可以进行封装，因此可以在创建一次后在许多不同的应用程序中使用。通过将它们添加到全局程序集缓存 (GAC) 并将它们注册到 Machine.config 文件中，可以跨应用程序重新使用它们。有关更多信息，请参见[全局程序集缓存][Link 1]。

但是，使用 Global.asax 文件有一个好处，那就是您可以将代码放在其他已注册的模块事件（如 **Session\_Start** 和 **Session\_End** 方法）中。此外，Global.asax 文件还允许您实例化可在整个应用程序中使用的全局对象。

当您需要创建依赖应用程序事件的代码并且希望在其他应用程序中重用模块时，或者不希望将复杂代码放在 Global.asax 文件中时，应当使用模块。当您需要创建依赖应用程序事件的代码但不需要跨应用程序重用它时，或者需要订阅不可用于模块的事件（如 **Session\_Start**）时，应当将代码放在 Global.asax 文件中。

# 创建 HTTP 模块 #

可以通过以下方法来创建自定义的 HTTP 模块：创建一个实现 [IHttpModule][] 接口的类，然后在 Web.config 文件中注册该类。编写 HTTP 模块的一般过程为：

*  创建一个实现 **IHttpModule**[frlrfSystemWebIHttpModuleClassTopic][IHttpModule] 接口的类。
 *  为 **Init**[frlrfSystemWebIHttpModuleClassInitTopic][Init] 方法编写一个处理程序。init 方法应该初始化模块并订阅所需的任何应用程序事件。例如，如果您希望向响应中追加内容，则可以订阅 **EndRequest** 事件，或者如果您希望执行自定义的身份验证逻辑，则可以订阅 [AuthenticateRequest][] 事件。有关应用程序事件的更多信息，请参见 [ASP.NET 应用程序生命周期概述][ASP.NET]。
 *  为已经订阅的事件编写代码。
 *  如果模块需要清理，还可选择实现 [Dispose][] 方法。
 *  在 Web.config 文件中注册模块。

有关更多信息，请参见[如何：创建自定义 HTTP 模块][HTTP]。

# 请参见 #

#### 任务 ####

[如何：创建自定义 HTTP 模块][HTTP]

#### 概念 ####

[ASP.NET 应用程序生命周期概述][ASP.NET]

[ASP.NET]: http://msdn2.microsoft.com/zh-cn/library/ms178473%28VS.80%29.aspx
[HttpApplication]: http://msdn2.microsoft.com/zh-cn/library/4wt3wttw%28VS.80%29.aspx
[Init]: http://msdn2.microsoft.com/zh-cn/library/4fxtd0dz%28VS.80%29.aspx
[BeginRequest]: http://msdn2.microsoft.com/zh-cn/library/49wht4s0%28VS.80%29.aspx
[EndRequest]: http://msdn2.microsoft.com/zh-cn/library/sw4a4825%28VS.80%29.aspx
[Context]: http://msdn2.microsoft.com/zh-cn/library/1cwkw1ff%28VS.80%29.aspx
[Link 1]: http://msdn2.microsoft.com/zh-cn/library/yf1d93sz%28VS.80%29.aspx
[IHttpModule]: http://msdn2.microsoft.com/zh-cn/library/wc2zw2d4%28VS.80%29.aspx
[AuthenticateRequest]: http://msdn2.microsoft.com/zh-cn/library/k1at8z62%28VS.80%29.aspx
[Dispose]: http://msdn2.microsoft.com/zh-cn/library/wx5ahb15%28VS.80%29.aspx
[HTTP]: http://msdn2.microsoft.com/zh-cn/library/ms227673%28VS.80%29.aspx