[水煮 ASP.NET Web API2 方法论]（1-1）在MVC 应用程序中添加 ASP.NET Web API

问题

怎么样将 Asp.Net Web Api 加入到现有的 Asp.Net MVC 项目中

解决方案

在 Visual Studio 2012 中就已经把 Asp.Net Web Api 自动地整合到了 MVC 项目模板中。自 Visual Studio 2013 以后，创建 ASP.Net Web应用程序使用的是一种新的"One ASP.NET"项目向导，在这里可以选择相应的组件，例如，MVC，Web API,WebForm,等等。"One ASP.NET" 是基于微软统一 ASP.NET平台的概念。如图所示图1-1

wKioL1gYrnLxmN1JAABwJvwFdVU695.png-wh_50

图1-1. "One ASP.NET" 项目向导，在一个项目中使用 MVC 和 Web Api

有意思的是，如果你选择了 Web API 项目模板，MVC 的复选框是自动被选中，因为ASP.NET Web API Help Pages 依赖于 MVC 来提供内容。

你也可以在任何已经存在的 MVC 项目中他通过 NuGet 安装"Install-Package Microsofty.Asp.Net.WebApi"来添加 Web API。

其实，上面两种，在 ASP.NET Web 应用项目中，添加 Web API 的方式是等效的，因为项目向导也仅仅是从NuGet 中安装了 ASP.NET Web API。

工作原理

ASP.NET Web API 的构建围绕着一个叫做 System.Web.IHttpAsyncHandler 的异步 HTTP Handler，如演示清单1-1.Handlers 是 ASP.NET 的主干，就是一些可以拦截和处理发送给服务器的 HTTP 请求以及响应相应的请求给客户端的类。

清单 1-1. IhttpAsyncHandler 的定义

 public interface IHttpAsyncHandler : object, IHttpHandler
{
    System.IAsyncResult BeginProcessRequest(HttpContext context, System.AsyncCallback cb,
    object extraData);
    void EndProcessRequest(System.IAsyncResult result);
}

事实上，这个和 ASP.NET MVC 框架的体系结构没有多大的不同，他也是位于 Http Hander 上层。其实，他们的框架都是软件工程中复杂的一部分，和常规的 IHttpHandler 或 IHttpAsyncHandler 没有什么特别之处，也许，以前你就创建过处理各种处理基于 HTTP 的工作。

Web API IHttpAsyncHandler 的大致结构——HttpControllerHandler 和他的公共成员，如清单1-2所示

清单 1-2. HttpControllerHandler 的公共成员

 public class HttpControllerHandler : HttpTaskAsyncHandler
{
    public HttpControllerHandler(RouteData routeData);
    public HttpControllerHandler(RouteData routeData, HttpMessageHandler handler);
    public override Task ProcessRequestAsync(HttpContext context);
}

MVC 和 Web API 的主要不同是从版本2开始的。Web API Handler-HttpControllerHandler，是HttpTaskAsyncHandler 的一个子类。在 MVC 的版本中，MvcHandler，实现了接口IHttpAsyncHandler。HttpTaskAsyncHandler是在 .NET 4.5 才有的，而 .NET 4.5 是 Web API 2 才支持。

当在同一个 ASP.NET 进程中运行 MVC 和 Web API 的时候，ASP.NET 使用的是HttpApplication。MapRequestHandler事件来决定哪个 HTTP handler 被翻牌子，来处理请求。在这个阶段，进行路由匹配，请求进入到相应匹配路由的 IRouteHandler。IRouteHandler 的唯一目的就是创建一个可以处理请求的 IHttpHandler。

如果 IRouteHandler 是 HttpControllerRouteHandler（Web API 路由），那么，被选择的 Web API 地址路径的请求将被终结在 HttpControllerRouteHandler。相反的，如果路由处理器是 MvcRouteHandler，那么，MVC 的地址路径由 MvcHandler 接管。

代码演示

这一部分要演示的是，ASP.NET MVC 和ASP.NET Web API 将运行在在同一个进程中，他们可以轻而易举的共享状态，例如，静态对象或者 Global.asax 事件。另外，配置文件 web.config 对于两个框架也是通用的。

清单 1-3 展示了两个Controller，MVC Controller 和 ASP.NET Web API Controller，他们可以在一个ASP.NET Web 应用程序共存。值得注意的是，因为他们在不同的命名空间中，所以他们设置可以使用相同的名称。此外，他们可以根据需要共享同一个 model（DTO），非常完美。

清单 1-3. 简单的 MVC 和 Web API 控制器

 public class Book
{
    public int Id { get; set; }
    public string Author { get; set; }
    public string Title { get; set; }
    public string Link { get; set; }
}
Namespace WebApplication.Controllers.Mvc
{
public class BooksController : Controller
{
public ActionResult Details(int id)
{
var book = Books.List.FirstOrDefault(x => x.Id == id);
if(book == null) return new HttpNotFoundResult();
return View(book);
}
}
}
namespace WebApplication.Controllers.WebApi
{
public class BooksController : ApiController
{
public Book GetById(int id)
{
var book = Books.List.FirstOrDefault(x => x.Id == id);
if (book == null) throw new HttpResponseException(HttpStatusCode.NotFound);
return book;
}
}
}

避免两个框架冲突的关键是谨慎惊醒路由设置，为了方便，默认情况下， ASP.NET Web API 将 /api 占位在 URI 下，这样，所有根级别的 URL 将被 MVC 处理。通常情况下，Web API 路由是被定义在 WebApiConfig静态类中，使用 HttpConfiguration 对象和他的 Route 属性。MVC 的路由被定义在 RouteConfig 静态类中，直接使用 System.Web.RouteCollection。两个框架路由的默认定义显示下，清单 1-4.

清单 1-4. Web API 和 MVC 的默认路由

 //Web API 路由配置
public static class WebApiConfig
{
public static void Register(HttpConfiguration config)
{
// Web API 配置和服务
// Web API 路由
config.MapHttpAttributeRoutes();
config.Routes.MapHttpRoute(
name: "DefaultApi",
routeTemplate: "api/{controller}/{id}",
defaults: new { id = RouteParameter.Optional }
);
}
}
//MVC 路由配置
public class RouteConfig
{
public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.MapRoute(
name: "Default",
url: "{controller}/{action}/{id}",
defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
);
}
}