个人中心
gpt4 book ai didi

java快速生成接口文档的三种解决方案

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

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

这篇CFSDN的博客文章java快速生成接口文档的三种解决方案由作者收集整理，如果你对这篇文章有兴趣，记得点赞哟.

前言

常常在项目收尾阶段，客户需要项目的接口文档，或者是一个大的sass平台，各个产品之间互相调用的时候，需要对方提供接口文档 。

通常来说，接口文档属于产品的技术沉淀，是一个长期积累的过程，然而，很多时候，开发阶段并不会想的那么多，结果到了需要接口文档的时候总是疲于应付，情急之下，往往采用最笨拙的办法，就是对照着项目代码，一个个拷贝吧 。

下面针对这个情况，小编这里给出2种简单、快捷而适用的解决方案，帮助你快速解决这个烦恼吧 。

方案一，使用japidocs

这是一种最简单也最高效的快速生成接口文档的方式，也是对既有项目改造代价最小的方式 。

  • 可用于生成spring boot api文档
  • 读取JAVA DOC注释，无需额外的代码改造

基本用法

1、添加依赖 。

?
1
2
3
4
5
<dependency>
     <groupId>io.github.yedaxia</groupId>
     <artifactId>japidocs</artifactId>
     <version> 1.4 . 3 </version>
</dependency>

2、在工程的某个包下面，添加一个类 。

java快速生成接口文档的三种解决方案

如这里有一个TestApi的类，里面添加一个main方，使用如下模板代码即可，自己使用时，需要简单修改几处，项目根目录，生成文档的目录 。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
public class TestApi {
 
     public static void main(String[] args) {
         DocsConfig config = new DocsConfig();
         // 项目根目录
         config.setProjectPath( "E:\\学习代码\\assmblyone\\web" );
         // 项目名称
         config.setProjectName( "Assembly" );
         // 声明该API的版本
         config.setApiVersion( "V2.0" );
         // 生成API 文档所在目录
         config.setDocsPath( "E:\\学习代码\\assmblyone" );
         // 配置自动生成
         config.setAutoGenerate(Boolean.TRUE);
         // 执行生成文档
         Docs.buildHtmlDocs(config);
     }
 
}

这里假如工程中有一个UserController接口类 。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
@RestController
@RequestMapping (value = "/api2doc" )
public class UserController {
 
     /**
      * 获取用户讯息
      * @return
      */
     @ApiComment ( "获取用户。" )
     @GetMapping ( "/getUser" )
     public User getUser() {
         User user = new User();
         user.setGroup( "group1" );
         user.setName( "first-group" );
         return user;
     }
 
     /**
      * 新增用户
      * @param group 用户组名称
      * @param name  基础名称
      * @return
      */
     @ApiComment ( "添加新用户" )
     @GetMapping (name = "新增用户" , value = "/user" )
     public String addUser(String group, String name) {
         return " group:" + group + " ==== " + "name :" + name;
     }
 
}

有一个实体类User 。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
@Data
public class User {
 
     /**
      * id主键
      */
     private Long id;
 
     /**
      * 用户名
      */
     private String name;
 
     /**
      * 账号密码
      */
     private String password;
 
     /**
      * 用户所在的组
      */
     private String group;
 
     /**
      * 用户类型
      */
     private UserType type;
 
     /**
      * 是否已删除
      */
     private Boolean deleted;
 
     /**
      * 创建时间
      */
     private Date createTime;
 
}

为了让生成的文档看起来更加完善，controller的各个接口名称，以及实体中的字段等注释一定要尽可能完整 。

然后运行一下main方法，生成一下吧 。

java快速生成接口文档的三种解决方案

然后会发现，在指定的文件目录下，针对项目中的各个controller类，生成了html文档，不妨打开看一下吧 。

java快速生成接口文档的三种解决方案

这个效果也算很良心了，到这里是不是值得小小庆贺下呢,当然对于japidocs来说，功能可不止这些，有兴趣的同学可以继续深入研究下呢 。

方案2，swagger + knife4j

相信使用过springboot框架的同学对swagger插件一定不陌生，springboot中集成swagger 可以帮助我们快速进行接口调试，以提升开发人员的接口调试效率 。

但是单纯使用swagger的话，效果往往并不理想，比如想使用swagger导出一份可以交付的接口文档的话，就有点困难了，这就需要swagger 配合knife4j一起使用了 。

生成步骤

