Web API 源码剖析之全局配置

Web API 源码剖析之全局配置

Web API  均指Asp.net Web API 。本节讲述的是基于Web API 系统在寄宿于IIS.

本节主要讲述Web API全局配置。它是如何优雅的实现这个配置。做过MVC 都知道Global文件来初始化。Web API 本质上也是ASP.NET applications。所以也是在Global定义里一个GlobalConfiguration静态类。该类作用就是初始化ASP.NET applications.如下是GlobalConfiguration的定义。

// 
   // 摘要: 
   //     为 ASP.NET 应用程序提供全局 System.Web.Http.HttpConfiguration。 
   public static class GlobalConfiguration 
   { 
       public static HttpConfiguration Configuration { get; } 
       public static HttpMessageHandler DefaultHandler { get; } 
       // 
       // 摘要: 
       //     获取全局 System.Web.Http.HttpServer。 
       // 
       // 返回结果: 
       //     全局 System.Web.Http.HttpServer。 
       public static HttpServer DefaultServer { get; }

public static void Configure(Action<HttpConfiguration> configurationCallback); 
   }

其中定义了3个静态只读属性和1个参数是委托类型的方法,供开发人员自己来初始化配置。

  • Configuration 只读属性是HttpConfiguration类型。 用户来定义applications。主要定义一些依赖注入,参数绑定,消息格式程序,路由,过滤器。消息格式化程序,服务(注意这里的服务不是我们在开发中,后台给前台提供服务,而是applications为自己处理请求所需要类型协作集合)等。我们将在后面详细讲述HttpConfiguration。
  • DefaultHandler 是HttpMessageHandler。默认的消息处理程序。我们查看HttpMessageHandler得知,是一个抽象类,这里默认初始化new HttpRoutingDispatcher,其实HttpRoutingDispatcher也是一个消息处理程序,我们称之为路由分发器。它的默认的消息处理终结点,作用是根据路由匹配,如果找到消息处理程序,就处之。否则就将请求分发给HttpControllerDispatcher也是一个消息处理程序,我们称之为控制器分发器。了解过WCF 的同学,对这个应该会很熟悉。我们将在后面详细讲述消息处理程序。
  • DefaultServer 是HttpServer类型。本质上也是一种消息处理程序。因为HttpServer继承于DelegatingHandler,而DelegatingHandler又继承于HttpMessageHandler,后面章节将详细讲述。
  • Configure(Action<HttpConfiguration> configurationCallback),定义了一个参数为HttpConfiguration的委托Action类型,方便在外部配置applications。这是设置非常巧妙的地方。通过反编译工具查看GlobalConfiguration定义使用了延迟加载来实现,代码实现的非常优雅。代码如下:

//延迟加载

private static Lazy<HttpConfiguration> _configuration = CreateConfiguration();

//只读配置属性

public static HttpConfiguration Configuration  

           get { return _configuration.Value; }  
}

private static Lazy<HttpConfiguration> CreateConfiguration() 

            return new Lazy<HttpConfiguration>(() => 
            { 
                HttpConfiguration config = new HttpConfiguration(new HostedHttpRouteCollection(RouteTable.Routes)); 
                ServicesContainer services = config.Services; 
                Contract.Assert(services != null); 
                services.Replace(typeof(IAssembliesResolver), new WebHostAssembliesResolver()); 
                services.Replace(typeof(IHttpControllerTypeResolver), new WebHostHttpControllerTypeResolver()); 
                services.Replace(typeof(IHostBufferPolicySelector), new WebHostBufferPolicySelector()); 
                services.Replace(typeof(IExceptionHandler), 
                    new WebHostExceptionHandler(services.GetExceptionHandler())); 
                return config; 
            }); 
}

有兴趣的朋友可以下载web Api 源码查看。http://aspnetwebstack.codeplex.com/wikipage?title=Contributors.

上一篇:Web API 源码剖析之默认消息处理程序链--》路由分发器(HttpRoutingDispatcher)


下一篇:Struts1和Struts2的区别和对比