ASP.NET Core MVC 配置全局路由前缀

更新时间：2016年09月22日 09:57:52 作者：Savorboard

这篇文章主要介绍了ASP.NET Core MVC 配置全局路由前缀的相关资料,需要的朋友可以参考下

ASP.NET Core MVC 配置全局路由前缀

前言

大家好，今天给大家介绍一个 ASP.NET Core MVC 的一个新特性，给全局路由添加统一前缀。严格说其实不算是新特性，不过是Core MVC特有的。

应用背景

不知道大家在做 Web Api 应用程序的时候，有没有遇到过这种场景，就是所有的接口都是以 /api 开头的，也就是我们的api 接口请求地址是像这样的：

http://www.example.com/api/order/333

或者是这样的需求

http://www.example.com/api/v2/order/333

在以前，我们如果要实现这种需求，可以在 Controller 中添加一个 [Route("/api/order")] 这样的特性路由 Attribute，然后MVC 框架就会扫描你的路由表从而可以匹配到 /api/order 这样的请求。

但是第二个带版本号的需求，原本 Controller 的 Route 定义是 [Route("/api/v1/order")]，现在要升级到v2，又有上百个接口，这就需要一个一个修改，可能就会懵逼了。

现在，有一种更加简便优雅的方式来做这个事情了，你可以统一的来添加一个全局的前缀路由标记，下面就一起来看看吧。

IApplicationModelConvention 接口

首先，我们需要使用到 IApplicationModelConvention这个接口，位于 Microsoft.AspNetCore.Mvc.ApplicationModels 命名空间下，我们来看一下接口的定义。

public interface IApplicationModelConvention
{
 void Apply(ApplicationModel application);
}

我们知道，MVC 框架有一些约定俗成的东西，那么这个接口就是主要是用来自定义一些 MVC 约定的一些东西的，我们可以通过指定 ApplicationModel 对象来添加或者修改一些约定。可以看到接口提供了一个 Apply的方法，这个方法有一个ApplicationModel对象，我们可以利用这个对象来修改我们需要的东西，MVC 框架本身在启动的时候会注入这个接口到 Services 中，所以我们只需要实现这个接口，然后稍加配置即可。

那再让我们看一下ApplicationModel 这个对象都有哪些东西：

public class ApplicationModel : IPropertyModel, IFilterModel, IApiExplorerModel
{
 public ApiExplorerModel ApiExplorer { get; set; }
 public IList<ControllerModel> Controllers { get; }
 public IList<IFilterMetadata> Filters { get; }

 public IDictionary<object, object> Properties { get; }
}

可以看到有 ApiExplorer,Controllers,Filters,Properties 等属性。

ApiExplorerModel：主要是配置默认MVC Api Explorer的一些东西，包括Api的描述信息，组信息，可见性等。
ControllerModel：主要是 Comtroller 默认约定相关的了，这个里面东西就比较多了，就不一一介绍了，我们等下就要配置里面的一个东西。
IFilterMetadata ：空接口，主要起到标记的作用。

还有一个地方需要告诉大家的是，可以看到上面的 Controllers 属性它是一个IList<ControllerModel>，也就是说这个列表中记录了你程序中的所有 Controller 的信息，你可以通过遍历的方式针对某一部分或某个 Controller 进行设置，包括Controller中的Actions的信息都可以通过此种方式来设置，我们可以利用这个特性来非常灵活的对 MVC 框架进行改造，是不是很炫酷。

下面，我们就利用这个特性来实现我们今天的主题。谢谢你点的赞~ :)

添加全局路由统一前缀

没有那么多废话了，直接上代码，要说的话全在代码里：

//定义个类RouteConvention，来实现 IApplicationModelConvention 接口
public class RouteConvention : IApplicationModelConvention
{
 private readonly AttributeRouteModel _centralPrefix;

 public RouteConvention(IRouteTemplateProvider routeTemplateProvider)
 {
  _centralPrefix = new AttributeRouteModel(routeTemplateProvider);
 }

 //接口的Apply方法
 public void Apply(ApplicationModel application)
 {
  //遍历所有的 Controller
  foreach (var controller in application.Controllers)
  {
   // 已经标记了 RouteAttribute 的 Controller
   var matchedSelectors = controller.Selectors.Where(x => x.AttributeRouteModel != null).ToList();
   if (matchedSelectors.Any())
   {
    foreach (var selectorModel in matchedSelectors)
    {
     // 在 当前路由上 再 添加一个 路由前缀
     selectorModel.AttributeRouteModel = AttributeRouteModel.CombineAttributeRouteModel(_centralPrefix,
      selectorModel.AttributeRouteModel);
    }
   }

   // 没有标记 RouteAttribute 的 Controller
   var unmatchedSelectors = controller.Selectors.Where(x => x.AttributeRouteModel == null).ToList();
   if (unmatchedSelectors.Any())
   {
    foreach (var selectorModel in unmatchedSelectors)
    {
     // 添加一个 路由前缀
     selectorModel.AttributeRouteModel = _centralPrefix;
    }
   }
  }
 }
}

