互联网技术 · 2024年2月20日 0

netcorewebapi的多版本控制和swagger(nswag)配置指南

这篇文章主要介绍了net core webapi多版本控制与*ger(n*)配置,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下

前言

版本控制

前言

首先希望webapi支持多版本,*ger针对不同的版本可进行交互。多版本控制基于Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer包,*ger可以选择Swashbuckle.AspNetCore和n*.AspNetCore.由于我们系统使用的是n*所以继续沿用,当然Swashbuckle.AspNetCore也和不错,有时间再总结。

版本控制

1.导入相关nuget。Swashbuckle.AspNetCore,n*.AspNetCore.

2.添加api多版本控制服务

2.1.首先是让项目支持多版本的服务添加

服务我们已经注入了,下面我们看一下怎么webapi多版本的支持

2.1.1.多版本的控制

1.QueryString

2.header

以上两种方式,默认版本(v1.0)均可不传递版本号

3.版本路由

这种方式很直观,但如果原有项目没有使用多版本控制不建议用,可采用header的方式更为合理一些,

2.1.2同一个 Controller支持多版本

但是两个相同的版本中Controller不能有相同的方法。比如v1文件夹和v2文件的UserController都指向v2版本,是不能同时拥有GetList()的,但是如果我们想要v2中的GetList重写v1的GetList方法,其他的方法都继承过来怎么处理呢?

这样以来v1与v2中的GetList就互不影响了。

3.注册n*(AddOpenApiDocument和AddSwaggerDocument)

NSwag注入服务有两个方法:AddOpenApiDocument和AddSwaggerDocument,两者的区别就是架构类型不一样,AddOpenApiDocument的SchemaType使用的是OpenApi3,AddSwaggerDocument的SchemaType使用的是Swagger2:

4,n*中间件

是的我们做任何配置,如果你愿意其实有很多好玩的。但上面的配置方式足够多版本的控制与n*交互。

到此这篇关于net core webapi多版本控制与*ger(n*)配置教程的文章就介绍到这了,更多相关net core webapi多版本控制内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

来源:脚本之家