HttpHandler(处理程序) 和 HttpModule(托管模块)

本文参见：http://www.tracefact.net/Asp-Net/Introduction-to-Http-Handler.aspx

前言：前几天看到一个DTcms网站，里面有个伪静态技术，那我之前也写过一个伪静态，是通过一个URlWrite类在配置文件里面配置就可以了。而他的网站结构不同于我先前介绍的，网站里面是把页面与代码完全分离，页面是纯粹的HTML页面，代码就是*.cs文件，利用他里面介绍的语法可以在HTML页面写后台代码。这个是非常值得学习的。这篇文章就是打的基础。之前在配置的伪静态在config文件里面也出现了这两个配置，当时并没有去了解原理，这次碰到了才来深入了解。

Http请求

当服务器接收到一个 Http请求的时候，IIS 首先需要决定如何去处理这个请求（NOTE：服务器处理一个.htm页面和一个.aspx页面肯定是不一样的么）。那IIS依据什么去处理呢？―― 根据文件的后缀名。

如何配置：

打开我们需要配置的网站（演示的IIS是本地的）

找到处理程序映射

我们可以添加我们自己需要的，列如:我需要在网站中打开 *.test 后缀名的

①右键添加脚本映射

C:\Windows\Microsoft.NET\Framework\v4.0.30319 此文件夹是存放 dll文件的。下面的这个dll是主要的。

IIS里面添加了以后，在配置文件里面写才会有反应。后面会说。

HTTP管道：

需要注意的：

4.0以下：

  <system.web>

    <httpHandlers>

      <add path="*.jpg" verb="*" name="DTcmsTest" type="DTcmsTest.IHttpHandlerDemo.CustomHandler" />

      <add path="*.rss" verb="*" name="RssTest" type="DTcmsTest.Rss.RSSHandler"/>

    </httpHandlers>

    <httpModules>

      <add name="MyModule" type="DTcmsTest.IHttpModuleDemo.ModuleDemo"/>

    </httpModules>

  </system.web>

而4.0或以上

<system.webServer>

    <handlers>

      <add path="*.jpg" verb="*" name="DTcmsTest" type="DTcmsTest.IHttpHandlerDemo.CustomHandler" />

      <add path="*.rss" verb="*" name="RssTest" type="DTcmsTest.Rss.RSSHandler"/>

    </handlers>

    <modules>

      <add name="MyModule" type="DTcmsTest.IHttpModuleDemo.ModuleDemo"/>

    </modules>

  </system.webServer>

C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG 这个配置给出了一些模板、

HttpHandler

