asp.net Web API 路由对象介绍

ASP.NET Web API 路由对象介绍

前言

在ASP.NET、ASP.NET MVC和ASP.NET Web API这些框架中都会发现有路由的身影，它们的原理都差不多，只不过在不同的环境下作了一些微小的修改，这也是根据每个框架的特性来制定的，今天我们就来看一看路由的结构，虽然我在MVC系列里写过路由的篇幅不过在这里是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宿主环境中管道、路由

路由系统概念

路由对象的结构

图1

路由系统中最重要的部分也就是路由对象了，那我们首先就来看一下【路由对象】的定义，不管是在ASP.NET、ASP.NET MVC、还是ASP.NET Web API的路由系统中路由都要有个名称，其实这个名称并不是路由对象中的而是在注册路由信息的时候，添加到路由对象集合的时候需要的名称，这里也只是当作路由的一部分，这个大家知道就好了。

在生成路由对象的时候我们要给路由赋值URL模板，这也是共同的，也是必须的，至于约束URL模板的条件是可以根据自己情况来定义的。在生成的同时框架会给路由对象赋值上【路由请求处理程序】用以作为衔接路由系统和框架的主体功能部分。

注册路由到系统框架中

图2

在路由定义好之后，我们便会把它注册到系统框架中。

路由对象的URL匹配

图3

在路由对象注册到系统框架中之后，这个时候如果有外部的请求的到达，这个时候路由系统会让路由对象集合中每个路由对象对这个请求进行匹配，就如图4一样。

图4

这个时候就是路由对象所要能做出的行为就是URL的匹配，根据什么来匹配？是根据在路由对象实例化的时候定义好的URL模板和条件，拿请求信息的URL和自身定义的URL模板进行匹配，假使没有匹配成功则会返回Null，这个时候框架则会让下一个路由对象来进行匹配直到有匹配的成功为止，如果这个时候匹配成功了路由则会生成一个【路由数据对象】。

路由数据对象也很重要，因为后续的框架功能部分都是使用它的，它也是整个路由系统的结晶，我们看下图5

图5

路由数据对象会保持一个生成它的路由对象的引用，然后是Values的是保存着路由对象在经过URL匹配后的值，分别表示着URL片段的名字和对应的URL真实值，而DataTokens则是在路由对象定义生成的时候直接带过来的值，当然了路由请求处理程序也是由执行生成的路由对象带来的。

在ASP.NET、ASP.NET MVC、ASP.NET Web API这些框架中路由系统都是遵循着上面的所述的这样一个过程，只不过在不同的框架环境下使用的类型不同，做的处理也不太一样，但是整体的流程是一致的，下面附上图6说明了之间的类型的差异性，还有更多的细节就不一一展示了。

图6

还有在Web API(WebHost)环境下路由显示的是这样实质的本质其实又是ASP.NET的路由系统在支持的，这个会在后面的Web API系列篇幅中讲解。

下面简单的演示一下在各种框架环境下的路由对象注册，

ASP.NET:

RouteTable.Routes.MapPageRoute(                "ASP.NETRoute",                "PRoductInfo/{action}/{id}",                "~/ProductInfo.aspx",                true,                new RouteValueDictionary { { "id", RouteParameter.Optional }, { "action", "show" } }                );

ASP.NET MVC：

            RouteTable.Routes.MapRoute(                "ASP.NETMVCRoute",                "ProductInfo/{action}/{id}",                new { controller="Product",action="show",id=RouteParameter.Optional}                );

ASP.NET Web API（WEBHOST）：

            GlobalConfiguration.Configuration.Routes.MapHttpRoute(               "WebAPIRoute",               "api/{controller}/{id}", new { id = RouteParameter.Optional }               );

ASP.NET Web API（SELFHOST）：

