Swagger 2.0 -> OpenAPI 3.0 规范

在从Swagger 2.0规范迁移到OpenAPI 3.0规范时,上述注解分别需要改为以下内容:

原Swagger 2.0注解 OpenAPI 3.0对应注解 说明
@Api @Tag @Api用于对控制器类进行分组和描述,@Tag在OpenAPI 3.0中功能类似,用于标记一组相关的API操作,可添加名称和描述
@ApiModel @Schema @ApiModel用于描述数据模型,@Schema在OpenAPI 3.0中同样用于描述数据模型,可添加描述等信息
@ApiModelProperty @Schema @ApiModelProperty用于描述数据模型中的字段属性,在OpenAPI 3.0中,@Schema也可用于描述模型字段,指定字段的描述、示例值等
@ApiOperation @Operation @ApiOperation用于描述控制器方法(API操作),@Operation在OpenAPI 3.0中用于对API操作进行说明,可设置摘要、描述等属性
posted @   XYu1230  阅读(13)  评论(0编辑  收藏  举报
相关博文:
阅读排行:
· DeepSeek 开源周回顾「GitHub 热点速览」
· 物流快递公司核心技术能力-地址解析分单基础技术分享
· .NET 10首个预览版发布:重大改进与新特性概览!
· AI与.NET技术实操系列(二):开始使用ML.NET
· .NET10 - 预览版1新功能体验(一)
点击右上角即可分享
微信分享提示