0、目录
整体架构目录：ASP.NET Core分布式项目实战-目录
一、前言
在开发项目的过程中，我新创建了一个controller，发现vs会给我们直接在controller头添加前缀，比如[Route("api/[controller]")],即在访问接口的时候会变成http://localhost:8000/api/values，但是如果控制器有很多个，或者要进行版本迭代时，我们会发现痛苦的时刻降临了，要一个一个的修改。
如果在这个时候可以进行全局配置前缀那真是福利呀，修改一处即可。为了能达到此目的我们就来运用一下吧。
二、配置
0、在配置前我们先来看看接口的前缀吧。立图为证
用swagger打开
1、我们需要用到 IApplicationModelConvention 这个接口，它是位于 Microsoft.AspNetCore.Mvc.ApplicationModels 命令空间下面。
MVC框架有一些约定俗成的东西，这个接口主就是用来定义一些MVC约定的东西。我们就可以通过 Apply方法中的 ApplicationModel 来修改或者添加一些约定，而且MV框架本身在启动的时候会把此接口注入，以便于我们使用。
不过我们还是要来看一下这个ApplicationModel 对象里面有什么我们可以用到的地方，我们继续深入：
看到这是不是很爽，我们可以看一下 每个属性的给出的解释
ApiExplorerModel:包括描述信息，群组信息，可见性等。
ControllerModel：主要是 Comtroller 默认约定相关的了，这个里面东西就比较多了，有 控制器名称、路由值、Actions等，我们接下去的配置也将会在此展开
IFilterMetadata ：空接口，主要起到标记的作用。
2、配置
第一步：先定义一个类，用来实现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)
{
// 1、已经标记了 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);
}
}
//2、 没有标记 RouteAttribute 的 Controller
var unmatchedSelectors = controller.Selectors.Where(x => x.AttributeRouteModel == null).ToList();
if (unmatchedSelectors.Any())
{
foreach (var selectorModel in unmatchedSelectors)
{
// 添加一个 路由前缀
selectorModel.AttributeRouteModel = _centralPrefix;
}
}
}
}
}
复制代码
此处代码需要注意下，上面代码分为两部分，一部分是控制器有路由配置，一部分是没有路由配置。因此需要根据具体的情况来选择使用。
第二步：添加上面后，我们就定义一个类来插入我们的路由吧。
定义MvcOptionsExtensions.cs，此方法主要是扩展了MVCoptions类
复制代码
public static class MvcOptionsExtensions
{
///
/// 扩展方法
///
///
///
public static void UseCentralRoutePrefix(this MvcOptions opts, IRouteTemplateProvider routeAttribute)
{
// 添加我们自定义 实现IApplicationModelConvention的RouteConvention
opts.Conventions.Insert(0, new RouteConvention(routeAttribute));
}
}
复制代码
说明：routeAttribute 为我们自定的前缀内容。
第三步：在startup.cs 里面ConfigureServices 方法添加配置信息
复制代码
#region 配置全局路由
//在各个控制器添加前缀（没有特定的路由前面添加前缀）
services.AddMvc(opt =>
{
opt.UseCentralRoutePrefix(new RouteAttribute("lg/v1/[action]"));
//opt.UseCentralRoutePrefix(new RouteAttribute("api/[controller]/[action]"));
});
#endregion
复制代码
说明：上面的方括号在这边是有效的。其中内容可以自定义。
第四步：运行
1、原先控制器路由前缀保留
2、把原先的路由前缀去除
三、总结
至此，已很好的实现全局路由配置前缀啦。可以开心的玩耍啦。
github代码地址：github
asp.net Core 交流群：787464275 欢迎加群交流
如果您认为这篇文章还不错或者有所收获，您可以点击右下角的【推荐】按钮精神支持，因为这种支持是我继续写作，分享的最大动力！
作者：LouieGuo
微信公众号：欢迎关注 QQ技术交流群： 欢迎加群
LouieGuo
标签: asp.net core
好文要顶 关注我 收藏该文
LouieGuo
关注 - 65
粉丝 - 27
+加关注
3 0
« 上一篇：CentOS服务器安装Telnet来远程连接服务器
posted @ 2018-09-20 14:47 LouieGuo 阅读(272) 评论(3) 编辑 收藏
0、目录
整体架构目录：ASP.NET Core分布式项目实战-目录
一、前言
在开发项目的过程中，我新创建了一个controller，发现vs会给我们直接在controller头添加前缀，比如[Route("api/[controller]")],即在访问接口的时候会变成http://localhost:8000/api/values，但是如果控制器有很多个，或者要进行版本迭代时，我们会发现痛苦的时刻降临了，要一个一个的修改。
如果在这个时候可以进行全局配置前缀那真是福利呀，修改一处即可。为了能达到此目的我们就来运用一下吧。
二、配置
0、在配置前我们先来看看接口的前缀吧。立图为证
用swagger打开
1、我们需要用到 IApplicationModelConvention 这个接口，它是位于 Microsoft.AspNetCore.Mvc.ApplicationModels 命令空间下面。
MVC框架有一些约定俗成的东西，这个接口主就是用来定义一些MVC约定的东西。我们就可以通过 Apply方法中的 ApplicationModel 来修改或者添加一些约定，而且MV框架本身在启动的时候会把此接口注入，以便于我们使用。
不过我们还是要来看一下这个ApplicationModel 对象里面有什么我们可以用到的地方，我们继续深入：
看到这是不是很爽，我们可以看一下 每个属性的给出的解释
ApiExplorerModel:包括描述信息，群组信息，可见性等。
ControllerModel：主要是 Comtroller 默认约定相关的了，这个里面东西就比较多了，有 控制器名称、路由值、Actions等，我们接下去的配置也将会在此展开
IFilterMetadata ：空接口，主要起到标记的作用。
2、配置
第一步：先定义一个类，用来实现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)
{
// 1、已经标记了 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);
}
}
//2、 没有标记 RouteAttribute 的 Controller
var unmatchedSelectors = controller.Selectors.Where(x => x.AttributeRouteModel == null).ToList();
if (unmatchedSelectors.Any())
{
foreach (var selectorModel in unmatchedSelectors)
{
// 添加一个 路由前缀
selectorModel.AttributeRouteModel = _centralPrefix;
}
}
}
}
}
复制代码
此处代码需要注意下，上面代码分为两部分，一部分是控制器有路由配置，一部分是没有路由配置。因此需要根据具体的情况来选择使用。
第二步：添加上面后，我们就定义一个类来插入我们的路由吧。
定义MvcOptionsExtensions.cs，此方法主要是扩展了MVCoptions类
复制代码
public static class MvcOptionsExtensions
{
///
/// 扩展方法
///
///
///
public static void UseCentralRoutePrefix(this MvcOptions opts, IRouteTemplateProvider routeAttribute)
{
// 添加我们自定义 实现IApplicationModelConvention的RouteConvention
opts.Conventions.Insert(0, new RouteConvention(routeAttribute));
}
}
复制代码
说明：routeAttribute 为我们自定的前缀内容。
第三步：在startup.cs 里面ConfigureServices 方法添加配置信息
复制代码
#region 配置全局路由
//在各个控制器添加前缀（没有特定的路由前面添加前缀）
services.AddMvc(opt =>
{
opt.UseCentralRoutePrefix(new RouteAttribute("lg/v1/[action]"));
//opt.UseCentralRoutePrefix(new RouteAttribute("api/[controller]/[action]"));
});
#endregion
复制代码
说明：上面的方括号在这边是有效的。其中内容可以自定义。
第四步：运行
1、原先控制器路由前缀保留
2、把原先的路由前缀去除
三、总结
至此，已很好的实现全局路由配置前缀啦。可以开心的玩耍啦。
github代码地址：github
asp.net Core 交流群：787464275 欢迎加群交流
如果您认为这篇文章还不错或者有所收获，您可以点击右下角的【推荐】按钮精神支持，因为这种支持是我继续写作，分享的最大动力！
作者：LouieGuo
微信公众号：欢迎关注 QQ技术交流群： 欢迎加群
LouieGuo
标签: asp.net core
好文要顶 关注我 收藏该文
LouieGuo
关注 - 65
粉丝 - 27
+加关注
3 0
« 上一篇：CentOS服务器安装Telnet来远程连接服务器
posted @ 2018-09-20 14:47 LouieGuo 阅读(272) 评论(3) 编辑 收藏
https://www.cnblogs.com/guolianyu/p/9680899.html
