SpringBoot如何自动生成API文档详解
前言
在做项目的时候,如果项目是前后分离的,后端一定要和前端或者是移动端对接接口,那么问题来了,接口是不是要自己写给他们看,一般的会采用excel或者word来写,高级一点的就采用api管理平台手工录入,一个项目有上千上万个接口,天啊,这是多么大的工作量,在接口维护的时候更加痛苦,为了解决这样的事我们可以借助 这个项目来完成restful文档的自动生成,完全基于注释生成,更多详细配置可查看https://github.com/dounine/japi。
使用说明
克隆项目下来
编译打包
运行japi后台管理
运行japi文档界面
生成restful文档
maven项目
gradle项目
编辑resources/japi.properties配置文件
编写一个action
编写一个api生成类
japicreatetest.java
最后访问浏览器 http://localhost:7777
就可看到restful文档登录
使用自己的帐号登录就可以看到所有项目
进入项目看详细restful接口
使用场景
japi最适合在springcloud这样的分布式多模块项目中使用,内置强大的正则表达式,这会让代码注释更加规范,区别于swigger这类使用侵入式注解生成文档的,japi是完全基于标准注释生成的,支持强大的jsr303或者是自定义注解。
开源精神
欢迎有意向的同学加入japi项目组将它改造得更好。
总结
到此这篇关于springboot如何自动生成api文档的文章就介绍到这了,更多相关springboot自动生成api文档内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!
上一篇: 二手手机99新的套路是什么(二手机套路真相大揭秘)
下一篇: 陈彤:一个网络编辑的11年