前言
写代码的快乐,在于通过一顿猛如虎的操作,实现了自己设计的逻辑流程。(也可能并不是很快乐!)
这时候,你以为就可以关机么?
还有接口文档没写呢!
哈?
开始进入无限 CV 模式,各种请求参数、必填非必填、请求返回示例!
几分钟后…… 🤬🤬🤬
我要写个 IDEA 插件,以后再也不想手写文档了!
下面,来看看我肝出来的插件吧!
功能介绍
插件名字必须得先介绍,Doc View
,有兴趣的小伙伴直接在 IDEA 中搜索插件即可。
- Controller/Dubbo 接口文档生成
- 支持 Validation、Swagger 等注解
- Markdown 接口查看、预览、复制、导出
- 支持自定义生成接口的 Markdown 模版
- 支持界面编辑文档、注释、并同步保存到代码注释中
- 支持在编辑实体界面, 将实体复制为 Json 字符串
- 支持上传文档到 YApi
- 支持自定义配置
功能就不留悬疑了,直接介绍出来,下面用再用图文介绍下,毕竟干巴巴的说文字介绍,也太么得感情了!
主界面
生成 Markdown
生成 Markdown 文档包含:接口名称、接口描述、请求路径、请求方式、请求参数、请求示例、返回参数、返回示例。
这些全都是根据方法的注释、注解、出参、入参解析出来的
小伙伴想看源码或者提交 PR,文末有 github 地址。
为什么生成 Markdown?
因为格式比较好看,并且很容易转换为 Html、PDF、Word 等格式。
直接将 Markdown 文本复制到 VS Code,预览图如下:
- 自定义 Markdown
这里也是支持一定程度上自定义 Markdown 的格式的。
可以在 IDEA 设置选项中,找到 Doc View 的相关设置,进行自定义 Markdown 的样式。
- 字段注释设置
这里支持 Swagger3、Swagger、注释 tag 的方式设置相关信息。
面板功能
- 预览
左下角直接使用 IDEA 内置 Markdown 面板进行预览文件。
IDEA 2020.2 以上版本才可以哦!
- 导出
在面板左右两边,分别有两个导出按钮,对应着批量导出和导出当前。
- 复制
直接将 Markdown 文本复制到剪贴板。不过也可以直接在文本域中使用 ⌘ + A
全选后复制。
也可以 ⌘ + F
唤出搜索框,不过一般很少使用。
上传 YApi
如果说生成 Markdown 文本,是为了方便复制到 ShowDoc 之类支持 Markdown 的 API 文档网站,那 Api 呢?
这里也是支持的!
直接通过上传按钮,可以一键上传到 YApi。
不过记得设置地址和 Token。
文档编辑
核心功能除了生成 Markdown、预览、上传 YApi 之外,这个功能相对来说还不是很完善。
那就是编辑文档及字段。
Doc Editor 可以在方法、实体类中使用,并生成相应的注释。
并且可以将实体类复制为 Json。
这个功能和 Toolkit 类似。
总结
整体功能就这些了,基本可以满足大部分文档需求。其他的就是边边角的修修改改。
来来来,小伙伴们一起用起来,帮忙踩踩坑,提提建议。