Swagger2 与 Swagger3 、Knife4j注解详解与对比(全网最全)

Swagger 是一个用于描述和文档化 RESTful API 的强大工具。随着版本演进,Swagger 从 2.x 发展到 3.x(OpenAPI 3.0),其注解也有了一些变化。下面我将详细分析两个版本的注解及其差异。

一、Swagger2 注解详解

Swagger2 使用 io.swagger.annotations 包下的注解。

1. @Api

作用:标注在控制器类上,用于描述整个控制器的作用。

/**
 * @Api:描述控制器类
 * tags:控制器的标签,可以有多个
 * value:控制器的描述(已废弃,建议使用description)
 * description:控制器的详细描述
 * produces:指定返回的内容类型,如"application/json"
 * consumes:指定接收的内容类型
 * protocols:协议类型,如"http", "https", "ws", "wss"
 * authorizations:高级特性认证配置
 * hidden:是否隐藏该控制器
 */
@Api(
    tags 
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Clf丶忆笙

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值