ASP.NET Framework深度历险(2)

.NET Framework Version:1.0.3705正式版
VS.NET（C#） Version:7.0.9466正式版


    刚刚吃完晚饭，正好在键盘上面锻炼一下手指。
    接着上回继续写这个“日记”：
   
    Chapter Two -- HttpModule是如何工作的？

    我们上回说到，一个来自于客户端的Http Request被截获后经过层层转交（怎么都在踢皮球？呵呵）到达了HttpModule这个“请求监听器”。
HttpModule就类似于安插在ASPNET_WP.EXE进程中的一个听器，稍微有些常识的人都会很自然的想象得到切听器是用来做什么的，而我们的HttpModule
可以说是作切听器的绝好人选了，但是需要明确的是，HttpModule绝对不是简单的监听器，它可以做到更多的东西，比如它可以对截获的请求增加一些内容
等等。
     另外需要明白的是，当一个Http Request到达HttpModule的时候，整个ASP.NET Framework系统还并没有对这个请求做任何的真正处理，但是我们可以
在这个Http Request传递到真正的请求处理中心（HttpHandler）之前附加一些我们需要的信息在这个Http Request至上，或者针对我们截获的这个Http
Request信息作一些额外的工作，或者在某些情况下干脆终止满足一些条件的Http Request，从而可以起到一个Filter过滤器的作用，而不仅仅是一个窃切听器了。
     通过查阅MSDN（不要去相信.NET SDK自带的那个QuickStarts Web文档，正式版本中竟然在很多地方没有更新这个文档，很多东西在正式版本是无效的），
你会发现系统HttpModule实现了一个叫做IHttpModule的接口，很自然的就应当想到，只要我们自己的类能够实现IHttpModule接口，不就可以完全替代系统的
HttpModule了吗？完全正确。
     在我们开始自己的HttpModule类之前，我先来告诉你系统中的那个HttpModule是什么样子的，ASP.NET系统中默认的HttpModule有以下几个：
            System.Web.Caching.OutputCacheModule
            System.Web.SessionState.SessionStateModule
            System.Web.Security.WindowsAuthenticationModule
            System.Web.Security.FormsAuthenticationModule
            System.Web.Security.PassportAuthenticationModule
            System.Web.Security.UrlAuthorizationModule
            System.Web.Security.FileAuthorizationModule
     
     好了，我们来开始我们自己的HttpModule构建历程吧。
     1）打开VS.NET新建一个“Class Library”项目，将它命名为MyHttpModule。
     2）引用System.Web.dll文件

     在代码区域敲入：

using System;
using System.Web;

namespace MyHttpModuleTest
{
    /// <summary>
    /// 说明：用来实现自定义HttpModule的类
    /// 作者：uestc95
    /// 联系：uestc95@263.net
    /// </summary>
    public class MyHttpModule:IHttpModule
    {
        /// <summary>
        /// 说明：构造器方法
        /// 作者：uestc95
        /// 联系：uestc95@263.net
        /// </summary>
        public MyHttpModule()
        {
            
        }

        /// <summary>
        /// 说明：实现IHttpModule接口的Init方法
        /// 作者：uestc95
        /// 联系：uestc95@263.net
        /// </summary>
        /// <param name="application">HttpApplication类型的参数</param>
        public void Init(HttpApplication application)
        {
            application.BeginRequest +=new EventHandler(this.Application_BeginRequest);
            application.EndRequest +=new EventHandler(this.Application_EndRequest);
        }

        /// <summary>
        /// 说明：自己定义的用来做点事情的私有方法
        /// 作者：uestc95
        /// 联系：uestc95@263.net
        /// </summary>
        /// <param name="obj">传递进来的对象参数</param>
        /// <param name="e">事件参数</param>
        private void Application_BeginRequest(Object obj,EventArgs e)
        {
            HttpApplication application=(HttpApplication)obj;
            HttpContext context=application.Context;
            HttpResponse response=context.Response;
            HttpRequest request=context.Request;

            response.Write("我来自Application_BeginRequest,:)");
            
        }

        /// <summary>
        /// 说明：自己定义的用来做点事情的私有方法
        /// 作者：uestc95
        /// 联系：uestc95@263.net
        /// </summary>
        /// <param name="obj">传递进来的对象参数</param>
        /// <param name="e">事件参数</param>
        private void Application_EndRequest(Object obj,EventArgs e)
        {
            HttpApplication application=(HttpApplication)obj;
            HttpContext context=application.Context;
            HttpResponse response=context.Response;
            HttpRequest request=context.Request;

            response.Write("我来自Application_EndRequest,:)");
            
        }

        /// <summary>
        /// 说明：实现IHttpModule接口的Dispose方法
        /// 作者：uestc95
        /// 联系：uestc95@263.net
        /// </summary>
        public void Dispose(){}
    }
}

     3）在VS.NET中编译之后，你会得到MyHttpModule.dll这个文件。
     4）接下来我们的工作就是如何让ASPNET_WP.exe进程将http request交给我们自己写的这个HttpModule呢？方法就是配置web.config文件。
     在web.config文件中增加如下几句话：
        <httpModules>
            <add name="test" type="MyHttpModuleTest.MyHttpModule,MyHttpModule"/>
        </httpModules>
      注意要区分大小写，因为web.config作为一个XML文件是大小写敏感的。“type=MyHttpModuleTest.MyHttpModule,MyHttpModule”告诉我们
      系统将会将http request请求交给位于MyHttpModule.dll文件中的MyHttpModuleTest.MyHttpModule类去处理。而这个DLL文件系统将会自动
      到bin子目录或者系统全局程序集缓冲区（GAC）搜寻。我们可以将我们刚才得到的DLL文件放在bin子目录中，至于后者，你可以通过.NET SDK正式版
      自带的Config工具做到，我们不详细说了。


      好了，我们的用来截获http request请求的HttpModule就完成并且装配完成了，你可以试着在你的web项目中建立一个新的WebForm，运行看看呢？：）
      最后，我们假设一个使用这个HttpModule的场合。A站点提供免费的ASP.NET虚拟空间给大家，但是A站点的管理者并不想提供免费的午餐，他想要在每一个
      页面被浏览的时候自动弹出自己公司的广告（就像现在的www.X63.com一样），我总不能时刻监视所有用户的所有页面吧，并且想要在每一个页面手动添加
      一段JS代码，工作量是不可想象的，也是不现实的。那末好了，只要我们的HttpModule一旦被挂接完成，这一切都将是轻而易举的事情了，只要我们在每一个
      Http Request被我们捕获的时候，给他增加上一些JS就好了！

      我们上面提到在Init()方法中使用了两个事件BeginRequest和EndRequest，这两个事件分别是Init()中可以处理的所有事件的最开始事件和最终事件，在他们
      中间还有一些其它的事件可以被我们利用，可以查阅MSDN。

      另外在我关闭EditPlus之前，需要敲下如下的话：
      在HttpModule中可以正常使用Response,Request,Server,Application，但是不能操作任何与Session有关代码！
      为什么呢？自己考虑一下吧，下回看看原因在哪里，另外再给出一个问题，你能发现系统默认的那几个HttpModule在哪里配置的呢？找找看。
      
      下回我们看看HttpHandler部分以及如何同HttpModule相配合的东东。

      See you later.