欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

SpringBoot如何自动生成API文档详解

程序员文章站 2022-06-30 23:14:30
前言在做项目的时候,如果项目是前后分离的,后端一定要和前端或者是移动端对接接口,那么问题来了,接口是不是要自己写给他们看,一般的会采用excel或者word来写,高级一点的就采用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文档登录

SpringBoot如何自动生成API文档详解

使用自己的帐号登录就可以看到所有项目

SpringBoot如何自动生成API文档详解

进入项目看详细restful接口

SpringBoot如何自动生成API文档详解

使用场景

japi最适合在springcloud这样的分布式多模块项目中使用,内置强大的正则表达式,这会让代码注释更加规范,区别于swigger这类使用侵入式注解生成文档的,japi是完全基于标准注释生成的,支持强大的jsr303或者是自定义注解。

开源精神

欢迎有意向的同学加入japi项目组将它改造得更好。

总结

到此这篇关于springboot如何自动生成api文档的文章就介绍到这了,更多相关springboot自动生成api文档内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!