第三回:引言
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對象暴露給用戶端的事件。可見,這個方法僅僅是用來對事件進行註冊,而實際的事件處理常式,需要我們另外寫方法。
整個過程很好理解:
- 當網站第一個資源被訪問的時候,Asp.Net會建立HttpApplication類的執行個體,它代表著網站應用程式,同時會建立所有在Web.Config中註冊過的Module執行個體。
- 在建立Module執行個體的時候會調用Module的Init()方法。
- 在Init()方法內,對想要作出響應的HttpApplication暴露出的事件進行註冊。(僅僅進行方法的簡單註冊,實際的方法需要另寫)。
- HttpApplication在其應用程式周期中觸發各類事件。
- 觸發事件的時候調用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請求的輸入資料流中分別寫入不同的內容。
來源:(http://blog.sina.com.cn/s/blog_4a5e32770100hl03.html) - ASP.NET頁面與IIS底層互動和工作原理詳解 (二)_YouthWithYouth_新浪部落格
接下來在 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暴露出的事件。在具體介紹之前,這裡需要首先注意兩點:
- 在每處理一個Http請求時,應用程式事件都會觸發一遍,但是Application_Start和 Application_End 例外,它僅在第一個資源檔被訪問時被觸發。
- 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/category/101697.html
來源:(http://blog.sina.com.cn/s/blog_4a5e32770100hl03.html) - ASP.NET頁面與IIS底層互動和工作原理詳解 (二)_YouthWithYouth_新浪部落格