ASP.NET Web API WebHost宿主环境中管道、路由

ASP.NET Web API WebHost宿主环境中管道、路由

前言

上篇中说到ASP.NET Web API框架在SelfHost环境中管道、路由的一个形态，本篇就来说明一下在WebHost环境中ASP.NET Web API框架中的管道、路由又是哪一种形态。

ASP.NET Web API路由、管道

• ASP.NET Web API 开篇介绍演示样例
• ASP.NET Web API 路由对象介绍
• ASP.NET Web API 管道模型
• ASP.NET Web API selfhost宿主环境中管道、路由
• ASP.NET Web API webhost宿主环境中管道、路由

ASP.NET Web API webhost宿主环境中管道、路由

以下将会主要解说路由的注冊运行过程（WebHost环境）。对于管道不会去刻意的说明，都会包括在路由的解说中。拆开来说明效果不太好。

HttpRoute->HostedHttpRoute->HttpWebRoute->Route

想要清楚的了解路由的运行过程以及管道的形态。就必须对路由对象熟知。然而在前面的《ASP.NET Web API 路由对象介绍》篇幅中仅仅是分别的对各个环境下的路由对象类型进行了说明。并没有说明转变的过程。

如今就来解说路由对象的“转变”过程。

演示样例代码1-1

        protected void Application_Start(object sender, EventArgs e)
        {
            GlobalConfiguration.Configuration.Routes.MapHttpRoute(
              "DefaultAPI", "api/{controller}/{id}", new { controller="product",id = RouteParameter.Optional });
        }

演示样例代码1-1中是在WebHost环境下进行的路由注冊，依据MapHttpRoute()方法我们转定义过去应该是一个HttpRouteCollection类型的扩展方法类型HttpRouteCollectionExtensions，既然是HttpRouteCollectionExtensions类型里的实现那我们就过去看看究竟啥情况。

演示样例代码1-2

public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, string routeTemplate, object defaults, object constraints, HttpMessageHandler handler)
        {
            if (routes == null)
            {
                throw System.Web.Http.Error.ArgumentNull("routes");
            }
            HttpRouteValueDictionary dictionary = new HttpRouteValueDictionary(defaults);
            HttpRouteValueDictionary dictionary2 = new HttpRouteValueDictionary(constraints);
            IDictionary<string, object> dataTokens = null;
            HttpMessageHandler handler2 = handler;
            IHttpRoute route = routes.CreateRoute(routeTemplate, dictionary, dictionary2, dataTokens, handler2);
            routes.Add(name, route);
            return route;
        }

我们能够看到返回类型是IHttpRoute，生成则是由HttpRouteCollection类型的实例调用当中的CreateRoute()方法来实现，这里有的朋友要问了，这不是SelfHost中的路由注冊实现方式吗？回答是对的。仅仅只是在WebHost中利用多态来实现返回成其它的类型。接着往下看。

既然都看到了在这里发生的变化。那说明是有继承了HttpRouteCollection类型的这么一个类型然后创建的路由对象。这样一理就清晰多了，在SelfHost环境中HttpRouteCollection类型是存在于HttpConfiguration类型的对象中，并不单独使用。而在WebHost中也是。

这个时候我们再回过头来看一下代码1-1中的GlobalConfiguration类型中的定义。

演示样例代码1-3

        private static Lazy<HttpConfiguration> _configuration = new Lazy<HttpConfiguration>(delegate {
            HttpConfiguration configuration = new HttpConfiguration(new HostedHttpRouteCollection(RouteTable.Routes));
            configuration.Services.Replace(typeof(IAssembliesResolver), new WebHostAssembliesResolver());
            configuration.Services.Replace(typeof(IHttpControllerTypeResolver), new WebHostHttpControllerTypeResolver());
            configuration.Services.Replace(typeof(IHostBufferPolicySelector), new WebHostBufferPolicySelector());
            return configuration;
        });
        public static HttpConfiguration Configuration
        {
            get
            {
                return _configuration.Value;
            }
        }

从代码1-3中我们能够看到_configuration静态变量使用了延迟载入，啥意思呢就是以下的那个HttpConfiguration类型的Configuration属性假设使用了才会去实例化，跑偏了这不是重点。

重点是在实例化静态变量_configuration中能够清楚的看到使用了HostedHttpRouteCollection类型的路由集合类型对象作为构造函数參数。

能够自行的去看一下HostedHttpRouteCollection的内部结构。

如今再回到创建路由的那会，也就是代码1-1和代码1-2中所看到的的那样，实际也就是HostedHttpRouteCollection类型在创建路由对象，依照老规矩直接看实现代码。

演示样例代码1-4

    public override IHttpRoute CreateRoute(string uriTemplate, IDictionary<string, object> defaults, IDictionary<string, object> constraints, IDictionary<string, object> dataTokens, HttpMessageHandler handler)
    {
        return new HostedHttpRoute(uriTemplate, defaults, constraints, dataTokens, handler);
    }

