Asp.Net WebApi核心对象解析（一）

时间 2019-11-19

标签 asp.net asp webapi 核心对象解析栏目 ASP 繁體版

原文原文链接

生活须要本身慢慢去体验和思考，对于知识也是如此。匆匆忙忙的生活，让人不知道本身一天到晚都在干些什么，彷佛天天都在忙，但又好似不知道本身到底在忙些什么。不过也无所谓，只要咱们知道最后想要什么就行。无论怎么样，咱们仍是得学习，让本身不断的向前，这样才能够渐渐看到本身的追求，发发感叹，谁让楼主之前是写小说的呢（想看楼主之前的小说能够私聊我，之前绝对货真价实的文艺青年，惋惜如今已是屌丝了。）html

不扯淡，仍是来聊正经事，什么正经事勒？对于程序员来讲，固然代码才是正经事了。程序员

在咱们的项目开发中，不少时候须要使用到多系统的数据交互，以及一些功能的分布式开发。在.NET的体系中的分布式技术主要有webservice，.net remoting，MSMQ，WCF等等，可是今天介绍的是Asp.Net WebApi，对于Asp.Net WebApi技术，估计不少人都不会陌生，或者常用，由于对于其余的分布式技术的问题，在使用的时候会比较的繁琐，可是Asp.Net WebApi可能会简便和快捷不少。下面具体介绍一下Asp.Net WebApi技术。web

一.WebApi概述：

ASP.NET Web API是在.NET Framework之上构建的Web的API的框架，ASP.NET Web API是一个编程接口，用于操做可经过标准HTTP方法和标头访问的系统，ASP.NET Web API须要基于.NET 3.5或更高版本才能够进行开发。咱们在学习ASP.NET Web API时，须要对HTTP协议、web知识有一个比较深刻的认识，这样在学习ASP.NET Web API时会比较快速的上手和应用。这里就不介绍HTTP协议和Web相关的基础知识，须要了解的能够自行百度搜索学习。编程

ASP.NET Web API可提供各类HTTP客户端使用，可使用web基础设施提供的服务。json

1.ASP.NET Web API具备如下的几个特色：

(1).可供多种客户端使用。api

(2).支持标准的HTTP方法。浏览器

(3).支持浏览器友好的格式。（支持浏览器以及任何其它HTTP客户端容易支持的格式，例如json，xml等数据格式）安全

(4).支持浏览器友好的认证方式。服务器

2.ASP.NET Web API所需的软件包：

(1).System.Net.Http：提供核心HTTP编程模型。网络

(2).System.AspNet.WebApi：提供在ASP.NET中安装和托管所需的安装的全部软件包的一个引用。

(3).System.AspNet.WebApi.Core：包含核心WebApi编程模型和运行时组件。

(4).System.AspNet.WebApi.Client：包含核心.NET HTTP客户端库的扩展。

(5).System.AspNet.WebApi.WebHost：包含在ASP.NET运行时中托管WebApi所需的所有运行时组件。

对于ASP.NET Web API的简单demo、安全认证、异常处理、内容协商、寄宿方式、错误处理等等，在这里就再也不过于介绍，若是有时间博主会单独讲解这些内容。

二.WebApi路由机制的简要概述：

对于ASP.NET Web API路由的介绍会比较简单，由于对于熟悉asp.net mvc的人来讲不是什么难事，并且本次博文的重点并非在这里，因此在这里只会作一个简单的介绍。ASP.NET WebAPI使用HTTP方法，而不是URI路径，以此来选择动做。还可使用MVC样式路由的WebAPI。

在ASP.NET Web API中，一个控制器是处理HTTP请求的类。控制器的公共方法被称为动做方法或简单的动做。当Web API框架接收到一个请求，它请求路由到一个动做。要肯定调用哪一个动做，框架使用的路由表。以下代码：

routes.MapHttpRoute(
    name: "API Default",
    routeTemplate: "api/{controller}/{id}",
    defaults: new { id = RouteParameter.Optional }
);

咱们在设置WebAPI路由时，已尽可能注意与AspNet Mvc的路由发生冲突，这一点在ASP.NET Web API中作了一个防范。

ASP.NET Web API的路由运行机制以下：

(1).找到控制器，网络API将“控制器”的值 {}控制变量。

(2).查找的动做，网络API着眼于HTTP方法，而后寻找一个动做名称以该HTTP方法名。例如，用GET请求，WebAPI查找与“获取...”，例如“GetContact”或“GetAllContacts”开头的动做。该公约只适用于GET，POST，PUT和DELETE方法。您能够经过使用控制器上的属性启用其余HTTP方法。

(3).在路由模板其余占位符变量，诸如{ID}，被映射到动做的参数。

对于ASP.NET Web API的路由机制就讲解这么多，更多的内容你们能够本身去了解。

