Knife4j 2.0.2 正式发布，Swagger 接口文档赋能工具-低调大师

Knife4j 2.0.2 正式发布，Swagger 接口文档赋能工具

2020-03-09 786

Knife4j前身是swagger-bootstrap-ui,是一个为Swagger接口文档赋能的工具

文档：https://doc.xiaominfo.com

效果(旧版)：http://swagger-bootstrap-ui.xiaominfo.com/doc.html

效果(2.X版)：http://knife4j.xiaominfo.com/doc.html

Gitee：https://gitee.com/xiaoym/knife4j

GitHub：https://github.com/xiaoymin/swagger-bootstrap-ui

示例：https://gitee.com/xiaoym/swagger-bootstrap-ui-demo

特性 & 优化

knife4j

1、新增knife4j-dependencies模块,管理knife4j的相关Maven引用,可以以Maven的BOM方式引入Knife4j

2、官网文档同步更新.

3、解决swagger-annotations导致的版本冲突gitee #I17G31、GitHub #191

knife4j-spring-ui

1、修复切换tab之后再次发送请求不带参数且不显示响应数据的问题，调试异常等问题PR 13 @gitee、gitee #I17FFX、GitHub #196、GitHub #187

2、优化调试框全部选中的问题,在取消全选时,只有在输入参数改变时才会选中该参数,取消原来默认选中全部参数gitee #I19V6D

3、针对Form表单类型的请求构造curl命令行时在未输入值的情况下为null的情况,修改为空字符串gitee #I18IBZ

4、优化全局参数设置功能,针对参数数据太长不换行问题，以及参数需要修改时需要重新删除的交互体验，开发者在新增参数后可以方便的更改参数数据值以及参数的类型gitee #I17OV1、gitee #I19GJK、gitee #I1A9V1、gitee #I18HMJ、GitHub #176

5、请求参数在未给定example默认值的情况下,文本输入框的placeHolder属性显示该字段的文字说明gitee #I17RKI

6、修复增强属性忽略参数不生效的问题gitee #PR-16、gitee #I136KU、gitee #I187VN、gitee #I16A71

7、调试参数框增加对后端枚举的支持,改输入框为下拉选择框gitee #I18MHO

8、service-worker.js报404问题，构建打包时添加此文件gitee #I17D0Y、GitHub #185

9、get请求参数出现特殊字符未编码处理导致出现400错误gitee #I19C8Y

10、后端新增接口或者接口编辑后,在ui界面显示更新标志,在菜单上会出现一个蓝色的徽标gitee #I1AQFW，如下图:

11、后端增强注解@ApiOperationSupport(author = "xiaoymin@foxmail.com")支持每个接口提供开发者的呈现,最终如下图：

12、调试发送按钮增加loading效果,针对接口响应较长的情况下提升交互效果

13、针对Authorize菜单栏的参数,保存参数是全局保存,其它逻辑分组的接口再调试时,不需要再保存一次新值gitee #I16Z10

14、修复部分情况响应字段在ace-editor编辑器右边栏不显示字段说明的情况gitee #I17F5Y

15、搜索框完善对接口请求Api地址栏的模糊搜索匹配gitee #I19EN0、gitee #I1B0Q9

16、调试响应数据行太长,无法换行的问题gitee #I17F1J

17、在当前接口无参数的情况下,界面添加全局参数无效果的bug

如果你后端是Java+Spring的技术栈，在使用springfox的同时，想换一个Swagger的Ui皮肤，通过在pom.xml中直接引入即可,如下：

<dependency>
  <groupId>com.github.xiaoymin</groupId>
  <artifactId>knife4j-spring-ui</artifactId>
  <version>2.0.2</version>
</dependency>

Knife4j-Spring

使用Spring Boot的技术栈可以通过引用starter的方式快速引入使用,注意该starter组件是包含Ui的,如下：

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

如果是微服务的情况下,微服务其实不需要引用Ui的jar包，只需要在网关引用Ui的jar包依赖,所以在微服务情况下,使用增强属性只需要引用微服务版本的starter依赖,如下：

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-micro-spring-boot-starter</artifactId>
    <version>2.0.2</version>
</dependency>

特点

基于Vue+Ant Design构建的文档，更强大、清晰的接口文档说明能力以及接口调试能力
左右布局,基于Tabs组件的多文档查阅风格
支持在线导出Html、Markdown、Word、PDF等多种格式的离线文档
接口排序,支持分组及接口的排序功能
支持接口全局在线搜索功能
提供Swagger资源保护策略,保护文档安全
接口调试支持无限参数,开发者调试非常灵活，动态增加、删除参数
全局缓存调试信息,页面刷新后依然存在,方便开发者调试
以更人性化的table树组件展示Swagger Models功能
文档以多tab方式可显示多个接口文档
请求参数栏请求类型、是否必填着颜色区分
主页中粗略统计接口不同类型数量
支持自定义全局参数功能，主页包括header及query两种类型
JSR-303 annotations 注解的支持
更多个性化设置功能

界面

接口文档显示界面如下：

接口调试界面如下：

Swagger Models功能

支持导出离线Markdown、Html功能，markdown的表格较原先版本通过缩减显示为树形结构,点击预览导出离线Html效果，效果图如下：

通过第三方Markdown软件导出的PDF效果如下图:

同时提供了导出离线Html功能,Html功能界面风格和在线几乎没有区别,美观、大方、简洁,点击在线预览效果，

界面效果如下图：

Star & Issue

感谢各位朋友的支持,前往https://gitee.com/xiaoym/knife4j点个Star吧~~ ：）

微信关注我们

原文链接：https://www.oschina.net/news/113926/knife4j-2-0-2-released

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

Kooteam 0.9.1 发布，新一代轻量级团队协助系统

Kooteam 是一款轻量级的在线团队协作工具，提供各类文档工具、在线思维导图、在线流程图、项目管理、任务分发等工具，并接入了企业微信，钉钉开放平台，使用便捷高效。在线地址：https://www.kooteam.com 2019 年，是比较艰难的一年。由于各种原因，系统停更 10 个月，期间官网也瘫痪。kooteam 现在由个人兼职维护，本来去年 12 月份就重启了软件更新，但一不小心，重写了 80%的前后端代码，导致更新一再延期。本次对数据 schema 引擎层，完全重写，从而实现了 Mongodb，MySQL，SQLite 上的应用层 API 完全一致，大幅降低今后的维护成本。更新记录 1. 任务模块，增加子任务，附加等新功能 2. 脑图全部重写，放弃了自研的脑图引擎，基于百度脑图定制开发 3. 文本编辑与 Markdown 编辑器合并，富文本里支持 Markdown 语法 4. 云版本与私有部署版本底层数据引擎升级，现在应用层 95%以上的代码保持一致，去掉了阿里云 bigtable 存储。（云版本是 Mongodb 存储，私有版本是 MySQL 存储） 5. 舍...

2020-03-09

750

软件官方网址：http://www.novalide.com NovalIDE 1.2.1 新年隆重发布，新版本添加了以下重磅功能！发布gittool插件,支持clone,commit,checkout项目和代码添加django插件,支持一键式转换django项目以及web调试添加了自动完成插件,使用增强版智能提示功能可以边输入或边退格边提示支持文本自动插入成对的符号,如引号,三引号,括号等支持刷新项目文件夹下的文件并自动添加到项目文件中优化调试器监视显示监视值类型调试器运行时设置是否鼠标悬停时显示监视文本的内存值修复了一些已知BUG 下面是软件功能截图：

2020-03-09

580

资源下载

更多资源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。