778 Star 6.7K Fork 1.4K

GVP萧明/knife4j

Knife4j 4.1版本
Created At 2023-01-11
Deadline 2023-03-31

主要完善修复当前4.0版本的功能性bug,目前正在开发迭代阶段

主要更新

1、网关聚合组件knife4j-gateway-spring-boot-starter针对OpenAPI3规范聚合时丢失context-path的支持,在ui层面做兼容

2、springdoc-openapi版本升级到最新版本1.6.15、2.0.4 Gitee#I6OIB1

3、knife4j-openapi3-jakarta-spring-boot-starter模块属性配置在idea不提示的异常情况处理

4、增强属性自定义文档加载分组的bug处理GitHub#PR525

5、knife4j-dependencies模块漏掉部分依赖模块版本定义的情况

6、解决****不添加 springdoc-openapi-ui 依赖异常的问题Gitee#I66YJA**

7、针对OAS3规范中Parameter属性缺失字段说明的异常情况修复

8、针对OAS3规范中扩展属性包括排序、作者等不生效的问题Gitee#I6FB9I

9、部分字段翻译问题GitHub#540

10、使用增强属性开启production时出现的NPE异常GitHub#527

11、针对OpenAPI3规范的tag名称兼容性问题Gitee#I6JATP

12、实体类接收url参数时文档不显示参数说明的问题Gitee#I6H8CD

13、修复OAS3规范上传组件的识别问题Gitee#I6HAW0GitHub#538

14、SpringWebflux框架的集成组件starter封装GitHub#521

15、针对Basic验证的特性增加include属性,允许开发者自定义配置GitHub#530

16、全局搜索框支持tag名称的模糊搜索Gitee#I6NWV6

快照版本

4.1.0版本会修复相应的Bug后,会发布SNAPSHOT快照版本,开发者可以使用,也帮助Knife4j测试新版本

1、项目pom.xml中配置快照仓库,如下:

<repositories>
    
     <repository>
        
        <id>nexus-maven</id>
        
        <name>nexus-maven</name>
        
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
    
    </repository>

</repositories>


2、引入依赖:

以openapi2为例,需要注意的是,从4.0.0版本开始,knife4j提供的starter包artifactId有了变化

<dependency>
    
    <groupId>com.github.xiaoymin</groupId>
    
    <artifactId>knife4j-openapi2-spring-boot-starter</artifactId>
    
    <version>4.1.0-SNAPSHOT</version>

</dependency>

反馈交流

开发者如在使用过程中发现问题或者有新的想法,可以通过提交issue进行反馈,或者关注Knife4j的微信公众号,加入微信交流群与作者沟通交流

Java
1
https://gitee.com/xiaoym/knife4j.git
git@gitee.com:xiaoym/knife4j.git
xiaoym
knife4j
knife4j

Search