三.WebApi核心对象ApiController：

在咱们的asp.net webapi项目中，在顶层目录App_Start下，有一个WebApiConfig类，该类只包含一个方法Register，由Global.asax中的Application_Start方法调用代码，以下代码：

 GlobalConfiguration.Configure(WebApiConfig.Register);

路由的映射方法只是一个扩展方法，若是须要了解“扩展方法”的相关知识，能够阅读如下：http://www.cnblogs.com/pengze0902/p/6110094.html，在这里就作介绍了，建立一个路由实例，并把这个实例添加到与宿主相关的路由集合之中。

如今这里着重介绍一下ApiController类。

ApiController是ValuesController类的父类，是整个ASP.NET Web API的核心类，继承该类能够用来建立ASP.NET Web API控制器。ApiController类中的公共静态（在Visual Basic中共享）成员是线程安全的，任何实例成员都不能保证是线程安全的。下面介绍一下ApiController在ASP.NET Web API中所承担的任务以下：

　　(1).选择和运行控制器类上的一个操做方法。

　　(2).将HTTP请求消息的各元素转换成控制器操做方法的参数，并将操做方法的返回值转换为有效的HTTP响应正文。（HTTP响应body的数据格式能够客户端和服务器进行协商，默认为json格式，对于json格式的好处，在这里就不作介绍，可是我的以为json格式应该会成为之后数据格式的重心。）

　　(3).运行各类筛选器，这些筛选器能够是为操做方法或控制器配置，也能够是全局的。

　　(4).为控制器类的操做方法提供适当的上下文状态。

以上是ApiController类的做用的简单介绍，下面咱们具体看一下实现代码。

首先，咱们先来预览一下ApiController类的方法和属性：

1.属性摘要：

ActionContext：获取操做上下文；

Configuration和ControllerContext：获取当前 ApiController 的 HttpConfiguration对象；

ModelState：在模型绑定过程以后获取模型状态；

Request：获取或设置当前 ApiController 的 HttpRequestMessage；

RequestContext：获取请求上下文；

Url：用于生成指向其余 API 的 URL；

User：返回与此请求关联的当前主体；

2.方法摘要：

ExecuteAsync()：异步执行单个 HTTP 操做，该方法为虚方法，可在子类中重写；

Validate<TEntity>()：验证给定实体并使用空前缀将验证错误添加到模型状态；

Initialize()：使用指定的 controllerContext 初始化 System.Web.Http.ApiController 实例；

BadRequest()：建立具备指定的InvalidModelStateResult模型状态。

