前言
API 这个词我相信大家都不陌生，平时的工作中也会使用到一些api管理工具，比如：YApi，swagger，postman，apidoc，showDoc，rap2等。今天主要介绍下 YApi 以及在 idea 中集成插件实现自动生成与更新 api 文档。
正文
YApi 介绍
下面摘录部分内容来大致介绍YApi，更加深入及详细的内容请移步到上面的链接进行查看。
YApi 平台介绍
YApi 是高效、易用、功能强大的 api 管理平台，旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API，YApi 还为用户提供了优秀的交互体验，开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。
YApi 特性
- 基于 Json5 和 Mockjs 定义接口返回数据的结构和文档，效率提升多倍
- 支持 postman, har, swagger 数据导入
- 扁平化权限设计，即保证了大型企业级项目的管理，又保证了易用性
- 类似 postman 的接口调试
- 自动化测试, 支持对 Response 断言
- MockServer 除支持普通的随机 mock 外，还增加了 Mock 期望功能，根据设置的请求过滤规则，返回期望- 数据
- 免费开源，内网部署，信息再也不怕泄露了
介绍完 YApi 之后，那么接下来进入正题，来看看怎么实现 Idea 与 YApi 的无缝衔接吧。
先看一下接口文档生成的效果吧：
接下来我们开始进行同步接口文档的操作：
【第一步】：打开Idea => File => Settings => Plugins => 搜索 EasyApi 插件并安装
【第二步】：安装完成后重启Idea
【第三步】：打开Idea => Settings => Other Settings => EasyApi 设置Yapi的服务地址
【第四步】：找到对应的需要创建或者更新的controller，鼠标右键，单击Export Yapi
注：第一次执行Export Yapi 会弹出一个框让我们输入Token，如下图：
注：上图中的Token来源在 Yapi 服务界面【test】分组下的【test-yapi】项目设置中，【test】分组以及【test-yapi】项目都是我提前创建好的，各位可以在自己创建的项目中找到设置 => token配置面板获取 Token
经过上面四步，我们的文档就一键同步到了 YApi , 以后如果controller中接口有变动则再次执行上文中的【第四步】即可同步最新接口到 YApi了
下面是对应的测试代码，通过代码对照这看生成的接口文档可以更加准确的了解Yapi额
controller:
/**
* 测试 Yapi Controller
*
* @author maodudu
* @version 1.0
* @date 2022/6/19 21:16
*/
@RestController
public class TestYapiController {
/**
* 测试 yapi
* @param id id
* @return 结果
*/
@PostMapping("/yapi/test/{id}")
public TestYapiVO test(@PathVariable("id") String id){
return null;
}
}
返回结果TestYapiVO :
/**
* 测试Yapi VO
*
* @author maodudu
* @version 1.0
* @date 2022/6/19 21:17
*/
public class TestYapiVO {
/**
* 名称
*/
private String name;
/**
* 年龄
*/
private Integer age;
/**
* 性别
*/
private SexEnum sex;
/**
* 资产
*/
private BigDecimal money;
/**
* 朋友列表
*/
private List<FriendBO> friends;
/**
* 朋友BO
*/
public static class FriendBO {
/**
* 朋友名称
*/
private String friendName;
/**
* 朋友性别
*/
private SexEnum friendSex;
}
}
性别枚举类：
/**
* 性别枚举类
*
* @author maodudu
* @version 1.0
* @date 2022/6/19 21:27
*/
public enum SexEnum {
/**
* 男
*/
MAN,
/**
* 女
*/
WOMAN,
;
}
更新单个API
在上文的基础上，如果有一个controller中有多个接口，我们只想更新其中某一个接口应该怎么操作呢？
【步骤一】： 在对应controller 鼠标右键，单击 Export Api
【步骤二】： 在弹出的面板中按需选择要更新的接口，回车即可
扩展知识点：
当我们第一次执行上文中的【第四步】同步接口到YApi，我们输入Token之后，我们的idea中会对其进行保存，可通过 Idea => Settings => Other Settings => EasyApi 面板查看
网友评论