★★★建议星标我们★★★

Java进阶架构师★“星标”！这样才不会错过每日进阶架构文章呀。

2020年Java原创面试题库连载中

【000期】Java最全面试题库思维导图

【001期】JavaSE面试题（一）：面向对象

【002期】JavaSE面试题（二）：基本数据类型与访问修饰符

【003期】JavaSE面试题（三）：JavaSE语法（1）

【004期】JavaSE面试题（四）：JavaSE语法（3）

【005期】JavaSE面试题（五）：String类

【006期】JavaSE面试题（六）：泛型

【007期】JavaSE面试题（七）：异常

【008期】JavaSE面试题（八）：集合之List

【009期】JavaSE面试题（九）：集合之Set

【010期】JavaSE面试题（十）：集合之Map

【011期】JavaSE面试题（十一）：多线程（1）

【012期】JavaSE面试题（十二）：多线程（2）

【013期】JavaSE面试题（十三）：多线程（3）

【014期】JavaSE面试题（十四）：基本IO流

【015期】JavaSE面试题（十五）：网络IO流

【016期】JavaSE面试题（十六）：反射

【017期】JavaSE面试题（十七）：JVM之内存模型

【018期】JavaSE面试题（十八）：JVM之垃圾回收

【020期】JavaSE系列面试题汇总（共18篇）

【019期】JavaWeb面试题（一）：JDBC

【021期】JavaWeb面试题（二）：HTTP协议

【022期】JavaWeb面试题（三）：Cookie和Session

【023期】JavaWeb面试题（四）：JSP

【024期】JavaWeb面试题（五）：Filter和Listener

【025期】Java工具面试题（一）：版本控制工具

【026期】Java工具面试题（二）：项目管理工具

【027期】Java设计模式面试题

【028期】JavaWeb系列面试题汇总（共10篇）

【029期】JavaEE面试题（一）Web应用服务器

【030期】JavaEE面试题（二）SpringMVC

【031期】JavaEE面试题（三）Spring（1）

【032期】JavaEE面试题（四）Spring（2）

【033期】JaveEE面试题（五）MyBatis

【034期】JavaEE面试题（六）Hibernate

【035期】JavaEE面试题（七）SpringBoot（1）

更多内容，点击上面蓝字查看

JApiDocs是一个无需额外注解、开箱即用的SpringBoot接口文档生成工具。

编写和维护API文档这个事情，对于后端程序员来说，是一件恼人但又不得不做的事情，我们都不喜欢写文档，但除非项目前后端代码都是自己写的，否则API文档将是前后端协作中一个不可或缺的沟通界面。既然不可避免，那就想办法弄个轮子吧。人生苦短，必须偷懒。

无图无真相，生成文档的效果如下：

相比Swagger要写一堆注解，Spring RestDocs需要写测试用例，才能生成API文档。JApiDocs 具有无痛集成的特点，你只需花几分钟就能知道它怎么用了。

快速开始

要使得JApiDcos正确工作，你写的代码应该是像下面的样子的：

/**
* 用户接口
*/
@RequestMapping("/api/user/")
@RestController
public class UserController {
/**
* 用户列表
* @param listForm
*/
@RequestMapping(path = "list", method = {RequestMethod.GET, RequestMethod.POST} )
public ApiResult<PageResult<UserVO>> list(UserListForm listForm){
return ;
}
/**
* 保存用户
* @param userForm
*/
@PostMapping(path = "save")
public ApiResult<UserVO> saveUser(@RequestBody UserForm userForm){
return ;
}
}

我们给Controller类和方法加上必要的注释，给接口方法返回相关的对象类型。是的，这样JApiDocs就能解析到相关的接口信息了，就跟我们平时写的代码是差不多的，但要注意，你要通过@param来告诉JApiDocs接口的参数，但在IDE的帮助下，这个工作将是轻松愉悦的：

然后你在任意一个main入口方法执行下面的代码就可以生成文档了：

DocsConfig config = new DocsConfig;
config.setProjectPath("your springboot project path"); // 项目根目录
config.setProjectName("ProjectName"); // 项目名称
config.setApiVersion("V1.0"); // 声明该API的版本
config.setDocsPath("your api docs path"); // 生成API 文档所在目录
config.setAutoGenerate(Boolean.TRUE); // 配置自动生成
Docs.buildHtmlDocs(config); // 执行生成文档

接下来你只管好好写代码，生成Api文档的工作就可以交给JApiDocs了，你不需要再为额外编写和维护文档而烦恼。

功能特性

1、代码即文档

JApiDocs是通过直接解析SpringBoot的源码语法来工作的，所以只要Controller的语法符合一定的代码规范，有合理的注释，就可以直接导出文档。

2、支持导出HTML

便捷的导航和接口查看界面；可本地预览，或者部署到HTTP服务器。推荐部署到服务器，方便前后端展开协作。

3、同步导出客户端Model代码

支持导出Android端的 Java 和iOS端的 Object C Model代码，减少前端程序员的重复编码工作。

4、更多特性

支持接口搜索；支持不同版本和英文文档；自定义扩展等。

简洁的文档

再好用的东西，如果没有文档说明，别人也无从入手。为了让大家尽快上手，JApiDocs准备了一份极简的文档说明，确保你在几分钟就能用上JApiDocs。花5分钟不到就能认识一个提高工作效率的工具，让你把更多的时间花在更加有价值的事情上，你确认不看一下吗？

仓库地址：https://github.com/YeDaxia/JApiDocs

中文文档：https://japidocs.agilestudio.cn/#/zh-cn/

PS：如果觉得我的分享不错，欢迎大家随手点赞、在看。

之前，给大家发过三份Java面试宝典，这次新增了一份，目前总共是四份面试宝典，相信在跳槽前一个月按照面试宝典准备准备，基本没大问题。
《java面试宝典5.0》(初中级)
《350道Java面试题：整理自100+公司》（中高级）
《资深java面试宝典-视频版》（资深）
《Java[BAT]面试必备》（资深）
分别适用于初中级，中高级，资深级工程师的面试复习。
内容包含java基础、javaweb、mysql性能优化、JVM、锁、百万并发、消息队列，高性能缓存、反射、Spring全家桶原理、微服务、Zookeeper、数据结构、限流熔断降级等等。
看到这里，证明有所收获