yapi idea 上传插件,快速生成文档

YapiIdeaUploadPlugin

目的

减少yapi 录入时间，通过工具反向规范代码注释，和代码整洁

支持语言

java

单个&批量

单个上传选中方法
批量上传选中类名

支持接口

目前 dubbo 接口/api

支持yapi 的版本

1.5.0+

使用方式

下载yapiupload jar 包（或者在idea 插件库搜索）
打开idea，preferneces->plugins-> install plugin from disk（或者搜索 yapiupload),导入jar 包后(install)，重启
配置信息：在项目目录下，.idea 文件夹下，找到misc.xml (如果找不到.idea 请查看是否被折叠或被隐藏) 如果是 .ipr 模式创建的就找到项目名.ipr

token 获取方式：打开yapi ->具体项目->设置->token 配置
项目id 获取方式：点击项目，查看url 中project 后面的数字为项目id http://127.0.0.1:3000/project/72/interface/api
yapiUrl 固定
projectType 根据你要上传的接口类型决定，如果为dubbo 接口就填dubbo ，如果是api 接口就填api

<component name="yapi">
  <option name="projectToken">yapi 中项目token</option>
  <option name="projectId">yapi 中项目id</option>
  <option name="yapiUrl">http://127.0.0.1:3000</option>
  <option name="projectType">api</option>
</component>

如果是dubbo 项目，选中dubbo interface 文件中的一个方法（要选中方法名称），右击YapiUpload(alt+u 快捷键)
如果是api 项目，选中controller 类中的方法名称或类名（要选中方法名称，或类名，选中类名为当前类所有接口都上传），右击YapiUpload(alt+u快捷键)

注意：接口会上传到一个临时文件目录下 tool-temp，根据需要移动

使用规则

良好的java doc 注释能生成更好的文档，如下：生成的文档中属性就可以带上注释

/** 
* 年龄
*/
private Integer age;

生成的文档接口名称就可以使用：添加或更新课程数据,没有注释默认使用接口路径做为名称

    /**
     * 添加或更新课程数据
     *
     * @param courseOpt
     * @return {@link CommonRes}
     */
    @RequestMapping(value = "/test", method = RequestMethod.POST)
    public Course addOrUpdateCourse(@RequestBody CourseParam courseParam){

    }


    /**
     * @description: 添加或更新课程数据
     * @param: [sources, count]
     * @return: java.util.List<com.btime.recommend.dto.babyRearing.BaseBabyRearingDO>
     * @date: 2018/3/15
     */
     @RequestMapping(value = "/test", method = RequestMethod.POST)
     public Course addOrUpdateCourse(@RequestBody CourseParam courseParam){

    }

支持@link 参量定义展示在字段备注中

第一种@link 方式

/** 
* 状态 {@link com.xxx.constant.StatusConstant}
*/
private Integer status;


第二种@link 方式

import com.xxx.constant.StatusConstant;

/** 
* 状态 {@link StatusConstant}
*/
private Integer status;


不支持方式
import com.xxx.constant.*;

/** 
* 状态 {@link StatusConstant}
*/
private Integer status;