我是 ABin-阿斌：写一生代码，创一世佳话，筑一览芳华。如果小伙伴们觉得不错就一键三连吧~

声明：文章原文来源处：

https://blog.csdn.net/weixin_40863968/article/details/122432678
https://www.jianshu.com/p/cd915908cb96
文章目录
- 一、前言
- 二、正文
- - 1、YApi 介绍
  - - 1、YApi 平台介绍
    - 2、YApi 特性
    - 3、更新单个API
  - 2、postman方式
  - - 1、配置
    - 2、使用
  - 其他配置方式
  - - 1、第一步：
    - 第二步：

一、前言

API 这个词我相信大家都不陌生，平时的工作中也会使用到一些api管理工具，比如：YApi，swagger，postman，apidoc，showDoc，rap2等。今天主要介绍下 YApi 以及在 idea 中集成插件实现自动生成与更新 api 文档。

二、正文

1、YApi 介绍

YApi gitee 地址
YApi github 地址
YApi 官方文档地址

下面摘录部分内容来大致介绍YApi，更加深入及详细的内容请移步到上面的链接进行查看。

1、YApi 平台介绍

YApi 是高效、易用、功能强大的 api 管理平台，旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API。
YApi 还为用户提供了优秀的交互体验，开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。

2、YApi 特性

基于 Json5 和 Mockjs 定义接口返回数据的结构和文档，效率提升多倍
支持 postman，har，swagger 数据导入
扁平化权限设计，即保证了大型企业级项目的管理，又保证了易用性
类似 postman 的接口调试
自动化测试，支持对 Response 断言
MockServer 除支持普通的随机 mock 外，还增加了 Mock 期望功能，根据设置的请求过滤规则，返回期望数据
免费开源，内网部署，信息再也不怕泄露了

介绍完 YApi 之后，那么接下来进入正题，来看看怎么实现 Idea 与 YApi 的无缝衔接吧。

先看一下接口文档生成的效果吧：

接下来我们开始进行同步接口文档的操作：
【第一步】： 打开Idea => File => Settings => Plugins => 搜索 EasyYApi 插件并安装

【第二步】： 安装完成后重启Idea

【第三步】： 打开Idea => Settings => Other Settings => EasyApi 设置，在 Yapi 这块区域中中的 server表单中输入我们公司或则个人自己的 Yapi 访问地址，比如：http://127.0.0.1:8677

【第四步】： 找到对应的需要创建或者更新的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,;}

3、更新单个API

在上文的基础上，如果有一个controller中有多个接口，我们只想更新其中某一个接口应该怎么操作呢？

【步骤一】： 在对应controller 鼠标右键，单击 Export Api

【步骤二】： 在弹出的面板中按需选择要更新的接口，回车即可

扩展知识点：

当我们第一次执行上文中的【第四步】同步接口到 YApi，我们输入Token之后，我们的 idea 中会对其进行保存，可通过 Idea => Settings => Other Settings => EasyApi 面板查看

注意： controller.java 文件必须要有文件注释，文件中的方法需要添加注解 @RequestMapping/@PostMapping 等任意一个，不添加无法识别方法为接口方法。就算父类方法添加了注解 @RequestMapping/@PostMapping 也无法识别，方法必须添加方法注释(接口名称就是根据方法注释生成)

2、postman方式

1、配置

在下方图片中 Postman > token 位置配置 Postman 中项目对应的 token Postman token获取Postman Integrations Dashboard

2、使用

右键Controller类 > Generate > Export Postman

其他配置方式

1、第一步：

Easy Yapi 提供了额外使用的配置文件（以设置 api 指定返回值为例）
在项目根路径下添加 yapi.config 文件，其格式为 properties 格式，官方支持的文件名及格式如下文档地址：EasyYapi

第二步：

加载外部的配置文件，可以是内外网可访问文件或本地文件
文件内容如下（两种模式二选其一，推荐使用 link 模式，与Java注释一致，可链接）

# 支持设置返回类型 package 模式（不建议）
method.return=#real_return
# 支持设置返回类型 link 模式（建议）
method.return[#real_return]=groovy:helper.resolveLink(it.doc("real_return"))

官方文档位置：method_return 新增配置的使用方式

IDEA：Idea 集成 EasyYApi 插件实现接口文档的生成与更新相关推荐

SpringBoot集成knife4j实现Swagger接口文档
前言:如果你是后台开发,提供restful接口给前端,建议你使用Swagger3提供restful的接口文档自动生成和在线接口调试.knife4j是对Swagger进一步封装,其优化了API文档的UI ...
写接口文档及生成mock数据
写接口文档及生成mock数据在web应用开发的过程中,与前端联调时总会有一些接口,需要接口文档,在接口先行的情况下,前端不能拿到实际的接口进行开发,所以就需要mock数据. 今天搜索了下,阿里在这方 ...
SpringBoot - 集成Swagger、Knif4j接口文档以及文档添加账号密码登录
文章目录集成Swagger.Knif4j 依赖配置演示集成Swagger.Knif4j 依赖 pom.xml <!-- 引入Knife4j的官方start包,Swagger2基于Spri ...
IDEA 利用EasyApi插件导出接口文档
背景当我们使用Spring编写接口后,需要接口文档化,方便测试与前端人员使用该接口.此处我们使用了Yapi作为API文档工具而不是Swagger,这是技术选择导致的. 为了方便我们将spring的C ...
php怎么根据接口文档实现功能,CodeIgniter+swagger实现 PHP API接口文档自动生成功能...
一.安装swagger 1.首先需要有composer,没有的自行百度安装 2.下载swagger,打开网站https://packagist.org/packages/zircote/swagger ...
Django接口文档的生成
Django接口文档两种生成方法一.django-rest_framework风格接口文档: 1.安装依赖 pip install rest_framework #如果之前有了就跳过这步 pip i ...
接口文档如何编写，接口文档快速生成工具
正规的团队合作或者是项目对接,接口文档是非常重要的,一般接口文档都是通过开发人员写的.一个工整的文档显得是非重要.下面我总结下自己看到的优秀接口文档. 一.背景介绍接口:API API(Applic ...
在html文件中集成easy,easyapi 通过java注解或注释自动生成带页面的接口文档
Java-自动生成带页面可调试的接口文档介绍:一款java接口文档自动生成的插件,包含了根据接口注释或注解自动生成接口文档,可网页打开. 特点:一款无任何代码侵入的生成方式,10秒钟集成 1.支持读 ...
idea swagger生成接口文档_spring boot集成Swagger-UI接口文档
本文介绍如何用spring boot集成Swagger-UI,实现项目在线接口文档一.Swagger-UI简介 Swagger是一个Restful风格接口的文档在线自动生成和测试的框架官网对Swa ...

IDEA：Idea 集成 EasyYApi 插件实现接口文档的生成与更新

文章目录