knife4j4.3.0版本,@ApiSupport,@ApiSort 排序不生效问题

1、版本

jdk:17

springboot:3.0.2

springcloud:2022.0.0

springcloud-alibaba:2022.0.0.0-RC2

knife4j:4.3.0

2、问题:

使用接口分组排序注解不生效 

@ApiSupport(order = 1)
@ApiSort(1)
@Tag(name = "公司管理")
@RestController

不会生成tags标签,也没有x-order扩展属性

3、解决:

查阅资料,版本应该是有bug,官方文档:

开发者必须使用knife4j-openapi2-spring-boot-starter组件才生效。我使用的是knife4j-openapi3-jakarta-spring-boot-starter。

issues中找到解决办法,更改@Tag注解:

@Tag(name = "公司管理", description = "公司管理", extensions = {
        @Extension(properties = {@ExtensionProperty(name = "x-order", value = "1", parseValue = true)}
        )
})

重启后排序生效了,接口出现了tags标签。更改排序只用更改@Tag中 value = "1" 的值即可。

tags: [{name: "公司管理", description: "公司管理", x-order: 1}]

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值