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 感兴趣,可以关注我一下,我会定期在博客中分享我的一些学习成果吧。
通过此文希望能帮助大家,谢谢大家对本站的支持!
上一篇: 一个支持普通分页和综合分页的MVC分页Helper
下一篇: Yii2框架中一些折磨人的坑