gpt4 book ai didi

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

转载 作者:qq735679552 更新时间:2022-09-27 22:32:09 26 4
gpt4 key购买 nike

CFSDN坚持开源创造价值,我们致力于搭建一个资源共享平台,让每一个IT人在这里找到属于你的精彩世界.

这篇CFSDN的博客文章SpringBoot如何自动生成API文档详解由作者收集整理,如果你对这篇文章有兴趣,记得点赞哟.

前言

在做项目的时候,如果项目是前后分离的,后端一定要和前端或者是移动端对接接口,那么问题来了,接口是不是要自己写给他们看,一般的会采用Excel或者Word来写,高级一点的就采用API管理平台手工录入,一个项目有上千上万个接口,天啊,这是多么大的工作量,在接口维护的时候更加痛苦,为了解决这样的事我们可以借助 japi 这个项目来完成RESTFul文档的自动生成,完全基于注释生成,更多详细配置可查看https://github.com/dounine/japi.

使用说明

克隆项目下来 。

git clone https://github.com/dounine/japi.git

编译打包 。

cd japi/javagradle install -xtest

运行JAPI后台管理 。

cd japi/javagradle bootRun

运行JAPI文档界面 。

cd japi/nodenode app.js

生成RESTFul文档

maven项目 。

<dependency>    <groupId>com.dounine.japi</groupId>    <artifactId>client</artifactId>    <version>1.0</version></dependency>

gradle项目 。

compile group: "com.dounine.japi", name: "client", version: "1.0"

编辑resources/japi.properties配置文件 。

japi.name=testjapi.uuid=43a600877430438596de3d330e4bd06ejapi.version=1.0.0japi.author=lakejapi.url=http://192.168.0.123:8080japi.description=this is project description.japi.createTime=2017-02-23 10:44:44japi.icon=/home/lake/github/japi/html/img/logo.pngjapi.server=http://192.168.0.179:7778japi.server.username=japijapi.server.password=japi123

编写一个action 。

/** * 获取用户列表 * @param user 用户信息 * @return class User * @version v2 */@GetMapping(value = "v2/list")public Result hots(@Validated({User.UserDEL.class}) User user) throws RuntimeException {    return null;}

编写一个API生成类 。

JapiCreateTest.java 。

@Test    public void testCreate(){        JapiClient.setPrefixPath("/home/lake/github/test-japi/java/");//项目路径前缀        JapiClient.setpostfixPath("/src/main/java");//项目路径后缀        JapiClient.setProjectJavaPath("client");//主项目地扯        JapiClient.setActionReletivePath("com/dounine/test-japi/action");//相对主项目action包所在路径        //JapiClient.setIncludeProjectJavaPath(new String[]{"api"});//主项目中关联的其它项目包路径        JapiClient.setIncludePackages(new String[]{"com.dounine.test-japi"});//关联的包,用于准确快速搜索        JapiClient.saveHistory(true);//是否保留本地历史版本        JapiClient.setFlushServer(false);//强制同步本地与服务器所有的版本(会先删除服务器以前的历史版本)        IProject project = ProjectImpl.init();        JapiClientStorage japiClientStorage = JapiClientStorage.getInstance();        japiClientStorage.setProject(project);        japiClientStorage.autoSaveToDisk();//自动使用到本地磁盘==> 用户目录/.japi-client/        new JapiClientTransfer().autoTransfer(japiClientStorage);//文件传输到主服务器.    }

最后访问浏览器 http://localhost:7777 。

就可看到RESTFul文档登录 。

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

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

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

进入项目看详细RESTFul接口 。

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

使用场景

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

开源精神 。

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

总结

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

原文链接:https://www.jianshu.com/p/8ac211d9c6d3 。

最后此篇关于SpringBoot如何自动生成API文档详解的文章就讲到这里了,如果你想了解更多关于SpringBoot如何自动生成API文档详解的内容请搜索CFSDN的文章或继续浏览相关文章,希望大家以后支持我的博客! 。

26 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com