jfinal集成knife4j生成Swagger文档

简述:

前后端开发需要api文档,目前比较好用的是swagger,而swagger增强框架knife4j更好一点。

集成:

1、pom.xml添加依赖

image.png

2、创建控制器 JFinalSwaggerController

依赖包中有JFinalSwaggerController的代码,作者也配置了Route,但是引入后不能使用,需要自行创建该文件,并在配置中引入自行创建的JFinalSwaggerController。

3、配置image.png

注意:需要在Route中调用:setMappingSuperClass(true);让方法生成对应的ActionKey

image.png

特别注意:Json构建工厂不要使用FastJson,不要使用FastJson,不要使用FastJson。

建议使用:// 设置json工厂 me.setJsonFactory(JacksonFactory.me());

4、效果

使用Swagger注解编写接口文档即可,访问:http://localhost:9021/doc.html

image.pngimage.png


评论区

zzutligang

2021-05-12 14:06

顶一下,回头看看。

李通

2021-05-15 22:55

@zzutligang 这个有bug,请求,无论controller的方法中的形参是什么,请求参数都是空的

l745230

2021-05-16 15:18

https://jfinal.com/share/2345 可以试下这个,参照官方格式写的解析。 常用的场景都适配了。

JackHappiness

2021-06-03 11:29

@l745230 非常感谢

JackHappiness

2021-06-03 11:30

@李通 请采用https://jfinal.com/share/2345,那个开发尚不完善