Asp.Net 构架(HttpModule 介绍) - Part.3

引言

Http 请求处理流程 和 Http Handler 介绍 这两篇文章里，咱们首先了解了Http请求在服务器端的处理流程，随后咱们知道Http请求最终会由实现了IHttpHandler接口的类进行处理(应该记得Page类实现了IHttpHandler)。从 Http 请求处理流程 一文的最后的一幅图中能够看到，在Http请求由IHttpHandler处理以前，它须要经过一系列的Http Module；在请求处理以后，它须要再次经过一系列的Http Module，那么这些Http Module是如何组成的？用来作什么呢？本文将对Http Module做以介绍。

Http Module概述

暂时先不考虑咱们本身实现Http Module的状况。在.Net中，Http Module 是实现了IHttpModule接口的程序集。IHttpModule 接口自己并无什么好大写特写的，由它的名字能够看出，它不过是一个普普统统的接口而已。实际上，咱们关心的是实现了这些接口的类，若是咱们也编写代码实现了这个接口，那么有什么用途。通常来讲，咱们能够将Asp.Net中的事件分红三个级别，最顶层是 应用程序级事件、其次是页面级事件、最下面是控件级事件，事件的触发分别与 应用程序周期、页面周期、控件周期紧密相关。而 Http Module 的做用是与应用程序事件 密切相关的。

咱们经过Http Module在Http请求管道(Pipeline)中注册指望对应用程序事件作出反应的方法，在相应的事件触发的时候(好比说BeginRequest事件，它在应用程序收到一个Http请求并即将对其进行处理时触发)，便会调用Http Module注册了的方法，实际的工做在这些方法中执行。.Net 自己已经有不少的Http Module，其中包括 表单验证Module(FormsAuthenticationModule)， Session 状态Module(SessionStateModule)，输出缓存Module (OutputCacheModule)等。

注册 Http Module

在注册咱们本身编写的 Http Module 以前，先来看看Asp.Net中已经有的HttpModule。与 Http Handler相似，咱们须要打开机器上C:\WINDOWS\Microsoft.NET\Framework\ v2.0.50727\CONFIG 目录下的 web.config 文件。找到 <httpModules/> 结点，应该能够看到下面的内容：

<httpModules>
    <add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />
    <add name="Session" type="System.Web.SessionState.SessionStateModule" />
    <add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />
    <add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
    <add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
    <add name="RoleManager" type="System.Web.Security.RoleManagerModule" />
    <add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />
... 略
</httpModules>

咱们先从结点上看，type属性与上一节所说的http handler结点的type属性相似，都表明了相应的程序集。可是，与http handler 不一样，module只提供了一个name属性，没有诸如 path这样指定某一特定(或者用通配符 * 表明某一种类)文件的处理程序。这是与Module的特色相关的，咱们知道 module 是响应应用程序周期中触发的事件，对于全部提交到aspnet_isapi.dll的请求都同样，即使请求只是像相似http://www.tracefact.net/images/logo.gif 这样获取一张图片而已(对ISAPI进行过设置之后，默认aspnet_isapi.dll不接手图片文件)。

与Http handler相似，在这册咱们本身的http module 时，假设类名为ModuleDemo，位于myNameSpace命名空间下，程序集名称为myDll，咱们只需将myDll.dll拷贝到Bin目录下，并在站点的 web.config 文件 system.web 结点下建立 httpModules 结点：

<system.web>
    <httpModules>
       <add name="CustomModuleName" type="myNameSpace.ModuleDemo, myDll"/>
    </httpModules>
</system.web>

type属性由分号“,”分为两部分，前面是命名空间及类名，也就是类型名；后面是程序集名。若是咱们将代码建立在App_Code目录中，则不须要再指定程序集名。

name属性由咱们本身命名，不必定与类名相同，此处我将它命名为“CustomModuleName”。咱们能够经过应用程序(HttpApplication)的Modules属性获取HttpModuleCollection集合，而后经过name属性，进一步获取HttpModule对象。

经过name属性，咱们还能够在global.asax中文件中编写自定义HttpModule暴露出的事件的处理程序，它采用的格式是：void ModuleName_EventName(object sender, EventArgs e)。咱们将在后面作更详细介绍。

Asp.Net 内置的 Http Modules

下面这张表格列出了C:\WINDOWS\Microsoft.NET\Framework\ v2.0.50727\CONFIG下的Web.Config中的 Asp.Net 内置的Http Modules 及其主要做用。