从代码1-4中能够清楚的看到是返回的是HostedHttpRoute路由对象，我们能够看一下构造函数，仅仅有这样才干知道“转变”的过程。

    public HostedHttpRoute(string uriTemplate, IDictionary<string, object> defaults, IDictionary<string, object> constraints, IDictionary<string, object> dataTokens, HttpMessageHandler handler)
    {
        RouteValueDictionary dictionary = (defaults != null) ? new RouteValueDictionary(defaults) : null;
        RouteValueDictionary dictionary2 = (constraints != null) ? new RouteValueDictionary(constraints) : null;
        RouteValueDictionary dictionary3 = (dataTokens != null) ? new RouteValueDictionary(dataTokens) : null;
        this.OriginalRoute = new HttpWebRoute(uriTemplate, dictionary, dictionary2, dictionary3, HttpControllerRouteHandler.Instance, this);
        this.Handler = handler;
   }

在代码1-4中我们仅仅须要关注OriginalRoute属性的赋值，OriginalRoute属性是HostedHttpRoute类型里的一个属性，是用来设置对Route对象的引用，演示样例代码1-4中也就是HttpWebRoute类型的对象，对于HttpWebRoute对象的构造函数这里就不例举了。这个时候能够看到是将HttpControllerRouteHandler类型的对象作为Route(HttpWebRoute)对象的RouteHandler(路由处理程序)。

大家都知道ASP.NET Web API框架在WebHost环境中是依赖于ASP.NET的，实则也是通过IHttpModule来进行前期的消息拦截，以下我们看一下在HttpModule中的代码（我想应该是这种，假设有误请指点。

）

演示样例代码1-5

    public class WebAPIHttpModule:IHttpModule
    {


        public void Dispose()
        {
            throw new NotImplementedException();
        }

        public void Init(HttpApplication context)
        {
            context.PostResolveRequestCache += context_PostResolveRequestCache;
        }

        void context_PostResolveRequestCache(object sender, EventArgs e)
        {
            HttpApplication context = sender as HttpApplication;
            HttpContextWrapper contextWrapper = new HttpContextWrapper(context.Context);
            RouteData routeData = RouteTable.Routes.GetRouteData(contextWrapper);
            RequestContext requestContext=new RequestContext(contextWrapper,routeData);
            IHttpHandler httpHandler = routeData.RouteHandler.GetHttpHandler(requestContext);
            IHttpAsyncHandler httpAsyncHandler = httpHandler as IHttpAsyncHandler;
            httpAsyncHandler.BeginProcessRequest(context.Context, null, null);
        }
     }

在代码1-5中我们能够看到首先是获取了RouteData对象实例，以此获取RouteHandler，然后依据RequestContext获取IHttpHandler，再转换为IHttpAsyncHandler类型的实例。然后调用其BeginProcessRequest()方法来运行操作。

上面这段话描写叙述的是上述代码的运行过程，有的朋友可能会疑问了，怎么就获取RouteData了？

这里我给大家解释一下，在我们的代码1-2中，有这种代码：

            IHttpRoute route = routes.CreateRoute(routeTemplate, dictionary, dictionary2, dataTokens, handler2);
            routes.Add(name, route);

首先我们看第一句，这里的route上面说过了是HostedHttpRoute对象，这里毫无疑问直接过，然后我们再看第二句，这里的routes是HostedHttpRouteCollection对象不假，可是这个Add()方法加入的方向不是HostedHttpRouteCollection，而是由我们一開始在GlobalConfiguration类型中说过的RouteTable.Routes，当前环境是什么？ASP.NET框架环境对吧！毫无疑问这个Add()方法把上面所说的route(HostedHttpRoute对象)加入到了当前环境的RouteTable.Routes中。有的朋友会问了类型不正确。确实是不正确的在加入的时候route(HostedHttpRoute对象)会转换成HttpWebRoute对象，HttpWebRoute对象继承自Route，能够看前面的篇幅，想必讲到这里大家应该明确了。这里我就不多说了。

我们接着回到代码1-5中，在获取了RouteData之后通过RouteHandler的GetHttphandler()方法获取IHttpHandler实例，在RouteData中的这个RouteHandler毫无疑问就是HttpControllerRouteHandler类型。

我们来看下HttpControllerRouteHandler类型中的GetHttphandler()方法：

    protected virtual IHttpHandler GetHttpHandler(RequestContext requestContext)
    {
        return new HttpControllerHandler(requestContext.RouteData);
    }

能够看到是由HttpControllerHandler这个对象类型来运行最后的操作，那我们就来看一下这个类型的定义：

public class HttpControllerHandler : IHttpAsyncHandler, IHttpHandler

如今大家明确为什么要转成IHttpAsyncHandler了吧，由于假设调用了实现了IHttpHandler接口的函数是会报出异常的，由于在HttpControllerHandler类型中并没有实现IHttpHandler接口仅仅是一个空壳，然后我们再看一下HttpControllerHandler类型的静态构造函数：

图1

 这个_server是Lazy<HttpMessageInvoker>类型。在BeginProcessRequest()方法中会运行SendAsync()以此进入ASP.NET Web API的管道。

 以下我们看一下总体的一个示意图,

图2

 

最后对于HttpControllerDispatcher类型在控制器部分解说。

作者：金源

出处：http://blog.csdn.net/jinyuan0829

本文版权归作者和CSDN共同拥有，欢迎转载，但未经作者允许必须保留此段声明。且在文章页面