ASP.NET Core3.x API版本控制的实现

选择版本控制策略并在ConfigureServices方法中对其配置后，我们可以开始对API端点进行版本控制，我们可以将这些属性应用于控制器和方法。

控制器的默认可能没有任何API版本属性，并隐式配置的默认API版本。默认配置使用值1.0。 使用[ApiVersion("1.0")]属性注释我们的控制器，意味着该控制器支持API版本1.0 控制器可以支持多个API版本。只需[ApiVersion(...)]在控制器上应用多个属性 为了区分控制器支持的多个版本，我们使用[MapToApiVersion()]属性注释控制器方法。

如果要使用URL路径则可以参考如下代码片段：

[Route("api/v{version:apiVersion}/[controller]")]

API控制器弃用，我们只需要设置

[ApiVersion("1.0", Deprecated = true)]

可通过如下方法方式获取所有API版本信息

var apiVersion = HttpContext.GetRequestedApiVersion();

当然他还支持模型绑定，我们还可以通过模型形式获取

 [HttpGet]
  public string Get(ApiVersion apiVersion) => $"Controller = {GetType().Name}nVersion = {apiVersion}";
  }

API版本约束

我们除了在方法和控制器上指定我们的版本，我们还可以采用另一种方式

services.AddApiVersioning( options =>
{
  options.Conventions.Controller<HomeController>().HasApiVersion(1, 0);
});

看如上代码我们可以看到我们在这里给HomeController配置版本，这样方便我们集中管理我们的版本。

services.AddApiVersioning( options =>
{
  options.Conventions.Controller<MyController>()  
            .HasDeprecatedApiVersion(1, 0)
            .HasApiVersion(1, 1)
            .HasApiVersion(2, 0)
            .Action(c => c.Get1_0()).MapToApiVersion(1, 0)
            .Action(c => c.Get1_1()).MapToApiVersion(1, 1)
            .Action(c => c.Get2_0()).MapToApiVersion(2, 0);
});

可以同时使用API版本约束和版本控制属性。

当然我们还可以自定义约束，从.NET Core 3.0开始，有一个IControllerConvention用于此目的的接口。

options.Conventions.Add(new MyCustomConvention());

当然我们还可以通过不同命名空间中的接口进行约束

options.Conventions.Add(new VersionByNamespaceConvention());

比如下面这种文件形式

api/v1/UsersController
api/v2/UsersController
api/v2_1/UsersController

映射后的路径如下所示

api/1.0/users
api/2.0/users
api/2.1/users

到此这篇关于ASP.NET Core3.x API版本控制的实现的文章就介绍到这了,更多相关ASP.NET Core3.x API版本控制内容请搜索易采站长站以前的文章或继续浏览下面的相关文章希望大家以后多多支持易采站长站！