asp.net core webapi項目配置全局路由

0、目錄

---

 總體架構目錄：ASP.NET Core分佈式項目實戰-目錄

1、前言

---

 在開發項目的過程當中，我新建立了一個controller，發現vs會給咱們直接在controller頭添加前綴，好比[Route("api/[controller]")],即在訪問接口的時候會變成http://localhost:8000/api/values，可是若是控制器有不少個，或者要進行版本迭代時，咱們會發現痛苦的時刻降臨了，要一個一個的修改。

若是在這個時候能夠進行全局配置前綴那真是福利呀，修改一處便可。爲了能達到此目的咱們就來運用一下吧。

 

2、配置

---

 0、在配置前咱們先來看看接口的前綴吧。立圖爲證 

用swagger打開

 

一、咱們須要用到 IApplicationModelConvention  這個接口，它是位於 Microsoft.AspNetCore.Mvc.ApplicationModels 命令空間下面。

 

MVC框架有一些約定俗成的東西，這個接口主就是用來定義一些MVC約定的東西。咱們就能夠經過 Apply方法中的 ApplicationModel  來修改或者添加一些約定，並且MV框架自己在啓動的時候會把此接口注入，以便於咱們使用。

不過咱們仍是要來看一下這個ApplicationModel  對象裏面有什麼咱們能夠用到的地方，咱們繼續深刻：

 

看到這是否是很爽，咱們能夠看一下 每一個屬性的給出的解釋

ApiExplorerModel:包括描述信息，羣組信息，可見性等。

ControllerModel：主要是 Comtroller 默認約定相關的了，這個裏面東西就比較多了，有 控制器名稱、路由值、Actions等，咱們接下去的配置也將會在此展開

IFilterMetadata ：空接口，主要起到標記的做用。

 

二、配置

第一步：先定義一個類，用來實現IApplicationModelConvention  接口。

/// <summary>
    /// 全局路由前綴配置
    /// </summary>
    public class RouteConvention : IApplicationModelConvention
    {
        /// <summary>
        /// 定義一個路由前綴變量
        /// </summary>
        private readonly AttributeRouteModel _centralPrefix;
        /// <summary>
        /// 調用時傳入指定的路由前綴
        /// </summary>
        /// <param name="routeTemplateProvider"></param>
        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;
                    }
                }
            }
        }
    }

 

此處代碼須要注意下，上面代碼分爲兩部分，一部分是控制器有路由配置，一部分是沒有路由配置。所以須要根據具體的狀況來選擇使用。

 

第二步：添加上面後，咱們就定義一個類來插入咱們的路由吧。

定義MvcOptionsExtensions.cs，此方法主要是擴展了MVCoptions類

public static class MvcOptionsExtensions
    {
        /// <summary>
        /// 擴展方法
        /// </summary>
        /// <param name="opts"></param>
        /// <param name="routeAttribute"></param>
        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

 

說明：上面的方括號在這邊是有效的。其中內容能夠自定義。

 

第四步：運行

一、原先控制器路由前綴保留

 

 

二、把原先的路由前綴去除

 

3、總結

---

 至此，已很好的實現全局路由配置前綴啦。能夠開心的玩耍啦。

 

 github代碼地址：github

asp.net Core 交流羣：787464275 歡迎加羣交流
若是您認爲這篇文章還不錯或者有所收穫，您能夠點擊右下角的【推薦】按鈕精神支持，由於這種支持是我繼續寫做，分享的最大動力！

做者：LouieGuo

微信公衆號：歡迎關注                                                 QQ技術交流羣： 歡迎加羣