IHttpHandler接口

    //

    // 摘要:

    //     定义 ASP.NET 为使用自定义 HTTP 处理程序同步处理 HTTP Web 请求而实现的协定。

    public interface IHttpHandler

    {

        //

        // 摘要:

        //     获取一个值，该值指示其他请求是否可以使用 System.Web.IHttpHandler 实例。

        //

        // 返回结果:

        //     如果 System.Web.IHttpHandler 实例可再次使用，则为 true；否则为 false。

        bool IsReusable { get; }

        //

        // 摘要:

        //     通过实现 System.Web.IHttpHandler 接口的自定义 HttpHandler 启用 HTTP Web 请求的处理。

        //

        // 参数:

        //   context:

        //     System.Web.HttpContext 对象，它提供对用于为 HTTP 请求提供服务的内部服务器对象（如 Request、Response、Session

        //     和 Server）的引用。

        void ProcessRequest(HttpContext context);

模板如下：

public class CustomHandler : IHttpHandler{

    public void ProcessRequest(HttpContext context)  {

       // 处理请求的代码

    }

    public bool IsReusable {

       get { return true; }

    }

}

一般处理程序我们用的很多。我们配置这个，在URL上访问 *.jpg来显示一张图片。

①写好代码，需要继承IHttpHandler接口的

namespace DTcmsTest.IHttpHandlerDemo

{

    /// <summary>

    /// 继承这个接口  并实现

    /// </summary>

    public class CustomHandler : IHttpHandler

    {

        public void ProcessRequest(HttpContext context)

        {

            string FileName = context.Server.MapPath(context.Request.FilePath);

            context.Response.ContentType = "image/JPEG";

            context.Response.WriteFile("/Img/2.jpg"); //我们输出一张图片

        }

        public bool IsReusable

        {

            get

            {

                return true;

            }

        }

    }

}

②注册 config文件

  <system.webServer>  此节点下

    <handlers>

      <!--  path指的是请求的文件名称,可以使用通配符扩大范围

            verb指的是请求的方式,get或post，*代表所有访问方式

            name就是名称,可以随便写

            type属性有 “，”分隔成两部分

            第一部分是现实了接口的类名  全称,带命名空间

            第二部分是位于bin目录下的编译过的程序集名称,有则写,无可不写
            这里配置了*.jpg，按理说IIS上也要配置相同的名字，IIS有一些帮你声明了，如果不行就去IIS上补一下

      -->

     <add path="*.jpg" verb="*" name="DTcmsTest" type="DTcmsTest.IHttpHandlerDemo.CustomHandler" />

    </handlers>

       </system.webServer>

③url上随便输入*.jpg就可以看到图片，代码里面不写错，随便哪个目录都可以看到此图片(其实就是访问*.jpg就可以去访问CustomHandler类了)

这个输出验证码很常用的，这里就不介绍了。在来看第二个列子，输出XML格式。RSS类型。

先看效果图

①新建一个类

namespace DTcmsTest.Rss

{

    /// <summary>

    /// 字符串格式

    /// </summary>

    public class RssFeedsLib

    {

        public static string GetRSS()

        {

            MemoryStream ms = new MemoryStream();

            XmlWriter writer = new XmlTextWriter(ms, null);

            SqlConnection conn = new SqlConnection("server=.;uid=sa;pwd=a123;database=Sample;");

            SqlCommand cmd = new SqlCommand("select * from RssSample order by pubdate desc", conn);

            conn.Open();

            SqlDataReader reader = cmd.ExecuteReader();

            writer.WriteStartElement("rss"); //新建一个元素

            writer.WriteAttributeString("version", "2.0"); //设置属性

            writer.WriteStartElement("channel");

            // Channel 下的结点静态写入

            writer.WriteElementString("title", "TraceFact.Net 技术文章");

            writer.WriteElementString("link", "http://www.tracefact.net");

            writer.WriteElementString("description", "Dedicated to asp.net...");

            writer.WriteElementString("copyright", "Copyright (C) 2007");

            writer.WriteElementString("generator", "My RSS Generator");

            // Item 结点从数据库读取

            while (reader.Read())

            {

                writer.WriteStartElement("item");

                writer.WriteElementString("author", reader.GetString(reader.GetOrdinal("Author")));

                writer.WriteElementString("title", reader.GetString(reader.GetOrdinal("title")));

                writer.WriteElementString("link", reader.GetString(reader.GetOrdinal("Link")));

                writer.WriteElementString("description", reader.GetString(reader.GetOrdinal("Description")));

                writer.WriteElementString("pubDate", reader.GetDateTime(reader.GetOrdinal("PubDate")).ToString(@"ddd, dd MMM yyyy 12:00:00 tt "));

                writer.WriteEndElement();

            }

            writer.WriteEndElement();

            writer.WriteEndElement();

            reader.Close();

            conn.Close();

            writer.BaseStream.Flush();

            writer.Flush();

            ms.Flush();

            // 将流转换成String并返回

            byte[] data = new byte[ms.Length];

            ms.Seek(, SeekOrigin.Begin);

            ms.Read(data, , data.Length);

            ms.Close();

            return UTF8Encoding.UTF8.GetString(data);

        }

    }

}

② 新建一个一般处理程序或类，在里面去调用方法

namespace DTcmsTest.Rss

{

    /// <summary>

    /// RSSHandler 的摘要说明  XML格式

    /// </summary>

    public class RSSHandler : IHttpHandler

    {

        public void ProcessRequest(HttpContext context)

        {

            context.Response.ContentType = "text/plain";

            context.Response.ContentEncoding = System.Text.Encoding.UTF8;

            context.Response.ContentType = "text/xml";  //需要设置这个格式

            string aa = RssFeedsLib.GetRSS();

            context.Response.Write(aa);

如果是一般处理程序，我们访问这个是没有问题的，是类就访问不了。

③注册 config文件

URL随便输入 *.rss就可以得到信息

HttpModul

定义：Asp.Net中的事件分成三个级别，最顶层是应用程序级事件、其次是页面级事件、最下面是控件级事件，事件的触发分别与应用程序周期、页面周期、控件周期紧密相关。而 Http Module 的作用是与应用程序事件密切相关的。

namespace System.Web

{

    //

    // 摘要:

    //     向实现类提供模块初始化和处置事件。

    public interface IHttpModule

    {

        //

        // 摘要:

        //     处置由实现 System.Web.IHttpModule 的模块使用的资源（内存除外）。

        void Dispose();

        //

        // 摘要:

        //     初始化模块，并使其为处理请求做好准备。

        //

        // 参数:

        //   context:

        //     一个 System.Web.HttpApplication，它提供对 ASP.NET 应用程序内所有应用程序对象的公用的方法、属性和事件的访问

        void Init(HttpApplication context);

    }

}

实现一个IHttpModult模板如下：

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() {

    }

}

①新建一个类，继承 IHttpModule接口

namespace DTcmsTest.IHttpModuleDemo

{

    public class ModuleDemo : IHttpModule

    {

        //申明一个事件

        public event EventHandler ExposedEvent;

        void IHttpModule.Init(HttpApplication context)

        {
            //打开一个页面会先执行这个方法，对于每个页面都一样

            context.BeginRequest += new EventHandler(context_BeginRequest);  //调用事件

            context.EndRequest += new EventHandler(context_EndRequest);

        }

        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>");

        }

        void context_EndRequest(object sender,EventArgs e)

        {

            HttpContext context = ((HttpApplication)sender).Context;

            context.Response.Write("<hr><h1 style='color:#f00'>来自HttpModule的处理，请求结束</h1>");

        }

    }

}

②注册 config文件

<system.webServer> 
 <modules>

        <!--名字随便取

         type跟上面的一样-->

      <add name="MyModule" type="DTcmsTest.IHttpModuleDemo.ModuleDemo"/>

    </modules>
 </system.webServer>

打开一个页面：

由这个页面可以看出，我们在执行页面之前先去执行了 IHttpModule里面的方法。

这个两个配置基本也就了解了。DTcms里面就有个 HttpModule 类继承了IHttpModule接口，然后完成一些操作，等学会了到时候在记录一下。

巴特西

HttpHandler(处理程序) 和 HttpModule(托管模块)

IHttpHandler接口

最新文章

热门文章