HttpSelfHostConfiguration configuration =                 new HttpSelfHostConfiguration("http://loacalhost/selfhost");            using (HttpSelfHostServer selfHostServer = new HttpSelfHostServer(configuration))            {                selfHostServer.Configuration.Routes.MapHttpRoute(                    "DefaultApi", "api/{controller}/{id}", new { id=RouteParameter.Optional});                               selfHostServer.OpenAsync();                Console.Read();            }

ASP.NET Web API 路由系列对象

从上图的图表中就可以看出，ASP.NET Web API框架在不同的宿主环境下路由系统中所对应的对象类型是不同的，这里就先给大家介绍在SelfHost环境下的路由系统中的路由对象吧。

SelfHost宿主环境

Web API路由对象(System.Web.Http.Routing)

HttpRoute

    // 摘要:    //     表示自承载（即在 ASP.NET 之外承载）的路由类。    public class HttpRoute : IHttpRoute    {        public HttpRoute(string routeTemplate, HttpRouteValueDictionary defaults, HttpRouteValueDictionary constraints, HttpRouteValueDictionary dataTokens, HttpMessageHandler handler);        public IDictionary<string, object> Constraints { get; }        public IDictionary<string, object> DataTokens { get; }        public IDictionary<string, object> Defaults { get; }        public HttpMessageHandler Handler { get; }        public string RouteTemplate { get; }        public virtual IHttpRouteData GetRouteData(string virtualPathRoot, HttpRequestMessage request);        public virtual IHttpVirtualPathData GetVirtualPath(HttpRequestMessage request, IDictionary<string, object> values);        protected virtual bool ProcessConstraint(HttpRequestMessage request, object constraint, string parameterName, HttpRouteValueDictionary values, HttpRouteDirection routeDirection);    }

可以从上面的定义中看到HttpRoute对象就是代表着在Web API框架中的路由对象了，在HttpRoute类型定义的构造函数中的参数分别表示着路由模板、路由模板对应的默认值、路由匹配条件、注册的路由附带的值以及最后的Http请求处理程序，这几个参数值也分别对应着HttpRoute类型中的几个属性，这个自行看一下就明白了。

Web API路由对象集合(System.Web.Http)

HttpRouteCollection

HttpRouteCollectionExtensions

我们先来看一下HttpRouteCollection类型的扩展类型HttpRouteCollectionExtensions吧

    public static class HttpRouteCollectionExtensions    {        public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, string routeTemplate);        public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, string routeTemplate, object defaults);        public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, string routeTemplate, object defaults, object constraints);        public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, string routeTemplate, object defaults, object constraints, HttpMessageHandler handler);    }

这里大家可以对比上面的路由注册时的代码，就可以知道我们在路由集合 添加/注册 路由的时候是由HttpRouteCollectionExtensions类型的扩展方法来进行操作的，这个时候我们再看一下方法参数最多的那个MapHttpRoute()方法的实现：

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;        }

这里大家就可以看到了，HttpRoute对象的创建操作和添加操作是在这扩展方法里执行的，现在我们就可以去看一下HttpRouteCollection类型的定义了，看一下如何创建的IHttpRoute对象：

    public class HttpRouteCollection : ICollection<IHttpRoute>, IEnumerable<IHttpRoute>, IEnumerable, IDisposable    {        public HttpRouteCollection();        public HttpRouteCollection(string virtualPathRoot);        public virtual int Count { get; }        public virtual bool IsReadOnly { get; }        public virtual string VirtualPathRoot { get; }        public virtual void Add(string name, IHttpRoute route);        public IHttpRoute CreateRoute(string routeTemplate, object defaults, object constraints);        public IHttpRoute CreateRoute(string routeTemplate, IDictionary<string, object> defaults, IDictionary<string, object> constraints, IDictionary<string, object> dataTokens);        public virtual IHttpRoute CreateRoute(string routeTemplate, IDictionary<string, object> defaults, IDictionary<string, object> constraints, IDictionary<string, object> dataTokens, HttpMessageHandler handler);        public virtual IHttpR