然后，我们就可以开始使用我们自己定义的这个类了。

public static class MvcOptionsExtensions
{
 public static void UseCentralRoutePrefix(this MvcOptions opts, IRouteTemplateProvider routeAttribute)
 {
  // 添加我们自定义 实现IApplicationModelConvention的RouteConvention
  opts.Conventions.Insert(0, new RouteConvention(routeAttribute));
 }
}

最后，在 Startup.cs 文件中，添加上面的扩展方法就可以了。

public class Startup
{
 public Startup(IHostingEnvironment env)
 {
  //...
 }

 public void ConfigureServices(IServiceCollection services)
 {
  //...
  
  services.AddMvc(opt =>
  {
   // 路由参数在此处仍然是有效的，比如添加一个版本号
   opt.UseCentralRoutePrefix(new RouteAttribute("api/v{version}"));
  });
 }

 public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
 {
  //...
  
  app.UseMvc();
 }
}

其中，opt.UseCentralRoutePrefix 就是上面定义的那个扩展方法，此处路由参数仍然是可以使用的，所以比如你可以给你的接口指定一个版本号之类的东西。这样之后，你的所有 Controller 的 RoteAttribute 都会添加上了这个前缀，这样就完美解决了最开始的那个版本号的需求。他们看起来大概是这样的：

[Route("order")]
public class OrderController : Controller
{
 // 路由地址 : /api/v{version}/order/details/{id}
 [Route("details/{id}")]
 public string GetById(int id, int version)
 {
  //上面是可以接收到版本号的，返回 version 和 id
  return $"other resource: {id}, version: {version}";
 }
}

public class ItemController : Controller
{
 // 路由地址： /api/v{version}/item/{id}
 [Route("item/{id}")]
 public string GetById(int id, int version)
 {
  //上面是可以接收到版本号的，返回 version 和 id
  return $"item: {id}, version: {version}";
 }
}

总结

上面的黑体字，希望大家能够理解并运用，这个例子只是实际需求中的很小的一个场景，在具体的项目中会有各种各样正常或者非正常的需求，我们在做一个功能的时候要多多思考，其实 MVC 框架还有很多东西可以去学习，包括它的设计思想，扩展性等东西，都是需要慢慢领悟的。如果大家对 ASP.NET Core 感兴趣，可以关注我一下，我会定期在博客中分享我的一些学习成果吧。

通过此文希望能帮助大家，谢谢大家对本站的支持！

您可能感兴趣的文章:

.Net判断一个对象是否为数值类型实例
这篇文章主要介绍了.Net判断一个对象是否为数值类型的方法,实例讲述了一个国外的示例并对其进行了改进,非常实用,需要的朋友可以参考下
2014-10-10
ASP.NET显示农历时间改进版
这篇文章主要介绍了ASP.NET显示农历时间改进版,是针对前面一篇ASP.NET显示农历时间的改进版,实现了比较简单的封装,增加了易用性,非常具有实用价值,需要的朋友可以参考下
2014-11-11
查看Json输出的*最方便*的方法 (转)
项目的表现层使用MVC+Extjs。在开发过程中，一旦页面显示不正常，第一个需要排查的总是“Action是否输出了正确的Json？”。
2009-11-11
ASP.NET获取URL方法汇总
本文主要介绍ASP.NET获取URL的各种方法，希望能给需要的朋友一些帮助。
2016-04-04
在ASP.NET Core中显示自定义的错误页面
大家在用浏览器访问服务器时，不同情况下会返回不同的信息。服务器发生错误就会返回错误信息，我们最熟悉的就是404错误页面，但是这里我想和大家分享下在ASP.NET Core中如何显示自定义的500或404错误页面，有需要的朋友们可以参考借鉴，下面来一起看看吧。
2016-12-12
灵活掌握Asp.net MVC中GridView的使用方法
这篇文章主要帮助大家灵活掌握Asp.net MVC中GridView的使用方法,具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2016-11-11
Asp.net FileUpload+Image制作头像效果示例代码
个人信息中通常需要自己的头像或者照片，今天主要介绍一下使用FileUpload+img控件上传照片，感兴趣的朋友可以参考下
2013-08-08
WPF实现左右移动（晃动）动画效果
这篇文章主要为大家详细介绍了WPF实现左右移动或晃动动画效果，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-12-12
ASP.NET Core为Ocelot网关配置Swagger
这篇文章介绍了ASP.NET Core为Ocelot网关配置Swagger的方法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-04-04
使用.NET 6开发TodoList应用之领域实体创建原理和思路
虽然TodoList是一个很简单的应用，业务逻辑并不复杂，至少在这个系列文章中我并不想使其过度复杂，接下来通过本文给大家介绍使用.NET 6开发TodoList应用之领域实体创建思路及原理,需要的朋友可以参考下
2021-12-12

ASP.NET Core MVC 配置全局路由前缀

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具