开启 Knife4j

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

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

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

  1. knife4j:
  2.   enable: true
  3.   production: false

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

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

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

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

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

  1. knife4j:
  2.   enable: true
  3.   production: false

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

  1. 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页面

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

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

  1. #用户登录ticket-id
  2. bdp-user-ticket-id=
  3. #工作空间ID
  4. workspaceId=
  5. #内部请求开关
  6. dataworkcloud_inner_request=true

以Chrome浏览器为例 开启 Knife4j - 图1

通过http://ip:port/api/rest\_j/v1/doc.html 访问knife4j页面 开启 Knife4j - 图2 点击接口名称可展示详细的接口文档 开启 Knife4j - 图3 点击“调试”并录入参数可对接口进行调试 开启 Knife4j - 图4

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