swagger3注解用法详解.使用文档

最新推荐文章于 2024-08-21 16:19:08 发布

NuiiQK

最新推荐文章于 2024-08-21 16:19:08 发布

阅读量2.5k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： swagger java springboot 文章标签： java

本文链接：https://blog.youkuaiyun.com/weixin_43841924/article/details/132664650

本文详细介绍了如何从Swagger2注解迁移到Swagger3注解，包括SpringfoxBootStarter的版本更新，以及主要的迁移规则和示例变化，如@Api→@Tag，@ApiModelProperty→@Schema等。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

swagger2注解

@Api：修饰整个类，描述Controller的作用
@ApiOperation：描述一个类的一个方法，或者说一个接口
@ApiParam：单个参数描述
 
@ApiModel：用对象来接收参数
@ApiProperty：用对象接收参数时，描述对象的一个字段
 
 
其它若干
@ApiResponse：HTTP响应其中1个描述
 
@ApiResponses：HTTP响应整体描述
 
@ApiClass
 
@ApiError
 
@ApiErrors
 
@ApiParamImplicit
 
@ApiParamsImplicit