Created()：建立一个CreatedNegotiatedContentResult`1（201表示已建立）具备指定的值。

Redirect()：建立具备指定值的重定向结果（302 Found）。

ResponseMessage()：建立具备指定响应的ResponseMessageResult。

3.详细代码介绍：

ApiController类实现了IHttpController和IDisposable接口。在ASP.NET Web API中若是须要建立控制器，只须要实现IHttpController接口便可，咱们看一下IHttpController接口的实现代码：

    //表示 HTTP 控制器
    public interface IHttpController
    {
        // 执行用于同步的控制器。
        //参数:controllerContext:测试控制器的当前上下文。cancellationToken:取消操做的通知。
        //返回结果:控制器。
        Task<HttpResponseMessage> ExecuteAsync(HttpControllerContext controllerContext, CancellationToken cancellationToken);
    }

能够看到该接口只有一个方法ExecuteAsync()，该方法为一个异步方法，HttpControllerContext表示一个HTTP请求对象，CancellationToken表示一个传递一个消息，为HTTP操做分配的取消令牌，Task<HttpResponseMessage>能够看出该方法返回一个异步的HTTP对象。咱们看一下ApiController类中队该类的实现代码：

     /// <summary>
    /// 异步执行单个 HTTP 操做。
    /// </summary>
    /// <returns>
    /// 新启动的任务。
    /// </returns>
    /// <param name="controllerContext">单个 HTTP 操做的控制器上下文。</param><param name="cancellationToken">为 HTTP 操做分配的取消标记。</param>
    public virtual Task<HttpResponseMessage> ExecuteAsync(HttpControllerContext controllerContext, CancellationToken cancellationToken)
    {
      if (this._initialized)
        throw Error.InvalidOperation(SRResources.CannotSupportSingletonInstance, new object[2]
        {
          (object) typeof (ApiController).Name,
          (object) typeof (IHttpControllerActivator).Name
        });
      this.Initialize(controllerContext);
      if (this.Request != null)
        HttpRequestMessageExtensions.RegisterForDispose(this.Request, (IDisposable) this);
      ServicesContainer services = controllerContext.ControllerDescriptor.Configuration.Services;
      //根据HTTP请求内容选择动做
      HttpActionDescriptor actionDescriptor = ServicesExtensions.GetActionSelector(services).SelectAction(controllerContext);
      this.ActionContext.ActionDescriptor = actionDescriptor;
      if (this.Request != null)
        HttpRequestMessageExtensions.SetActionDescriptor(this.Request, actionDescriptor);
      FilterGrouping filterGrouping = actionDescriptor.GetFilterGrouping();
      //获取动做过滤器
      IActionFilter[] actionFilters = filterGrouping.ActionFilters;
      //获取受权过滤器
      IAuthenticationFilter[] authenticationFilters = filterGrouping.AuthenticationFilters;
      IAuthorizationFilter[] authorizationFilters = filterGrouping.AuthorizationFilters;
      //获取异常过滤器
      IExceptionFilter[] exceptionFilters = filterGrouping.ExceptionFilters;
      IHttpActionResult innerResult = (IHttpActionResult) new ActionFilterResult(actionDescriptor.ActionBinding, this.ActionContext, services, actionFilters);
      if (authorizationFilters.Length > 0)
        innerResult = (IHttpActionResult) new AuthorizationFilterResult(this.ActionContext, authorizationFilters, innerResult);
      if (authenticationFilters.Length > 0)
        innerResult = (IHttpActionResult) new AuthenticationFilterResult(this.ActionContext, this, authenticationFilters, innerResult);
      if (exceptionFilters.Length > 0)
      {
        IExceptionLogger logger = ExceptionServices.GetLogger(services);
        IExceptionHandler handler = ExceptionServices.GetHandler(services);
        innerResult = (IHttpActionResult) new ExceptionFilterResult(this.ActionContext, exceptionFilters, logger, handler, innerResult);
      }
      return innerResult.ExecuteAsync(cancellationToken);
    }

由以上的实现代码能够看出，含有三个类型的过滤器，分别是 IActionFilter、IAuthenticationFilter、IExceptionFilter，该方法在获取到消息请求后，初始化消息和请求，调用 HttpRequestMessageExtensions.RegisterForDispose(this.Request, (IDisposable) this)该方法进行注册，该方法会对请求信息进行过滤操做。

咱们接下来看一下Request和RequestContext属性的具体代码：

     /// <summary>
    /// 获取或设置当前ApiController的 HttpRequestMessage。
    /// </summary>
    /// <returns>
    /// 当前ApiController的 HttpRequestMessage。
    /// </returns>
    public HttpRequestMessage Request
    {
      get
      {
        return this.ControllerContext.Request;
      }
      set
      {
        if (value == null)
          throw Error.PropertyNull();
        HttpRequestContext requestContext1 = HttpRequestMessageExtensions.GetRequestContext(value);
        HttpRequestContext requestContext2 = this.RequestContext;
        if (requestContext1 != null && requestContext1 != requestContext2)
          throw new InvalidOperationException(SRResources.RequestContextConflict);
        this.ControllerContext.Request = value;
        HttpRequestMessageExtensions.SetRequestContext(value, requestContext2);
        RequestBackedHttpRequestContext httpRequestContext = requestContext2 as RequestBackedHttpRequestContext;
        if (httpRequestContext == null)
          return;
        httpRequestContext.Request = value;
      }
    }

    /// <summary>
    /// 获取请求上下文。
    /// </summary>
    /// <returns>
    /// 请求上下文。
    /// </returns>
    public HttpRequestContext RequestContext
    {
      get
      {
        return this.ControllerContext.RequestContext;
      }
      set
      {
        if (value == null)
          throw Error.PropertyNull();
        HttpRequestContext requestContext1 = this.ControllerContext.RequestContext;
        HttpRequestMessage request = this.Request;
        if (request != null)
        {
          HttpRequestContext requestContext2 = HttpRequestMessageExtensions.GetRequestContext(request);
          if (requestContext2 != null && requestContext2 != requestContext1 && requestContext2 != value)
            throw new InvalidOperationException(SRResources.RequestContextConflict);
          HttpRequestMessageExtensions.SetRequestContext(request, value);
        }
        this.ControllerContext.RequestContext = value;
      }
    }

Request和RequestContext属性分别用于设置和获取HttpRequestMessage对象和RequestContext对象，

ASP.NET Web API除了能够根据HTTP方法来选择操做方法，还能够根据请求的其余元素选择操做方法。ASP.NET Web API框架支持从请求元素到操做方法参数的绑定。对于HTTP响应值转换成适当的HTTP响应消息正文。

四.总结：

以上是对ASP.NET Web API背景和使用方法，以及对ASP.NET Web API核心对象的简要介绍，下篇会主要介绍HttpRequestMessage、HttpResponseMessage、HttpClient等三个对象的解析。若是文中有不足和讲解错误之处，还望你们多多指正。