超简单!Java 项目自动生成接口文档教程
你还在用 word、markdown 埋头苦干写接口文档?写文档这件事恐怕是每个开发都万分抗拒的事情了。本篇文章详细教你如何利用插件工具,在 IDEA 中自动生成 API 文档。
先来看看从 IDEA 中生成文档的效果如下图。下图是使用 Apifox 插件(Apifox helper)从 IDEA 生成的文档(右)效果。
第一步:安装插件
打开你的 IDEA,点击 File -->Settings --> Plugins,输入 Apifox Helper。 点击安装,然后等待成功后重启 IDEA.
你也可以通过 Jetbrains Marketplace 的官网下载安装。
第二步:注册一个 Apifox 账号
Apifox 是一个在线的接口文档管理工具,这一步主要是用来同步文档到项目中。支持下载桌面端或直接网页注册,并且创建一个项目。
第三步:配置令牌
接下来,你需要将 Apifox Helper 和 Apifox 的项目进行关联,也就是通过访问令牌绑定。
1、打开 Apifox, 点击左侧【头像】-->【账号设置】-->【API 访问令牌】;
2、点击【新建令牌】,填写令牌名称,点击【保存并生成令牌】。
3、复制令牌到 IDEA 中【Apifox Helper】配置项的 API 访问令牌中。同理,在 Apifox 中进入项目,【项目设置 --> 基本设置】,复制项目 ID 。
4、在 IDEA 中,点击 File-->Settings -->Other Settings,找到 Apifox Helper。 将访问令牌和项目 ID 粘贴到这里:
(服务器地址就用默认的,可以不用管。)
到这里,你就搞定了配置部分,下面就是自动生成文档了!
第四步:生成文档!
打开需要上传的 Controller 文件,右键选择「 Upload to Apifox」。
第五步:去 Apifox 项目中查看自动生成的文档
点击 Apifox 右上角的刷新图标。刚才在 IDEA 项目中的接口文档就已经在这里了。
自此,你就大功告成了!恭喜你已经拥有了一份美观整洁的接口文档。这个项目一旦有更新,你只需要右键点击「 Upload to Apifox」 就可以。
更多好用的功能
当你的文档同步到项目中,那么你就可以直接在 apifox 中直接生成一个分享链接给别人,那么他看到的文档就都是最新的,不需要再管你索要接口文档文件。
还可以直接在 Apifox 项目中直接发起接口调试、接口自动化测试等等操作。相较于 Postman,Apifox 结合它的插件 Apifox Helper 可以通过代码注解自动解析生成 API 文档,无需手动操作,同时支持远端同步,非常方便团队内的协作和更新。这是一种新型的在线协作方式,能够非常高效率帮助你进行 API 接口的分享和管理。懒人必备! 另附带 Apifox 插件官方帮助文档 ,帮助你使用。
更多关于接口文档的相关知识。:
相关文章
- java用什么软件_Java编程什么软件最好用?
- java除法保留两位小数_JAVA除法保留小数点后两位的两种方法
- java 上传文件接口_Java接口实现文件上传
- java解析xml文档并保存到数据库
- java xml解析框架_JAVA解析xml的五种方式对比
- Java程序是如何运行的「建议收藏」
- java public interface_Java 接口interface的基础[通俗易懂]
- 【说站】java线程池中类的继承探究
- 什么是Java,了解Java的历史,你知道Java已经到17了吗?
- Java高级编程:volatile 与 synchronized
- Java静态代理_代理ip怎么设置
- JAVA生成uuid_java接口default方法
- 【错误记录】生成 Java 文档错误 ( Xxx.java:xx: 错误: 编码GBK的不可映射字符 )
- Java操作MySQL数据库快速入门(java访问mysql)
- Java与Oracle的完美结合(java和oracle)
- 时间如何管理Redis中Java数据的过期时间(redisjava过期)
- 使用Java中的Redis实现过期处理(redisjava过期)
- 在Linux上运行Java程序的JDK 32位体验(jdk32linux)
- 失效Java旨在Redis中存储的数据实现过期失效(redisjava过期)
- 用Redis实现Java分布式锁,提升系统并发性能(redisjava锁)
- Linux下Java应用打包实践(linux java打包)
- JAVA线程同步实例教程