asp.net
ASP.NET Framework深度历险(2)
Author:uestc95
ArticleType:原创
E-mail:uestc95@263.net
.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.
(待续,欢迎探讨:uestc95@263.net)