HttpModule与HttpHandler

关注

原创最新推荐文章于 2026-06-24 15:32:12 发布 1.5k 阅读 AI 写同款· GEO 优化 ›

ASP.NET中HttpHandler与HttpModule的本质区别与选型指南 HttpHandler和HttpModule是ASP.NET请求生命周期中的两个核心扩展机制，分别承担资源处理与横切干预职责。其设计根植于IIS请求管道的阶段化模型：HttpHandler作为请求的唯一终点执行器，专注生成响应内容；HttpModule则是全程监听的事件订阅者，用于日志、认证、压缩等通用逻辑。理解二者在执行时机、作用范围、状态共享及线程安全上的根本差异，是避免Session丢失、响应乱码、CPU飙升等线上故障的关键。本文结合IIS集成模式、ASP.NET生命周期、请求处理阶段等实战要素，为. 阅读详情

HttpModule的工作过程：

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

深入了解HttpModule

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

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

深入了解HttpModule

示例2：验证HttpModule生命周期

using System;

using System.Collections.Generic;

using System.Text;

using System.Web;

namespace MyHttpModule

{

public class ValidaterHttpModule : IHttpModule

{

#region IHttpModule 成员

public void Dispose()

{}

public void Init(HttpApplication application)

{

application.BeginRequest += new EventHandler(application_BeginRequest);

application.EndRequest += new EventHandler(application_EndRequest);

application.PreRequestHandlerExecute += new EventHandler(application_PreRequestHandlerExecute);

application.PostRequestHandlerExecute += new EventHandler(application_PostRequestHandlerExecute);

application.ReleaseRequestState += new EventHandler(application_ReleaseRequestState);

application.AcquireRequestState += new EventHandler(application_AcquireRequestState);

application.AuthenticateRequest += new EventHandler(application_AuthenticateRequest);

application.AuthorizeRequest += new EventHandler(application_AuthorizeRequest);

application.ResolveRequestCache += new EventHandler(application_ResolveRequestCache);

application.PreSendRequestHeaders += new EventHandler(application_PreSendRequestHeaders);

application.PreSendRequestContent += new EventHandler(application_PreSendRequestContent);

}

void application_PreSendRequestContent(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_PreSendRequestContent
");

}

void application_PreSendRequestHeaders(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_PreSendRequestHeaders
");

}

void application_ResolveRequestCache(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_ResolveRequestCache
");

}

void application_AuthorizeRequest(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_AuthorizeRequest
");

}

void application_AuthenticateRequest(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_AuthenticateRequest
");

}

void application_AcquireRequestState(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_AcquireRequestState
");

}

void application_ReleaseRequestState(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_ReleaseRequestState
");

}

void application_PostRequestHandlerExecute(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_PostRequestHandlerExecute
");

}

void application_PreRequestHandlerExecute(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_PreRequestHandlerExecute
");

}

void application_EndRequest(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_EndRequest
");

}

void application_BeginRequest(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.Context.Response.Write("application_BeginRequest
");

}

#endregion

}

多个自定义的Http Module的运作

从运行结果可以看到，在web.config文件中引入自定义HttpModule的顺序就决定了多个自定义HttpModule在处理一个HTTP请求的接管顺序。注：系统默认那几个HttpModule是最先衩ASP.NET Framework所加载上去的。

如果我们把上面的两个httpMudel都注册在web.config中，输出的结果是

我来自自定义HttpModule中的BeginRequest
application_BeginRequest
application_AuthenticateRequest
application_AuthorizeRequest
application_ResolveRequestCache
application_AcquireRequestState
application_PreRequestHandlerExecute

窗体顶端

窗体底端

application_PostRequestHandlerExecute
application_ReleaseRequestState
我来自自定义HttpModule中的EndRequest
application_EndRequest
application_PreSendRequestHeaders
application_PreSendRequestContent

我们可以发现不同的HttpMudel模块是并进执行的，相同的方法会在一起执行，

在HttpModule中终止此次的HTTP请求

可以利用HttpModule通过调用HttpApplication.CompleteRequest()方法实现当满足某一个条件时终止此次的HTTP请求。

需要注意的是，即使调用了HttpApplication.CompleteRequest()方法终止了一个HTTP请求，ASP.NET Framework仍然会触发HttpApplication后面的这3个事件：EndRequest事件、PreSendRequestHeaders事件、PreSendRequestContent事件。

如果存在多个自定义的HttpModule的话，当Module1终止了一个HTTP请求，这个HTTP请求将不会再触发Module2中相应的事件了，但Module2的最后三个事件仍会被触发。

void application_BeginRequest(object sender, EventArgs e)

{

HttpApplication application = (HttpApplication)sender;

application.CompleteRequest();

application.Context.Response.Write("application_BeginRequest
");

}

输出的结果：

我来自自定义HttpModule中的BeginRequest
application_BeginRequest
我来自自定义HttpModule中的EndRequest
application_EndRequest
application_PreSendRequestHeaders
application_PreSendRequestContent

所以我们可以通过httpMudel对所有的请求进行监听，对不符合的请求都可以做出相应的处理，从上面的图中我们也可以看出http请求的执行过程，最终都会交个httpHandler去处理，然后在通过httpMudel返回到客户端

同HttpHandler对应来看，这些事件，有些在HttpHandler之前发生，有些在HttpHandler处理完后发生。了解事件发生的顺序非常重要，因为，服务器端的对象在不同的时间段有着不同的表现。例子之一是Session的使用。不是所有的事件中都能对Session进行处理，而只能在有限的几个事件中进行处理。详细的过程可以参考下面的HTTP Request处理生命周期图。

上面的这个图又一次展示了它的用处，在平时的开发中，我们可以使用httpMudel开发权限管理系统，比如后台，不是每一个人都可以知道url就进入到系统中，要在登录的时候授权限才可以，我们这个时候就可以在httpMudel中去处理是否授权，其他的如过滤危险字符串，防止sql注入，在这里就不在一一介绍了，下面就来看看httpHandler类

概述

HttpHandler是一个HTTP请求的真正处理中心，也正是在这个HttpHandler容器中，ASP.NET Framework才真正地对客户端请求的服务器页面做出编译和执行，并将处理过后的信息附加在HTTP请求信息流中再次返回到HttpModule中。

IHttpHandler如何处理HTTP请求

当一个HTTP请求经同HttpModule容器传递到HttpHandler容器中时，ASP.NET Framework会调用HttpHandler的ProcessRequest成员方法来对这个HTTP请求进行真正的处理。以一个ASPX页面为例，正是在这里一个ASPX页面才被系统处理解析，并将处理完成的结果继续经由HttpModule传递下去，直至到达客户端。

对于ASPX页面，ASP.NET Framework在默认情况下是交给System.Web.UI.PageHandlerFactory这个HttpHandlerFactory来处理的。所谓一个HttpHandlerFactory，所谓一个HttpHandlerFactory，是指当一个HTTP请求到达这个HttpHandler Factory时，HttpHandlerFactory会提供出一个HttpHandler容器，交由这个HttpHandler容器来处理这个HTTP请求。

一个HTTP请求都是最终交给一个HttpHandler容器中的ProcessRequest方法来处理的。

public class MyFirstHandler : IHttpHandler,IRequiresSessionState

{

#region IHttpHandler 成员

public bool IsReusable

{

get { return true; }

}

public void ProcessRequest(HttpContext context)

{

context.Response.Write("

Hello HttpHandler

");

context.Session["Test"] = "测试HttpHandler容器中调用Session";

context.Response.Write(context.Session["Test"]);

}

#endregion

}

在Web.config中加入如下配置：

从上面的代码中可以看出需要实现IsReusable属性和ProcessRequest方法，其中IsReusable属性表示是否有好重用该Httphandler，而ProcessRequest测试请求最终的处理方法，该方法需要一个HttpContext实例作为参数，用于在httpMudel与httphandler之间传递参数，也可以用于保持某个完整请求的相应的信息！

在实现很多功能中，我们都可以使用，比如图片加水印，防止盗链等！

收录于