1、导入相关依赖 。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<dependency>
     <groupId>com.github.xiaoymin</groupId>
     <artifactId>knife4j-spring-boot-starter</artifactId>
     <version> 2.0 . 4 </version>
</dependency>
 
<!--swagger-ui-->
<dependency>
     <groupId>io.springfox</groupId>
     <artifactId>springfox-swagger2</artifactId>
     <version>${swagger.version}</version>
</dependency>
<dependency>
     <groupId>io.springfox</groupId>
     <artifactId>springfox-swagger-ui</artifactId>
     <version>${swagger.version}</version>
</dependency>
<dependency>
     <groupId>com.github.xiaoymin</groupId>
     <artifactId>swagger-bootstrap-ui</artifactId>
     <version>${swagger-bootstrap-ui.version}</version>
</dependency>

2、添加swagger配置类 。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
@Configuration
@EnableSwagger2
@EnableKnife4j
public class ApiSwagger2 {
 
     @Bean
     public Docket createRestBmbsApi() {
         return new Docket(DocumentationType.SWAGGER_2)
                 .groupName( "users" )
                 .apiInfo(apiInfo())
                 .select()
                 .apis(RequestHandlerSelectors.basePackage( "com.congge.controller" ))
                 .paths(PathSelectors.any())
                 .build();
     }
 
     private ApiInfo apiInfo() {
         return new ApiInfoBuilder()
                 .title( "用户相关API" )
                 .version( "1.0" )
                 .build();
     }
 
}

3、启动项目之后分别访问如下地址 。

http://localhost:8048/swagger-ui.html 。

java快速生成接口文档的三种解决方案

这个界面想必大家一定很熟悉了，这就是swagger界面，可以在这个上面快速进行接口调试工作 。

http://localhost:8048/doc.html#/home 。

java快速生成接口文档的三种解决方案

java快速生成接口文档的三种解决方案

这个界面就是集成了knife4j之后展示出来的效果，这个效果看起来是不是更好了点 。

java快速生成接口文档的三种解决方案

点就到文档管理菜单栏，提供了几种常用的可用于下载的接口文档方式，比如我们以html为例，点击下载，然后看一下效果如何 。

java快速生成接口文档的三种解决方案

方案3，开源的接口文档生成工具

这里推荐2种 。

1、japi ，这是一个开源项目，git上面可以下载之后本地运行，需要安装node环境 。

这里推荐一篇文章，可供参考：http://www.zzvips.com/article/201172.html 。

2、使用ApiPost工具快速生成在线接口文档 。

ApiPost是一个支持团队协作，并可直接生成文档的API调试、管理工具。它支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员不可多得的工具 。使用者不仅可以利用apiopst调试接口，还可以书写相关注释（接口文档），方便的生成可读性好、界面美观的在线接口文档.

使用ApiPost需要下载官方安装包，然后本地安装即可，官网软件下载地址：https://www.apipost.cn/ 。

关于ApiPost，由于其功能的强大，被很多开发人员，测试人员以及项目管理人员等广泛使用，在小编所在的产品测试团队，不少测试同事使用这款工具 。

对小编来说，所有麻烦的事情一律都采用保守的态度，但是这款工具确实值得推荐和学习，界面风格很相PostMan，这里有一篇详细介绍ApiPost使用的文档，提供参考和学习：https://www.cnblogs.com/gina61/articles/12931356.html 。

总结

到此这篇关于java快速生成接口文档的三种解决方案的文章就介绍到这了,更多相关java快速生成接口文档内容请搜索我以前的文章或继续浏览下面的相关文章希望大家以后多多支持我！ 。

原文链接：https://blog.csdn.net/zhangcongyi420/article/details/119151683 。

最后此篇关于java快速生成接口文档的三种解决方案的文章就讲到这里了,如果你想了解更多关于java快速生成接口文档的三种解决方案的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！ 。

25 4 0
文章推荐： 王者荣耀女英雄去掉所有内无2021 王者荣耀去掉所有服装图片
文章推荐： PHP数组中头部和尾部添加元素的方法(array_unshift,array_push)
文章推荐： 王者荣耀游客模式算防沉迷时间吗 王者荣耀游客模式游戏时间规则
文章推荐： SpringBoot如何自动生成API文档详解
qq735679552
个人简介

我是一名优秀的程序员,十分优秀！

滴滴打车优惠券免费领取
滴滴打车优惠券
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com