欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

ASP.NET Core WebApi版本控制的实现

程序员文章站 2022-04-23 20:09:19
前言: 在日常项目开发中,随着项目需求不断的累加、不断的迭代;项目服务接口需要向下兼容历史版本;前些时候就因为api接口为做版本管理导致接口对低版本兼容处理不友好。 最近就像了解下如何实现webapi...

前言:

 在日常项目开发中,随着项目需求不断的累加、不断的迭代;项目服务接口需要向下兼容历史版本;前些时候就因为api接口为做版本管理导致接口对低版本兼容处理不友好。

 最近就像了解下如何实现webapi版本控制,那么版本控制有什么好处呢?

 webapi版本控制的好处

  • 有助于及时推出功能, 而不会破坏现有系统,兼容性处理更友好。
  • 它还可以帮助为选定的客户提供额外的功能。

 接下来就来实现版本控制以及在swagger ui中接入webapi版本

一、webapi版本控制实现 

 通过microsoft.aspnetcore.mvc.versioning实现webapi 版本控制

创建webapi项目,添加nuget包:microsoft.aspnetcore.mvc.versioning

修改项目startup文件,使用microsoft.aspnetcore.mvc.versioning

webapi设置版本:

  a)通过apiversion标记指定指定控制器或方法的版本号;url参数控制版本(querystringapiversionreader),如下:

  通过参数api-version参数指定版本号;调用结果:

ASP.NET Core WebApi版本控制的实现

ASP.NET Core WebApi版本控制的实现

  b)通过url path segment控制版本号(urlsegmentapiversionreader):为控制器添加路由方式如下,apiversion为固定格式  

  调用方式:通过调用路径传入版本号,如:http://localhost:5000/api/v1/weatherforecast

ASP.NET Core WebApi版本控制的实现

  c)通过header头控制版本号:在startup中设置(headerapiversionreader、mediatypeapiversionreader)

  调用方式,在请求头或中mediatype中传递api版本,如下:

ASP.NET Core WebApi版本控制的实现

ASP.NET Core WebApi版本控制的实现

其他说明:

    a)reportapiversions设置为true时, 返回当前支持版本号(api-supported-versions);deprecated 参数设置为true表示已弃用,在响应头中也有显示(api-deprecated-versions):

ASP.NET Core WebApi版本控制的实现

    b)maptoapiversion标记:允许将单个api操作映射到任何版本(可以在v1的控制器中添加v3的方法);在上面控制器中添加以下代码,访问v3版本方法

ASP.NET Core WebApi版本控制的实现

   c)注意事项:

    1、路径中参数版本高于,其他方式设置版本

    2、多种方式传递版本,只能采用一种方式传递版本号

    3、swaggerui中maptoapiversion设置版本不会单独显示    

二、swagger ui中版本接入

 1、添加包:swashbuckle.aspnetcore、microsoft.aspnetcore.mvc.versioning.apiexplorer  

 2、修改startup代码:

 3、运行效果:  

ASP.NET Core WebApi版本控制的实现

其他: 

 示例地址:https://github.com/cwsheng/webapiversiondemo

到此这篇关于asp.net core webapi版本控制的实现的文章就介绍到这了,更多相关asp.net core webapi版本控制内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!