[水煮 ASP.NET Web API2 方法论](1-4)从 MVC Controller 链接到 API Controller 以及反向链接
问题
想创建一个从 ASP.NETMVC controller 到 ASP.NET Web API controller 的直接链接,或者反向链接。
解决方案
可以使用 System.Web.Http.Routing.UrlHelp 的实例来创建一个指向 Controller的链接,来暴露 ApiController(作为 Url 属性)。着和在 RequestContext 上一样,会被附加到 HttpRequestMessage 实例。为了达到这个目的,我们需要调用链接方法或路由方法,然后传入 MVC 路由的名称和默认路由(Controller 名字,Action名字,以及 Action 相关的参数)。
在 MVC Controller 这边,System.Web.Mvc.UrlHelp,挂在基础 MVC 基础 Controller类,可以通过 HttpRouteUrl 生成 Web API 链接
工作原理
当使用 ASP.NET Web API 作为现有 MVC 应用程序一部分的时候,有一种很常见的需求,就是在两种类型的 Controller 之间可以互相链接。当我们从 Web API 上创建一个到MVC Controller 的链接的时候,实际上使用的方法和创建两个 Web API Controller 之间链接的方法完全相同:UrlHelper 中的链接或者路由。链接和路由生成的链接还是有一些区别的,
链接方法将会生成一个绝对链接
路由方法生成的是一个相对链接。
反过来,我们从 MVC 链接到 Web API的时候,HttpRouteUrl 并不是 ASP.NET Web API 程序集的扩展方法,而是 UrlHelper 类的成员,在System.Web.Mvc 中。这个 Helper 使用了一个私有的常量叫做 httproute,每次使用 HttpRouteUrl 的时候,他都会被添加到 RouteValueDictionray 中。
注意 我们将会在 3-12 的时候深入学习和理解引擎生成链接到路由背后的故事。
代码演示
假设一个简单的关于书籍的 Web 应用程序。如清单 1-10 所示的简单的 Book 模型,存储使用的是内存, 配置了API/MVC 路由。这个例子的目的是,在 Web API 和 MVC 控制器之间,完美的使用同一个模型。我们将使用在这个清单中的伪数据来说明 Web API 和 MVC 之间互相链接的情况。
清单 1-10. 模型案例,路由和内存存储
publicclassBook{publicintId{get;set;}publicstringAuthor{get;set;}publicstringTitle{get;set;}publicstringLink{get;set;}}publicstaticclassBooks{publicstaticList<Book>List=newList<Book>{newBook{Id=1,Author="JohnRobb",Title="PunkRock:AnOralHistory"},newBook{Id=2,Author="DanielMohl",Title="BuildingWeb,Cloud,andMobileSolutionswithF#"},newBook{Id=3,Author="SteveClarke",Title="100ThingsBlueJaysFansShouldKnow&DoBeforeTheyDie"},newBook{Id=4,Author="MarkFrank",Title="CubanRevelations:BehindtheScenesinHavana"}};}publicclassRouteConfig{publicstaticvoidRegisterRoutes(RouteCollectionroutes){routes.IgnoreRoute("{resource}.axd/{*pathInfo}");routes.MapRoute(name:"BookPage",url:"books/details/{id}",defaults:new{controller="BooksPage",action="Details"});}}publicstaticclassWebApiConfig{publicstaticvoidRegister(HttpConfigurationconfig){config.Routes.MapHttpRoute(name:"DefaultApi",routeTemplate:"api/{controller}/{id}",defaults:new{id=RouteParameter.Optional});}}
如清单 1-11 所示,这段代码是为了创建一个从 Web API 到 MVC Controller 的链接。BooksPageController 负责处理书籍。为了生成链接,我们可以调用 UrlHelper 的链接方法,然后传相关路由的值。
清单 1-11 ASP.NET Web APIApiController 链接到 MVC Controller
publicclassBooksController:ApiController{publicBookGetById(intid){varbook=Books.List.FirstOrDefault(x=>x.Id==id);if(book==null)thrownewHttpResponseException(HttpStatusCode.NotFound);book.Link=Url.Link("BookPage",new{controller="BooksPage",action="Details",id});returnbook;}
反方向的链接,如清单 1-12 所示,从 MVC Controller 到 ApiController。在这样的情况下,使用一个 MVC 特定的方法-UrlHelper,他是由 HttpRouteUrl 扩展的方法。
清单 1-12. 从 MVC Controller 链接到ASP.NET Web API
publicclassBooksPageController:Controller{publicActionResultDetails(intid){varbook=Books.List.FirstOrDefault(x=>x.Id==id);if(book==null)returnnewHttpNotFoundResult();book.Link=Url.HttpRouteUrl("DefaultApi",new{controller="Books",id});returnView(book);}}
声明:本站所有文章资源内容,如无特殊说明或标注,均为采集网络资源。如若本站内容侵犯了原著者的合法权益,可联系本站删除。