Skip to main content
版本:1.5.0

集成 Knife4j

1.knife4j介绍

knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案,前身是swagger-bootstrap-ui,取名knife4j是希望它能像一把匕首一样小巧,轻量,并且功能强悍!其底层是对Springfox的封装,使用方式也和Springfox一致,只是对接口文档UI进行了优化 核心功能:

  • 文档说明:根据Swagger的规范说明,详细列出接口文档的说明,包括接口地址、类型、请求示例、请求参数、响应示例、响应参数、响应码等信息,对该接口的使用情况一目了然。
  • 在线调试:提供在线接口联调的强大功能,自动解析当前接口参数,同时包含表单验证,调用参数可返回接口响应内容、headers、响应时间、响应状态码等信息,帮助开发者在线调试。

2.Linkis集成knif4j

2.1 测试模式下启动knif4j

修改application-linkis.yml文件设置knife4j.production=false

knife4j:
enable: true
production: false

修改 linkis.properties文件打开测试模式

wds.linkis.test.mode=true
wds.linkis.test.user=hadoop

重启所有服务后,可以通过http://ip:port/api/rest_j/v1/doc.html 访问knife4j页面

http://ip:port/api/rest_j/v1/doc.html 

2.2 非测试模式下启动knif4j

修改application-linkis.yml文件设置knife4j.production=false

knife4j:
enable: true
production: false

修改 linkis.properties文件添加wds.linkis.server.user.restful.uri.pass.auth

wds.linkis.server.user.restful.uri.pass.auth=/api/rest_j/v1/doc.html,/api/rest_j/v1/swagger-resources,/api/rest_j/v1/webjars,/api/rest_j/v1/v2/api-docs

重启所有服务后,可以通过http://ip:port/api/rest_j/v1/doc.html 访问knife4j页面

http://ip:port/api/rest_j/v1/doc.html 

由于knife4j调试各接口时,需要进行身份认证,需手工在浏览器添加如下cookie信息

#用户登录ticket-id
bdp-user-ticket-id=
#工作空间ID
workspaceId=
#内部请求开关
dataworkcloud_inner_request=true

以Chrome浏览器为例

3.进入Knife4j页面

通过http://ip:port/api/rest_j/v1/doc.html 访问knife4j页面 点击接口名称可展示详细的接口文档 点击“调试”并录入参数可对接口进行调试

详细使用指南可浏览knife4j官网查看:https://doc.xiaominfo.com/knife4j/