名称	类型	功能
OutputCache	System.Web.Caching.OutputCacheModule	页面级输出缓存
Session	System.Web.SessionState.SessionStateModule	Session状态管理
WindowsAuthentication	System.Web.Security.WindowsAuthenticationModule	用集成Windows身份验证进行客户端验证
FormsAuthentication	System.Web.Security.FormsAuthenticationModule	用基于Cookie的窗体身份验证进行客户端身份验证
PassportAuthentication	System.Web.Security.PassportAuthenticationModule	用MS护照进行客户身份验证
RoleManager	System.Web.Security.RoleManagerModule	管理当前用户角色
UrlAuthorization	System.Web.Security.UrlAuthorizationModule	判断用户是否被受权访问某一URL
FileAuthorization	System.Web.Security.FileAuthorizationModule	判断用户是否被受权访问某一资源
AnonymousIdentification	System.Web.Security.AnonymousIdentificationModule	管理Asp.Net应用程序中的匿名访问
Profile	System.Web.Profile.ProfileModule	管理用户档案文件的创立 及相关事件
ErrorHandlerModule	System.Web.Mobile.ErrorHandlerModule	捕捉异常，格式化错误提示字符，传递给客户端程序

咱们将在后面用编程的方式来查看它。

IHttpModule接口

看了这么多理论知识，本节将开始动手写点程序，实现本身的Http Module。咱们首先须要看下IHttpModule 接口，它包括下面两个方法：

public void Init(HttpApplication context);
public void Dispose();

Init()：这个方法接受一个HttpApplication对象，HttpApplication表明了当前的应用程序，咱们须要在这个方法内注册 HttpApplication对象暴露给客户端的事件。可见，这个方法仅仅是用来对事件进行注册，而实际的事件处理程序，须要咱们另外写方法。

整个过程很好理解：

1. 当站点第一个资源被访问的时候，Asp.Net会建立HttpApplication类的实例，它表明着站点应用程序，同时会建立全部在Web.Config中注册过的Module实例。
2. 在建立Module实例的时候会调用Module的Init()方法。
3. 在Init()方法内，对想要做出响应的HttpApplication暴露出的事件进行注册。(仅仅进行方法的简单注册，实际的方法须要另写)。
4. HttpApplication在其应用程序周期中触发各种事件。
5. 触发事件的时候调用Module在其Init()方法中注册过的方法。

NOTE：若是你不了解事件注册等相关内容，请参阅 C#中的委托与事件 一文。

Dispose()：它能够在进行垃圾回收以前进行一些清理工做。

综上所述：实现一个 IHttpModule 的模板通常是这样的：

public class ModuleDemo:IHttpModule
{
    public void Init(HttpApplication context) {
       // 注册HttpApplication应用程序 BeginRequest 事件
       // 也能够是其余任何HttpApplication暴露出的事件
       context.BeginRequest += new EventHandler(context_BeginRequest);
    }

    void context_BeginRequest(object sender, EventArgs e) {
       HttpApplication application = (HttpApplication)sender;
       HttpContext context = application.Context;
       // 作些实际的工做，HttpContext对象都得到了，剩下的基本能够自由发挥了
    }

    public void Dispose() {
    }
}

经过Http Module向Http请求输出流中写入文字

本例中，咱们仅用BeginRequest事件和 EndRequest 事件对 Http Module 的使用做以说明。咱们经过这个范例，了解 Http Module 基本的使用方法。

首先，请建立一个新的站点，在App_Code目录中添加类文件： ModuleDemo.cs：

public class ModuleDemo:IHttpModule
{
    // Init方法仅用于给指望的事件注册方法
    public void Init(HttpApplication context) {
       context.BeginRequest += new EventHandler(context_BeginRequest);
       context.EndRequest += new EventHandler(context_EndRequest);
    }

    // 处理BeginRequest 事件的实际代码
    void context_BeginRequest(object sender, EventArgs e) {
       HttpApplication application = (HttpApplication)sender;
       HttpContext context = application.Context;
       context.Response.Write("<h1 style='color:#00f'>来自HttpModule 的处理，请求到达</h1><hr>");
    }

    // 处理EndRequest 事件的实际代码
    void context_EndRequest(object sender, EventArgs e) {
       HttpApplication application = (HttpApplication)sender;
       HttpContext context = application.Context;
       context.Response.Write("<hr><h1 style='color:#f00'>来自HttpModule的处理，请求结束</h1>"); 
    }
       
    public void Dispose() {
    }
}

上面的代码很简单，它注册了 HttpApplication实例的 BeginRequest 事件 和 EndRequest事件，事件处理方法的做用仅仅是在http请求开始和结束的时候，给http请求的输入流中分别写入不一样的内容。

接下来在 Web.config 的 System.web 结点中写入如下内容：

<system.web>
    <httpModules>
       <add name="MyModule" type="ModuleDemo" />
    </httpModules>
</system.web>

而后，打开创建站点时自动建立的 Default.aspx文件，在里面打几个字，为了作区分，我输入的是：位于.aspx页面上的文字。而后，咱们在浏览器中打开它，应该会看到像这样：

而后咱们再新建一个 Default2.aspx，在浏览器中浏览，能够看到，两个页面的效果相同。这说明对于不一样的两个文件，http Module都起了做用，可见它确实是位于应用程序级，而非页面级。

如今，咱们再打开站点中的一张图片文件，发现显示出的是一个红叉叉，为什呢？由于Http Module 针对是http 请求，而不是某个或某一类文件，因此当请求一张图片的时候，咱们编写的http Module依然会起做用，将文字插入到二进制图片中，破坏了文件格式，天然只能显示红叉叉了。

