Java接口文档生成工具--Easy-Doc

今天给大家介绍一个最近自己一直在搞的接口文档生成工具Easy-Doc,首先来说一下做这个的初衷吧。

  • 首先呢,原来都是用的swagger,但是觉得代码侵入性太强了,要使用很多的注解,并且很多同事都不太想学这些注解。
  • 其次返回非对象的数据无法添加注释
  • 最后呢缺少一个压力测试的集成
    所以我结合以上几点,开发了一款更加轻量易用的接口文档工具。

下面先来看一下效果图吧,希望大家能够喜欢!


Java接口文档生成工具--Easy-Doc_第1张图片
首页
Java接口文档生成工具--Easy-Doc_第2张图片
接口展开
Java接口文档生成工具--Easy-Doc_第3张图片
接口详情
Java接口文档生成工具--Easy-Doc_第4张图片
接口运行结果
Java接口文档生成工具--Easy-Doc_第5张图片
接口返回对象
Java接口文档生成工具--Easy-Doc_第6张图片
对象描述
Java接口文档生成工具--Easy-Doc_第7张图片
Models描述
Java接口文档生成工具--Easy-Doc_第8张图片
压力测试
Java接口文档生成工具--Easy-Doc_第9张图片
接口列表
Java接口文档生成工具--Easy-Doc_第10张图片
压力测试结果
Java接口文档生成工具--Easy-Doc_第11张图片
全局参数
Java接口文档生成工具--Easy-Doc_第12张图片
Token

是不是功能还是不错的?

整体的设计思路如下

  • 本地使用

    • 使用java-doc格式书写注释
    • 通过正则匹配出注释
    • 做渲染操作
    • 返回前端页面
  • 服务器jar包使用

    • 使用maven或者gradle插件生成正则匹配后的源文件,然后上传到服务器
    • 做渲染操作
    • 返回前端页面

下面是项目在github的地址,包括前端(React),Maven(Java),Gradle(Groovy),Core(Java-Web)。

项目地址

Java接口文档生成工具--Easy-Doc_第13张图片
项目图

你可能感兴趣的:(Java接口文档生成工具--Easy-Doc)