前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >使用japidocs生成springboot api文档

使用japidocs生成springboot api文档

作者头像
路过君
发布2020-10-28 11:13:48
1.1K0
发布2020-10-28 11:13:48
举报
文章被收录于专栏:路过君BLOG from CSDN
  • 可用于生成spring boot api文档
  • 读取JAVA DOC注释,无需额外的代码改造

基本用法

1. 添加依赖

代码语言:javascript
复制
<dependency>
  <groupId>io.github.yedaxia</groupId>
  <artifactId>japidocs</artifactId>
  <version>1.4.3</version>
</dependency>

2. 创建main函数

代码语言:javascript
复制
public class ApiDocs {
	// 项目名称
    private static final String PROJECT_NAME = "ProjectName";
    // 版本
    private static final String VERSION = "V2.0";
    // 路径
    private static final String PROJECT_PATH = "C:\\ProjectName";

    public static void main(String[] args) {
        DocsConfig config = new DocsConfig();
        config.setProjectPath(PROJECT_PATH + "\\src");
        config.setProjectName(PROJECT_NAME);
        config.setApiVersion(VERSION);
        config.setDocsPath(PROJECT_PATH + "\\docs");
        config.setAutoGenerate(Boolean.TRUE);
        Docs.buildHtmlDocs(config);
    }
}

3. 执行

将在C:\ProjectName\docs\V2.0\路径下生成文档文件 首页index.html效果如图

在这里插入图片描述
在这里插入图片描述

接口效果如图

在这里插入图片描述
在这里插入图片描述

注意

如果API的参数或返回类型中存在依赖项目中的类,会报找不到类的异常,但不影响生成,只是无法看到具体类的结构

解决办法

直接将目标项目引入作为依赖即可

参考

JApiDocs中文官网 JAVA DOC 参考

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2020/10/19 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 基本用法
    • 1. 添加依赖
      • 2. 创建main函数
        • 3. 执行
        • 注意
          • 解决办法
          • 参考
          领券
          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档