开发中有的人喜欢用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,没有了无关代码侵入,节省时间,维护代码整洁,而且可以通过工具反向规范代码注释,阅读起来轻松自如。