苏州企业网站建设定制,三维免费空间,鄂州网站网站建设,wordpress首页友情链接自动化API文档-APIFOX
文章作者#xff1a;老杨
一#xff1a;概述
大家在后端开发开发过程中#xff0c;最痛恨的两天事情#xff1a;1.写文档#xff0c;2.别人不写文档。而我们后端开发#xff0c;必定经历的事情就是要和前端测试对接#xff0c;我们需要把我…自动化API文档-APIFOX
文章作者老杨
一概述
大家在后端开发开发过程中最痛恨的两天事情1.写文档2.别人不写文档。而我们后端开发必定经历的事情就是要和前端测试对接我们需要把我们的业务接口告知他们让前端和测试能1.并行开发2.对接联调实现完整功能3.测试根据接口完成测试用例编写和测试所以避免不了的就需要我们出接口文档。我们出文档又回归到了三种方式1.手工编写任务给谁谁骂2.swagger3.侵入式注解。
手工编写如果是开发前定好接口避免不了的设计不到位后期重复修改还有会占用前期大量时间小团队耗不起。Swagger和侵入式注解都需要在我们的代码中额外增加各种注解对我们的代码可读性来说点都不友好。
swagger嵌入式生成文档案例 来吧吐槽把。为什么我还要把逻辑代码和文档注解写在一个地方这跟在 html 里写样式代码有什么区别
来吧上正题今天给各位IT精英推荐ApiFoxJavaDoc和Idea插件一体化。解决你的烦恼问题初步预计这会成为业务未来主流大家值得使用。 二实操
Apifox idea 插件--Apifox Helper注如果下载不下来重试几次
这个插件用起来挺简单的关键在于它把从代码到 API 文档的这一步用最方便的办法解决了。API 相关的定义再也不需要用侵入式的方式写到代码注解里而是清清爽爽地写成像这样的注释就可以了。 注释里面的 param, link, return 这些就是标准的 Javadoc 注释在 JDK 里定义好的全球通用。 只要写好了 Javadoc自动生成 API 文档就只需要三步。
第一步从 IDEA 插件市场下载 Apifox Helper配置好你的 Apifox 令牌。 注令牌到官网去微信关注登录然后在 第二步在 IDEA 里点右键【Upload to Apifox】,就能一键从你的代码生成 API 文档。 Upload to Apifox可以生成单个接口也能一键把 Controller 里面的所有接口全部生成甚至把整个项目上右键一起生成接口文档。
第三步在 Apifox 里面分享文档。我就拥有了一个方便的美观的可以团队协作的还能在线调试的完美的 API 文档。 到此你就可以像使用Postman一样在这里完成接口的查阅测试。nice 三经验总结
写完一个接口首先自测不着急上传到文档。可以在代码里点右键【Call API】就可以直接在 IDEA 里发起接口请求特别爽根本不需要用 Postman自测没问题了就可以点右键【Upload to Apifox】如果是新写的接口就会在 Apifox 里新增一个 API如果是原本的接口有修改就会自动更新已有的 API。把前端和测试的同事都直接加进 Apifox 的项目团队里。这样只要我这边上传了 API他们在 Apifox 里面直接就能看得见根本不需要我发一个 API 文档给他们。API 文档不但自动生成了开发人员我根本不需要管它前端和测试可以直接用 Apifox 来调接口和做测试。如果接口有调整我就直接在代码里改然后重新 Upload 一下前端和测试那边看到的接口就是最新的了。如果 API 需要开放给外部的合作团队这个时候就需要专门输出一个 API 文档了。我在 Apifox 的“在线分享”选择开放给他们的接口配上环境就是一个完美的 API 文档了还能在线直接运行和生成代码。三方公司打开链接即可查看 文章结束如果喜欢的话请给个好评你的鼓励是我最大的动力谢谢。
