swagger2与yapi以及idea上的yapiupload插件

开发中有的人喜欢用swagger2，也有人喜欢用yapi，总之是各有各爱，好在yapi上支持多种数据导入，也支持swagger格式，这个对于yapi的版本是有要求的，v1.3.19以前的不支持。

在yapi的官方教程里，提到了项目设置里token就是后续版本里新增，且要swagger新增配置文件需要的，之前就是忽略版本问题，折腾好半天。

搜寻网络上资料还有另一种方式，就是YapiIdeaUploadPlugin插件，这个idea还是好用呀。以前的时候还是手动拷贝到yapi上，今次看到这个插件真好呀。

打开idea，preferneces->plugins->install plugin from disk（或者搜索yapiupload)

配置文件.idea 文件夹下的misc.xml

<component name="yapi">

<optionname="projectToken">ea4ad1b6033375dac2d01fe713c43745cd5cc1b71773844443bd77a61179bd4e</option>

<option name="projectId">11</option>

<optionname="yapiUrl">http://127.0.0.1:3000</option>

<optionname="projectType">api</option>

</component>

可以单个接口上传那就选中方法右键上传即可。也可以批量上传那就选中类名 右键上传。

相对而言，我还是更推荐yapi，没有了无关代码侵入，节省时间，维护代码整洁，而且可以通过工具反向规范代码注释，阅读起来轻松自如。