NOTE：若是你发现你的图片显示正常，请不要惊讶，事情是这样的：回想一下第一节咱们讨论到的，对于图片文件，由IIS直接处理，并不会交由aspnet_isapi.dll，因此，Module没法捕获对于图片类型文件的请求。解决方法就是在IIS中进行设置一下。
    这里须要提请注意的是：若是你使用Vs2005自带的Local Server，那么你无需对IIS进行设置，全部的不论图片仍是任何文件类型，都会交由aspnet_isapi.dll处理。

遍历Http Module集合

如今，咱们经过遍历 HttpModuleCollection 集合来查看注册给应用程序的全部 Http Module 的名称。

新建一个文件 RegisteredModules.aspx，在代码后置文件中添加以下方法：

private string ShowModules() {
    HttpApplication app = Context.ApplicationInstance; //获取当前上下文的HttpApplication环境
    HttpModuleCollection moduleCollection = app.Modules; //获取全部Module集合

    // 获取全部的 Module 名称
    string[] moduleNames = moduleCollection.AllKeys;

    System.Text.StringBuilder results = new System.Text.StringBuilder();    //遍历结果集

    foreach (string name in moduleNames) {
       // 得到Module名称
       results.Append("<b style='color:#800800'>名称：" + name + "</b><br />");
        // 得到Module类型
       results.Append("类型：" + moduleCollection[name].ToString() + "<br />"); 
    }

    return results.ToString();
}

而后在Page_Load方法中输出一下：

protected void Page_Load(object sender, EventArgs e)
{
    Response.Write(ShowModules());
}

咱们应该能够看到下面这样的画面：

与以前列出的那张表格比较一下，能够看出是几乎彻底一致的(多了一个DefaultAuthentication)。另外注意上图的倒数第四行，那不是咱们本身定义的Module么？name为MyModule，类型为ModuleDemo。

Global.asax文件与 Http Module

早在asp时代，你们就知道这个文件了。它主要用于放置对于 应用程序事件或者 Session事件的响应程序。你们熟悉的有Application_Start、Application_End、Session_Start、Session_End 等。

在asp.net中，Glabal不只能够注册应用程序和Session事件，还能够注册Http Module暴露出的事件；不只能够注册系统Module的事件，也能够注册咱们本身义的Module暴露出的事件。在具体介绍以前，这里须要首先注意两点：

1. 在每处理一个Http请求时，应用程序事件都会触发一遍，可是Application_Start和 Application_End 例外，它仅在第一个资源文件被访问时被触发。
2. Http Module没法注册和响应Session事件，对于Session_Start 和 Session_End，只能经过Glabal.asax来处理。

好了，咱们如今修改以前 ModuleDemo 范例程序，给它像下面这样给它添加一个事件(为了使程序简洁一些，我作了简化)：

public class ModuleDemo : IHttpModule {

    // 声明一个事件
    public event EventHandler ExposedEvent;

    // Init方法仅用于给指望的事件注册方法
    public void Init(HttpApplication context) {
       context.BeginRequest += new EventHandler(context_BeginRequest);
    }

    // 处理BeginRequest 事件的实际代码
    void context_BeginRequest(object sender, EventArgs e) {
       HttpApplication application = (HttpApplication)sender;
       HttpContext context = application.Context;
       context.Response.Write("<h3 style='color:#00f'>来自HttpModule的处理，请求到达</h3><hr>");
       
       OnExposedEvent(new EventArgs()); // 调用方法
    }

    protected override void OnExposedEvent(EventArgs e) {
       if (ExposedEvent != null) // 若是Global中有注册
           ExposedEvent(this, e);   // 调用注册了的方法
    }
    
    public void Dispose() {
    }
}

接下来，咱们在站点中建立一个 Global.asax 文件，在里面添加以下代码，注意到格式是：void 模块名_事件名(object sender, EventArgs e)。

void MyModule_ExposedEvent(object sender, EventArgs e)
{
     Response.Write("<h3 style='color:#800800'>来自 Global.asax 的文字</h2>");
}

如今，咱们打开以前的页面，应该能够见到这样，可见，咱们成功的将 Glabal.asax文件与咱们本身定义的Http Module所暴露出的事件 ExposedEvent 联系到了一块儿：

总结

本文简单地介绍了什么是Http Module。咱们首先了解了Http Module的做用，而后查看了Asp.Net 内置的Module，接着咱们介绍了IHttpModule接口，并经过了一个简单的范例实现了此接口，最后咱们讨论了 Http Module与 Global.asax 文件的联系。

本文仅仅是对IHttpModule做以简单介绍，对其更多的实际应用，会在后续文章中补充。

但愿这篇文章能给你带来帮助！

本文的源代码下载：http://www.tracefact.net/sourcecode/Introduction-to-HttpModule.rar

 

出处：http://www.cnblogs.com/JimmyZhang/archive/2007/11/25/971878.html