共计 4050 个字符，预计需要花费 11 分钟才能阅读完成。
背景
最近，栈长发现某些国内的开源我的项目都应用到了 Knife4j 技术，看名字就感觉很尖锐啊！
是不是这样的缩写呢：
Knife4j = Knife for Java？
Java 匕首？
看起来很牛逼的样子，当然，这是我简略的猜想，从字面上并不能猜到它是干嘛用的！
那么它到底是一个什么样的框架呢？
Knife4j 简介
Knife4j 的前身是 swagger-bootstrap-ui，其实就是一个纯 Swagger UI 的皮肤我的项目，用过 Swagger 的应该都晓得，Swagger UI 是不怎么好用的，并不太适宜国人，所以 swagger-bootstrap-ui 我的项目就诞生了。
swagger-bootstrap-ui 前面为了满足许多个性化的需要，又退出了许多丰盛的服务端个性，不再仅仅只是专一于前端 UI 皮肤了，所以又改名：knife4j。
取名 knife4j 是心愿它能像 一把匕首一样玲珑、轻量，并且性能强悍，更是心愿它能成为 Swagger 接口文档服务的通用性增强型解决方案。
Knife4j 由国人程序员萧明于 2017 年开源，到当初曾经 4 年多了，看了下 Star 数曾经超过 4.7k+ 了：
Knife4j 还取得了 GVP 我的项目名称，即 Gitee 最有价值的开源我的项目，并且我发现当初越来越多的开源我的项目都在应用它，Swagger UI 能够扔掉了。。
官网地址：
https://doc.xiaominfo.com/kni…
开源地址：
https://gitee.com/xiaoym/knife4j
Knife4j 界面赏鉴
Knife4j 采纳了 Vue + And Design Vue 组件进行重写，相干界面拿进去供大家赏鉴。
接口文档显示界面：
接口调试界面：
Swagger Models 性能：
反对导出离线 Markdown、Html：
knife4j 果然十分弱小，整个界面基于左右菜单式的布局形式，反对多标签同时关上展现、切换，文档和调试也更清晰，感觉更合乎国人的操作习惯吧。。
Knife4j 实战
knife4j 目前次要反对以 Java 开发为主，并且反对 Spring MVC、Spring Boot、Spring Cloud 框架的集成应用。
本文栈长就以 Spring Boot 为根底实战下吧：
- Spring Boot 2.5.0
- Knife4j 2.0.9
- Maven 3.6.3
- JDK 1.8
留神： 应用 Knife4j 2.0.6+ 版本，Spring Boot 的版本要求 2.2.x+
1、Knife4j 依赖引入
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>2.0.9</version>
</dependency>2、Knife4j 配置
开启加强性能及根本的登录认证：
knife4j:
# 开启加强
enable: true
# 开启登录认证
basic:
enable: true
username: test
password: test反对个性化配置项，如接口地址、接口形容属性、UI 加强等个性化配置性能：
/**
* Knife4j 配置类
* 起源微信公众号：Java 技术栈
* 作者：栈长
*/
@Configuration
@EnableSwagger2WebMvc
public class Knife4jConfiguration {@Bean(value = "defaultDocket")
public Docket defaultDocket() {
// 联系人信息
Contact contact = new Contact("公众号：Java 技术栈", "https://www.javastack.cn", "xx@javastack.cn");
// 创立 Docket
Docket docket = new Docket(DocumentationType.SWAGGER_2)
.apiInfo(new ApiInfoBuilder()
.title("Knife4j 测试")
.description("Knife4j Test")
.termsOfServiceUrl("https://www.javastack.cn")
.contact(contact)
.version("1.0")
.build())
.groupName("1.x")
.select()
.apis(RequestHandlerSelectors.basePackage("cn.javastack.springboot.knife4j.api"))
.paths(PathSelectors.any())
.build();
return docket;
}
}Spring Boot 根底就不介绍了，送你一份《Spring Boot 学习笔记》，高清实践+实战版，照着学习，没有不会的，最新版正在致力更新中，能够继续关注公众号 Java 技术栈，会第一工夫分享给大家。
3、新增测试接口
新增两个测试接口，一个登录（POST），一个问好（GET）。
/**
* Knife4j 测试接口
* 起源微信公众号：Java 技术栈
* 作者：栈长
*/
@Api(tags = "测试模块")
@RestController
public class Knife4jController {
/**
* Knife4j 测试接口问好
* 起源微信公众号：Java 技术栈
* 作者：栈长
*/
@ApiImplicitParam(name = "name", value = "名称", required = true)
@ApiOperation(value = "公众号 Java 技术栈向你问好！")
@ApiOperationSupport(order = 2, author = "栈长")
@GetMapping("/knife4j/hi")
public ResponseEntity<String> hello(@RequestParam(value = "name") String name) {return ResponseEntity.ok("Hi:" + name);
}
/**
* Knife4j 测试接口登录
* 起源微信公众号：Java 技术栈
* 作者：栈长
*/
@ApiImplicitParams({@ApiImplicitParam(name = "username", value = "用户名", required = true),
@ApiImplicitParam(name = "password", value = "明码", required = true)
})
@ApiOperation(value = "接口登录！")
@ApiOperationSupport(order = 1, author = "栈长")
@PostMapping("/knife4j/login")
public ResponseEntity<String> login(@RequestParam(value = "username") String username,
@RequestParam(value = "password") String password) {if (StringUtils.isNotBlank(username) && "javastack".equals(password)) {return ResponseEntity.ok("登录胜利:" + username);
}
return ResponseEntity.ok("用户名或者明码有误:" + username);
}
}下面为了反对接口程序和接口作者，应用了 Knife4j 的 @ApiOperationSupport 注解，其余的均为 Swagger 自带的注解，从该目录下看还反对上面的注解：
更多可去官网进行学习。
残缺的 Demo 代码就不一一帖了，本节教程所有实战源码已上传到这个仓库：
https://github.com/javastacks…
4、Knife4j 测试
启动利用，关上 Knife4j 文档页：
http://localhost:8080/doc.html
主页会显示一些曾经配置好的文档参数及接口统计信息，并且在首页模块菜单中也看到了咱们的测试模块的两个接口。
接口文档：
调试一下：
这里栈长应用了接口排序、还有接口作者性能，另外还反对分组排序、自定义文档、Swagger 资源爱护、导出 Markdown、参数缓存等泛滥弱小性能，加强性能多达 29 项，有趣味的能够自行尝试 …
总结
好了，明天栈长给大家介绍了国人程序员开源的一款 Knife4j 我的项目，也就是 Swagger 的增强版，毫无疑问要比 Swagger UI 更弱小，更好用，也合乎国人的习惯！
如果你也在应用 Swagger，能够思考应用 Knife4j，它不仅有更弱小的 UI，更有多达 29 项的加强性能，它们并不是代替关系，就像 Mybatis Plus 和 Mybatis 的关系一样，它能助你更进一步进步开发生产力。
如果你也在应用 Knife4j，欢送留言分享哦！
本节教程所有实战源码已上传到这个仓库：
https://github.com/javastacks…
好了，明天的分享就到这里了，前面栈长会分享更多好玩的 Java 技术和最新的技术资讯，关注公众号 Java 技术栈第一工夫推送，我也将支流 Java 面试题和参考答案都整顿好了，在公众号后盾回复关键字 “ 面试 ” 进行刷题。
最初，感觉我的文章对你用播种的话，动动小手，给个在看、转发，原创不易，栈长须要你的激励。
版权申明： 本文系公众号 “Java 技术栈 ” 原创，原创实属不易，转载、援用本文内容请注明出处，剽窃者一律举报+投诉，并保留追究其法律责任的权力。
近期热文举荐：
1.1,000+ 道 Java 面试题及答案整顿(2021 最新版)
2. 别在再满屏的 if/ else 了，试试策略模式，真香！！
3. 卧槽！Java 中的 xx ≠ null 是什么新语法？
4.Spring Boot 2.5 重磅公布，光明模式太炸了！
5.《Java 开发手册（嵩山版）》最新公布，速速下载！
感觉不错，别忘了顺手点赞 + 转发哦！
