asp.net core webapi项目配置全局路由的方法示例

一、前言

在开发项目的过程中，我新创建了一个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  接口。

/// <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)
      {
        // 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
  {
    /// <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

说明：上面的方括号在这边是有效的。其中内容可以自定义。

第四步：运行

1、原先控制器路由前缀保留

2、把原先的路由前缀去除

三、总结

至此，已很好的实现全局路由配置前缀啦。可以开心的玩耍啦。

github代码地址：github

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。