IHttpModule 接口

	名称	说明
	Dispose	Disposes of the resources (other than memory) used by the module that implements IHttpModule.
	Init	Initializes a module and prepares it to handle requests.

IHttpModule接口只有两个方法。

void Init(HttpApplication app);

void Dispose();

Init方法接受一个服务该请求的HttpApplication对象的引用。使用该引用可以连接到系统事件。HttpApplication对象也有一个称为Context的对象，该对象提供对ASP.NET应用程序的内在属性的引用。这样，我们就可以访问Response, Request, Session等。

表2.5列出了HTTP模块监听和处理的事件。

表2.5 HttpApplication事件

事件	描述
AcquireRequestState, PostAcquireRequestState	当实际服务请求的处理程序获得与该请求关联的状态信息时发生。ASP.NET 1.x不支持PostAcquireRequestState事件
AuthenticateRequest, PostAuthenticateRequest	当一个安全模块已经建立用户的身份时发生。ASP.NET 1.x不支持PostAuthenticateRequest事件
AuthorizeRequest, PostAuthorizeRequest	当一个安全模块已经验证用户授权时发生。ASP.NET 1.x不支持PostAuthorizeRequest事件
BeginRequest	HTTP管道一开始处理请求就发出该事件
Disposed	由于调用了Dispose，HttpApplication对象被处置时发出该事件。
EndRequest	作为HTTP管道执行链的最后一个事件发出
Error	抛出一个未处理的异常时发生
PostMapRequestHandler	当服务请求的HTTP处理程序被找到时发出。ASP.NET 1.x不支持该事件
PostRequestHandlerExecute	当所选的HTTP处理程序完成执行时发出该事件。这时已经生成响应文本
PreRequestHandlerExecute	正好在所选的HTTP处理程序开始工作前发出该事件
PreSendRequestContent	正好在ASP.NET运行库把响应文本发送给客户之前发出该事件
PreSendRequestHeaders	正好在ASP.NET运行库把HTTP头发送给客户之前发出该事件
ReleaseRequestState, PostReleaseRequestState	当处理程序释放与当前请求关联的状态信息时发生。ASP.NET 1.x不支持PostReleaseRequestState事件
ResolveRequestCache, PostResolveRequestCache	当ASP.NET运行库通过输出缓存解决该请求时发生。ASP.NET 1.x不支持PostResolveRequestCache事件
UpdateRequestCache, PostUpdateRequestCache	当ASP.NET运行库将当前请求的响应存储在输出缓存(用来服务随后的请求)中时发生。ASP.NET 1.x不支持PostUpdateRequestCache事件

所有这些事件由HttpApplication对象提供的，而HTTP模块作为Init方法的一个参数接受该对象。
下面来实现这个接口：

public class MarkerModule : IHttpModule
{

    public void Init(HttpApplication app)
    {
      // Register for pipeline events
    }

    public void Dispose()
    {
      // Nothing to do here
    }

}

HttpApplication类调用Init方法来装载该模块。在Init方法中，通常只需注册自己的事件处理程序。Dispose方法多半是空的。HTTP模块的核心实际上就是自定义的事件处理程序。

1. 绑定事件

Marker示例模块注册两个管道事件，它们是BeginRequest和EndRequest。BeginRequest是开始处理请求时第一个命中HTTP应用程序对象的事件；EndRequest是表明即将处理完请求，这是实施干预的最后机会的事件。通过处理这两个事件，可以在常规的HTTP处理程序(派生于Page的类)之前和之后，将自定义的文本写入输出流中。

如下清单展示了示例模块的Init和Dispose方法的过程实现：

public void Init(HttpApplication app)
{
    // Register for pipeline events
    app.BeginRequest += new EventHandler(OnBeginRequest);
    app.EndRequest += new EventHandler(OnEndRequest);

}
public void Dispose()
{

}

BeginRequest和EndRequest事件处理程序结构类似。它们从发送方获得对当前HttpApplication对象的引用，并从该引用那里获得HTTP上下文。接着，它们使用Reponse对象追加文本或自定义标题。

public void OnBeginRequest(object sender, EventArgs e)
{

    HttpApplication app = (HttpApplication) sender;
    HttpContext ctx = app.Context;
    // More code here
    // PageHeaderText is a constant string defined elsewhere
    ctx.Response.AppendHeader("Author", "DinoE");
    ctx.Response.Write(PageHeaderText);

}

public void OnEndRequest(object sender, EventArgs e)
{

    // Get access to the HTTP context
    HttpApplication app = (HttpApplication) sender;
    HttpContext ctx = app.Context;
    // More code here
    // Append some custom text
    // PageFooterText is a constant string defined elsewhere
    ctx.Response.Write(PageFooterText);

}

OnBeginRequest写入标准的页面标题文本并添加一个自定义的HTTP头。OnEndRequest只是追加页面的页脚。该HTTP模块的效果如图2.7所示。

图2.7 Marker HTTP模块将一个标题和页脚添加到应用程序内的每个页面

注意图中的工具，即IEWatch 2.0，是Microsoft Internet Explorer的一个插件程序，该工具可以分析HTTP/HTTPS请求和HTML源代码。我们可以从http://www.iewatch.com获取它。

Internet Explorer底部的可停靠窗口，展示了浏览器正在发送和接收的所有HTTP头。显然，响应文本中的自定义的标题是可见的。

2. 用配置文件注册该模块

通过向配置文件的<httpModules>节添加一个配置项，可以注册一个新的HTTP模块。<httpModules>配置节的语法类似于HTTP处理程序的语法。使用<add>节点，并规定name和type属性可以添加一个新的模块。name属性包含该模块的公开名称。该名称将被用来选择HttpApplication的Modules集合中的模块。如果该模块激发自定义事件，则该名称还可以在global.asax文件中用作构建自动的事件处理程序的前缀。

<system.web>

<add name="Marker"

type="ProAspNet20.CS.Components.MarkerModule,ProAspCompLib" />

</httpModules>

</system.web>

type属性使用常见的逗号隔离字符串，它可设置类及其相关程序集的名称。这些配置设置既可以存储在应用程序配置文件中，也可以存储在机器配置文件中。在前一种情况中，只有应用程序的页面受影响；而在后一种情况下，所有应用程序中的所有页面都将由指定的模块进行处理。

这些模块的应用顺序取决于其在配置列表中的物理顺序。可以删掉一个系统模块，并用我们自己的具有类似功能的模块替换它。在这种情况下，在应用程序的web.config文件中，使用<remove>节点删去默认模块，然后使用<add>插入自己的模块。如果需要完全重新定义HTTP模块的应用顺序，可以使用<clear>节点清除所有的默认模块，然后按自己喜欢的顺序重新注册它们。

3. 访问其他HTTP模块

刚刚讨论的示例说明了如何绑定管道事件——即，HttpApplication对象激发的事件。但是其他模块激发的事件是什么呢？HttpApplication对象提供了一个名为Modules的属性，它获得当前应用程序模块的集合。

Modules属性的类型为HttpModuleCollection，其中包括应用程序模块的名称。该集合类继承自NameObjectCollectionBase抽象类，这是一个由字符串和对象组成的组合对的集合。字符串指示模块的公开名称，对象是该模块的真实实例。要访问处理会话状态的模块，需要如下编码：

SessionStateModule sess = app.Modules["Session"];

sess.Start += new EventHandler(OnSessionStart);

如前所述，还可以在global.asax文件中处理HTTP模块引起的事件，并使用ModuleName_EventName规则来命名事件处理程序。模块名称只是在注册一个HTTP模块时需要定义的设置之一。