wudi

博客园 首页 新随笔 联系 订阅 管理
.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.
posted on 2008-04-09 22:23  菜鸟吴迪  阅读(253)  评论(0编辑  收藏  举报