asp.net基础-HttpModule

HttpModule是向实现类提供模块初始化和处置事件。当一个HTTP请求到达HttpModule时，整个ASP.NET Framework系统还并没有对这个HTTP请求做任何处理，也就是说此时对于HTTP请求来讲，HttpModule是一个HTTP请求的“必经之路”，所以可以在这个HTTP请求传递到真正的请求处理中心（HttpHandler）之前附加一些需要的信息在这个HTTP请求信息之上，或者针对截获的这个HTTP请求信息作一些额外的工作，或者在某些情况下干脆终止满足一些条件的HTTP请求，从而可以起到一个Filter过滤器的作用。

1、asp.net的HTTP请求处理过程

（1）、客户端浏览器向服务器发出一个http请求，此请求会被inetinfo.exe进程截获，然后转交给aspnet_isapi.dll进程，接着它又通过Http Pipeline的管道，传送给aspnet_wp.exe这个进程，接下来就到了.net framework的HttpRunTime处理中心，处理完毕后就发送给用户浏览器。 
（2）、当一个http请求被送入到HttpRuntime之后，这个Http请求会继续被送入到一个被称之为HttpApplication Factory的一个容器当中，而这个容器会给出一个HttpApplication实例来处理传递进来的http请求，而后这个Http请求会依次进入到如下几个容器中：HttpModule --> HttpHandler Factory --> HttpHandler。当系统内部的HttpHandler的ProcessRequest方法处理完毕之后，整个Http Request就被处理完成了，客户端也就得到相应的东东了。 
（3）完整的http请求在asp.net framework中的处理流程： 
HttpRequest-->inetinfo.exe->ASPNET_ISAPI.DLL-->Http Pipeline-->ASPNET_WP.EXE-->HttpRuntime-->HttpApplication Factory-->HttpApplication-->HttpModule-->HttpHandler Factory-->HttpHandler-->HttpHandler.ProcessRequest() 

　　也就是说一个HTTP请求在HttpModule容器的传递过程中，会在某一时刻（ResolveRequestCache事件）将这个HTTP请求传递给HttpHandler容器。在这个事件之后，HttpModule容器会建立一个HttpHandler的入口实例，但是此时并没有将HTTP请求控制权交出，而是继续触发AcquireRequestState事件以及PreRequestHandlerExcute事件。在PreRequestHandlerExcute事件之后，HttpModule窗口就会将控制权暂时交给HttpHandler容器，以便进行真正的HTTP请求处理工作。

　　而在HttpHandler容器内部会执行ProcessRequest方法来处理HTTP请求。在容器HttpHandler处理完毕整个HTTP请求之后，会将控制权交还给HttpModule，HttpModule则会继续对处理完毕的HTTP请求信息流进行层层的转交动作，直到返回到客户端为止。

（4）如果想在中途截获一个httpRequest并做些自己的处理，就应该在HttpRuntime运行时内部来做到这一点，确切的说是在HttpModule这个容器中来实现。

 

2、HttpModule工作原理

     负责监听HttpRequest，同时对HttpRequest增添或者过滤掉一部分内容。也就是说，当一个HTTP请求到达HttpModule时，整个ASP.NET Framework系统还并没有对这个HTTP请求做任何处理，也就是说此时对于HTTP请求来讲，HttpModule是一个HTTP请求的“必经之路”，所以可以在这个HTTP请求传递到真正的请求处理中心（HttpHandler）之前附加一些需要的信息在这个HTTP请求信息之上，或者针对截获的这个HTTP请求信息作一些额外的工作，或者在某些情况下干脆终止满足一些条件的HTTP请求，从而可以起到一个Filter过滤器的作用。 
HttpModule实现了接口IHttpModule，我们可以自定义实现该接口的类，从而取代HttpModule。 

3、编写自己的HttpModule

　　要实现HttpModule，必须实现接口IHttpModule。下面是IHttpModule接口分析：

using System;

namespace System.Web

{

    public interface IHttpModule

    {

        //   销毁不再被HttpModule使用的资源

        void Dispose();

        // 初始化一个Module,为捕获HttpRequest做准备

        void Init(HttpApplication context);

    }

}

　　下面是自己的HttpModule：

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

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;



namespace Learning

{

    public class ModuleDemo : IHttpModule

    {

        // Init方法仅用于给期望的事件注册方法

        public void Init(HttpApplication context)

        {

            context.EndRequest += new EventHandler(context_EndRequest);

            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("<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()

        {

        }

    }

}

　　web.config

<configuration>

  <system.web>

    <compilation debug="true" targetFramework="4.0" />

    <httpModules>

      <add name="up" type="Learning.ModuleDemo,Learning"/>

    </httpModules>

  </system.web>



</configuration>

 

　　在这册我们自己的http module 时，假设类名为ModuleDemo，位于Learning命名空间下，程序集名称为Learning，我们只需将Learning拷贝到Bin目录下，并在站点的 web.config 文件 system.web 结点下创建 httpModules 结点：

运行结果：