乐趣区

关于后端:Apifox-Helper自动生成接口文档IDEAApifox懒人必备

前言

🍊原因

接口文档对接爽,整顿起来真费脑

对于 整顿 API 文档 ,本狗秉承偷懒为上的准则,想找一种 在 IDEA 中间接生成文档 的办法。Apifox Helper绝绝子,只须要在 IDEA 中下载插件,无脑配置后, 文档主动生成到 Apifox,美完满解决。并且 颜值及不便水平 绝比 Swagger 和 postman 好太多。

⏲️本文浏览时长

约 10 分钟

🥮前置条件

1. IDEA 开发工具

2. Apifox(不必要)

🎯次要指标

一秒生成接口文档

🍩水图

IDEA 中我的项目接结构图

想理解上图模块分层办法的同学,能够参考《还不会 SpringBoot 我的项目模块分层?来这手把手教你》

生成到 Apifox 接口文档图

👨‍🎓试用人群

1. 像本狗一样【偷懒】不违心整顿接口文档

2. 学习新鲜文档生成及治理形式


注释

🐋1. 在 IDEA 装置【Apifox Helper】插件

点击 File=>Settings,找到 Plugins, 输出 Apifox Helper,点击装置,而后期待胜利后 重启 IDEA, 肯定重启才会失效!!!

🎯Tips: 你能够抉择 同步到 Apifox 我的项目中,也能够间接导出 markdown 文档 。如果是同步到 Apifox 我的项目,你还须要下载或注册 Apifox 软件,并查看上面【Apifox Helper】的配置规定。如果不须要则只须要在我的项目中找到须要生成文档的 Controller,右键后 Export Markdown, 间接导出apifox-api.md 到对应目录。

关上 apifox-api.md 文件查看


🦢2. 批改【Apifox Helper】对应配置

点击 File=>Settings=>Other Settings,找到 ApifoxHelper

##### 1. Apifox 服务器地址

https://api.apifox.cn

##### 2. API 拜访令牌

关上 Apifox 软件,点击左侧【头像】,点击【账号设置】,找到 API 拜访令牌


点击新建令牌,填写名称及有效期,本狗填写名称为【IDEA 专用】,有效期为【无限期】,点击【保留并生成令牌】


复制令牌到 IDEA 中【Apifox Helper】配置项的 API 拜访令牌

##### 3. 模块我的项目 ID 配置

关上 Apifox 软件,新建我的项目,本狗我的项目名为【bkb】, 并确认


进入我的项目【bkb】,点击【我的项目设置】,点击【根本设置】,复制我的项目 ID


将上述复制的【ProjectID】到 IDEA 中【Apifox Helper】配置【模块我的项目 ID 配置】,我的 ModuleName 为【bkb-boot-controller】,所以构造是 bkb-boot-controller:xxxxx, 点击【OK】


🌈3. 生成文档

右击【bkb-boot-controller】模块,点击【Upload to Apifox】,期待实现即可


🍎4. 查看 Apifox 中主动生成的文档

肯定要点击下 Apifox 软件右上角的刷新!
肯定要点击下 Apifox 软件右上角的刷新!
肯定要点击下 Apifox 软件右上角的刷新!

查看成绩,功败垂成,之后便可随心所欲了


写在最初

此生两悔,悔遇见你,更悔未早遇见你。

411 天

| JavaDog| 狗屋地址 |
| :—-:| :—-: |
| 集体博客 | https://blog.javadog.net |
| 公众号 | https://mp.weixin.qq.com/s/_vgnXoQ8FSobD3OfRAf5gw |
| CSDN | https://blog.csdn.net/baidu_25986059 |
| 掘金 | https://juejin.cn/user/2172290706716775|
| 知乎 | https://www.zhihu.com/people/JavaDog |
| 简书 | https://www.jianshu.com/u/1ff9c6bdb916 |
| gitee|https://gitee.com/javadog-net |
| GitHub|https://github.com/javadog-net|

退出移动版