swagger3 ui 常用注解

最新推荐文章于 2025-04-14 16:13:24 发布

wyyybf

最新推荐文章于 2025-04-14 16:13:24 发布

阅读量861

点赞数 2

文章标签： java swagger swagger3

本文链接：https://blog.youkuaiyun.com/jiangdian370676421/article/details/137275505

版权

本文介绍了如何在SpringMVC的Get方法中使用注解如@Tag,@Operation和@Schema来为DTO字段添加SwaggerUI的注释，以确保参数在文档中正确显示。特别提到，通过在方法参数前添加@ParameterObject可以解决注释不显示的问题。

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

@Tag(name="接口"):注解在controller class上
@Operation(summary="接口方法名称")   :注解在 方法上
@Schema(description="字段注释"):注释在DTO字段上
Get方法中的dto参数在swaggerui中如果不显示注释，在方法参数前面加上@ParameterObject