前言
首先希望webapi支持多版本,swagger针对不同的版本可进行交互。多版本控制基于Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer包,swagger可以选择Swashbuckle.AspNetCore和nswag.AspNetCore.由于我们系统使用的是nswag所以继续沿用,当然Swashbuckle.AspNetCore也和不错,有时间再总结。
版本控制
1.导入相关nuget。Swashbuckle.AspNetCore,nswag.AspNetCore.
2.添加api多版本控制服务
2.1.首先是让项目支持多版本的服务添加
services.AddApiVersioning(option => { // 可选,为true时API返回支持的版本信息 option.ReportApiVersions = true; // 不提供版本时,默认为1.0 option.AssumeDefaultVersionWhenUnspecified = true; //版本信息放到header ,不写在不配置路由的情况下,版本信息放到response url 中 option.ApiVersionReader = new HeaderApiVersionReader("api-version"); // 请求中未指定版本时默认为1.0 option.DefaultApiVersion = new ApiVersion(1, 0); }).AddVersionedApiExplorer(option => { // 版本名的格式:v+版本号 option.GroupNameFormat = "'v'V"; option.AssumeDefaultVersionWhenUnspecified = true; }); ////获取webapi版本信息,用于swagger多版本支持 this.provider = services.BuildServiceProvider().GetRequiredService<IApiVersionDescriptionProvider>();
服务我们已经注入了,下面我们看一下怎么webapi多版本的支持
2.1.1.多版本的控制
1.QueryString
/// <summary> /// 用户管理API /// </summary> [ServiceFilter(typeof(LogFilterAttribute))] [ApiController] [Route("api/[controller]/[action]")] [ApiVersion("2.0")] public class UserController : ApiController {}
当我们注册服务时不加 option.ApiVersionReader = new HeaderApiVersionReader("api-version");那么版本信息就是通过url?api-version=2进行传递
2.header
/// <summary> /// 用户管理API /// </summary> [ServiceFilter(typeof(LogFilterAttribute))] [ApiController] [Route("api/[controller]/[action]")] [ApiVersion("2.0")] public class UserController : ApiController {}
如果不指定版本路由那么定义ApiVersionReader 则通过header传递
以上两种方式,默认版本(v1.0)均可不传递版本号
3.版本路由
/// <summary> /// 用户管理API /// </summary> [ServiceFilter(typeof(LogFilterAttribute))] [ApiController] [Route("api/v{version:apiVersion}/[controller]/[action]")] [Authorize] [ApiVersion("1.0")] [ApiVersion("2.0")] public class UserController : ApiController {}
这种方式很直观,但如果原有项目没有使用多版本控制不建议用,可采用header的方式更为合理一些,
2.1.2同一个 Controller支持多版本
增加多个 [ApiVersion("2.0")]即可。
/// <summary> /// 用户管理API /// </summary> [ServiceFilter(typeof(LogFilterAttribute))] [ApiController] [Route("api/v{version:apiVersion}/[controller]/[action]")] //[Authorize] [ApiVersion("1.0")] [ApiVersion("2.0")] public class UserController : ApiController {}
但是两个相同的版本中Controller不能有相同的方法。比如v1文件夹和v2文件的UserController都指向v2版本,是不能同时拥有GetList()的,但是如果我们想要v2中的GetList重写v1的GetList方法,其他的方法都继承过来怎么处理呢?
v1版本中的controller指定[ApiVersion("1.0")][ApiVersion("2.0")]
/// <summary> /// v1.用户管理API /// </summary> [ServiceFilter(typeof(LogFilterAttribute))] [ApiController] [Route("api/v{version:apiVersion}/[controller]/[action]")] //[Authorize] [ApiVersion("1.0")] [ApiVersion("2.0")] public class UserController : ApiController {}
v2版本中的controller指定[ApiVersion("2.0")]
/// <summary> /// v1.用户管理API /// </summary> [ServiceFilter(typeof(LogFilterAttribute))] [ApiController] [Route("api/v{version:apiVersion}/[controller]/[action]")] //[Authorize] [ApiVersion("2.0")] public class UserController : ApiController {}
v1版本中的GetList()方法 MapToApiVersion到v1即可
/// <summary> /// 获取用户列表 /// </summary> /// <returns></returns> [HttpGet,MapToApiVersion("1.0")] public NetResponse<List<User GetList() {}
这样以来v1与v2中的GetList就互不影响了。
3.注册nswag(AddOpenApiDocument和AddSwaggerDocument)
NSwag注入服务有两个方法:AddOpenApiDocument和AddSwaggerDocument,两者的区别就是架构类型不一样,AddOpenApiDocument的SchemaType使用的是OpenApi3,AddSwaggerDocument的SchemaType使用的是Swagger2:
我用的是AddSwaggerDocument
foreach (var description in provider.ApiVersionDescriptions) { services.AddSwaggerDocument(document => { document.OperationProcessors.Add(new OperationSecurityScopeProcessor("JWT token")); document.DocumentName = description.GroupName; document.Version = description.GroupName; document.ApiGroupNames = new string[] { description.GroupName }; //jwt 认证 document.AddSecurity("JWT token", Enumerable.Empty<string>(), new OpenApiSecurityScheme() { Type = OpenApiSecuritySchemeType.ApiKey, Name = nameof(Authorization), In = OpenApiSecurityApiKeyLocation.Header, Description = "将token值复制到如下格式: \nBearer {token}" } ); }); }
4,nswag中间件
app.UseOpenApi(); app.UseSwaggerUi3(setting => { });
是的我们做任何配置,如果你愿意其实有很多好玩的。但上面的配置方式足够多版本的控制与nswag交互。
免责声明:本站文章均来自网站采集或用户投稿,网站不提供任何软件下载或自行开发的软件! 如有用户或公司发现本站内容信息存在侵权行为,请邮件告知! 858582#qq.com
RTX 5090要首发 性能要翻倍!三星展示GDDR7显存
三星在GTC上展示了专为下一代游戏GPU设计的GDDR7内存。
首次推出的GDDR7内存模块密度为16GB,每个模块容量为2GB。其速度预设为32 Gbps(PAM3),但也可以降至28 Gbps,以提高产量和初始阶段的整体性能和成本效益。
据三星表示,GDDR7内存的能效将提高20%,同时工作电压仅为1.1V,低于标准的1.2V。通过采用更新的封装材料和优化的电路设计,使得在高速运行时的发热量降低,GDDR7的热阻比GDDR6降低了70%。
更新日志
- 关淑怡.2009-ERA【星娱乐】【WAV+CUE】
- 林忆莲《关于她的爱情故事》2022新世纪MQA 24K金碟限量版[WAV+CUE]
- 张雨生1993《一天到晚游泳的鱼》台湾G字首版[WAV+CUE][1G]
- 群星《试音五大女声》[WAV+CUE][1G]
- 魔兽世界wlk武器战一键输出宏是什么 wlk武器战一键输出宏介绍
- 魔兽世界wlk狂暴战一键输出宏是什么 wlk狂暴战一键输出宏介绍
- 魔兽世界wlk恶魔术士一键输出宏是什么 wlk恶魔术士一键输出宏介绍
- 医学爱好者狂喜:UP主把医学史做成了格斗游戏!
- PS5 Pro评分解禁!准备升级入手吗?
- 我们盘点了近期火热的国产单机游戏!《琉隐神渡》等 你期待哪款?
- 2019年第12届广州影音展双碟纪念版ADMS2CD[MP3/WAV]
- 黄安《救姻缘》台首版[WAV+CUE]
- 模拟之声慢刻CD《柏林之声4》[正版CD低速原抓WAV+CUE]
- 李宗盛 《李宗盛经典金曲》[WAV+CUE][1G]
- 周华健《粤语精选》[WAV+CUE][1G]