springboot+swagger接口文档企业实践（下）

最新推荐文章于 2020-05-20 14:48:41 发布
最新推荐文章于 2020-05-20 14:48:41 发布
阅读量359 收藏 3
点赞数 1
分类专栏： Spring Boot 文章标签： springboot swagger doc
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/masson32/article/details/103180461
版权

tags: springboot swagger doc

文章目录

一句话概括：基于springboot+swagger实现接口文档显示后，本文将给出在企业实践的进阶需求，包括接口按需过滤，前端mock数据，文档离线导出。

1.引言

在上一篇文章《springboot+swagger接口文档企业实践（上）》已对使用springboot+swagger的接口文档构建及配置进行了介绍，可以实时显示接口的输入输出，还可以调用接口调试。解决了后端开发人员写接口文档的难处。但在企业实践中，还有一些问题需要解决，如以下几种：

  • 发布指定的接口：不希望把全部的接口都对外发布提供，只需要发布指定的接口。
  • 发布指定版本接口：每一次版本迭代，只需要对变更和新增的接口进行说明，而不是每次都输出全部的接口（每次都全量发布接口，前端人员还得与后端沟通哪些是变更和新增接口，无疑会增加工作量）
  • mock接口数据：有了接口文档，前后端可以并行开发，此时前端需要模拟接口的返回数据来显示效果，测试内容等。
  • 离线导出接口文档：当前的接口文档是通过页面访问的，但有些企业（特别注重文档交付的企业）还是有一些特殊需求，需要离线的接口文档。

针对以上的情况，本文提供相应的解决方法，主要包含以下内容：

  1. 接口过滤：通过包过滤、类注解过滤、方法注解过滤、分组过滤等方式，实现按需发布指定接口的功能。
  2. 使用easy-mock+swagger实现mock数据。
  3. 使用maven插件实现接口文档的离线导出。

本文配套的示例工程地址：https://github.com/mianshenglee/my-example/tree/master/springboot-swagger-demo/advance-swagger-demo，读者可fork或pull下来，结合学习。

2. swagger接口过滤

对于swagger的接口文档，在实践开发中，一般只需要发布指定的接口，按需发布即可，针对版本迭代，只需要对变更和新增的接口进行说明，而不是每次都输出全部的接口。这些需求都属于swagger的接口过滤功能。在springboot的swagger配置类(Swagger2Config.java)中，Docket提供了apis()和paths()两个方法用于接口过滤，下面详细说明一下。

2.1 按包过滤(package)

一般接口都是写在控制器(controller)中，而controller一般都统一放在一个package中，这样，可以通过包过滤显示指定包的接口。通过在配置文件Swagger2Config.java中使用apis()函数进行过滤，把需要显示的接口使用函数进行返回，注意，此处的参数enableClassFilter，enableMethodFilter和groupsFilters分别对应后面的过滤方法，定义如下：

private List<Predicate<RequestHandler>> apisFilter(boolean enableClassFilter,boolean enableMethodFilter, String[]groupsFilters) {
    List<Predicate<RequestHandler>> apis = new ArrayList<>();
    String basePackageStr = swaggerInfo.getBasePackage();
    // 1.包过滤
    if (StrUtil.isNotEmpty(basePackageStr)) {
        //支持多个包
        String[] basePackages = basePackageStr.split(";");
        if (null != basePackages && basePackages.length > 0) {
            Predicate<RequestHandler> predicate = input -> {
                // 按basePackage过滤
                Class<?> declaringClass = input.declaringClass();
                String packageName = declaringClass.getPackage().getName();
                return Arrays.asList(basePackages).contains(packageName);
            };
            apis.add(predicate);
        }
    }
    return apis;
}

此处代码作用是按配置项swagger.basePackage的包（多个包用;分隔），从接口所在类中获取包名，若包名是在配置的包内，则返回，并把匹配的内容使用List返回。然后在apis()调用时对返回值进行and操作Predicates.and(apisFilter())，这样，返回的内容就只是指定的包的接口描述。

2.2 按类注解过滤

接口一般是在Controller类中，对于springmvc的controller，都会使用@Controller进行注解，甚至前后端分离一般都是使用@RestController，因此，如果我们想只显示使用@RestController注解的类的接口，则可以对此进行过滤。在前面的apisFilter()方法中。使用isAnnotationPresent可判断是否有某注解，如下所示

// 2.过滤被RestController注解的类
if(enableClassFilter){
    Predicate<RequestHandler> predicate = input -> {
        Class<?> declaringClass = input.declaringClass();
        return declaringClass.isAnnotationPresent(RestController.class);
    };
    apis.add(predicate);
}

2.3 按方法注解过滤

按类注解是把整个类过滤掉，粒度较大，如果只想按方法过滤，可以使用swagger的@ApiIgnore注解对接口进行过滤，有此注解则不显示。也可以通过判断是否存在某个指定方法注解来过滤。swagger的接口描述一般都用@ApiOperation，因此，可以通过判断接口是否存在此注解，如果没有则不显示。如下：

// 3.过滤被ApiOperation注解的方法
if(enableMethodFilter){
    apis.add(input -> input.isAnnotatedWith(ApiOperation.class));
}

2.4 按分组过滤

swagger的接口文档如果没有指定groupName，则会默认以default作为分组名，对应的接口文档是v2/api-docs?group=default，它会按apis过滤后的全部接口显示出来。在迭代版本时，有个显示的需求是只需要显示当前版本变更和新增的接口。其实也是使用注解过滤的方式，结合groupName进行设置即可。具体如下：

2.4.1 定义注解ApiVersion

此注解需自定义，用于指定版本号，注意可以是多个版本（多版本兼容的情况）。

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface ApiVersion {
    /**
     * 接口版本号(对应swagger中的group)
     * @return String[]
     */
    String[] group();
}

当开发新的版本，在变更和新增的接口中添加此注解，并把版本号写到对应的group中即可，如

@ApiVersion(group = {"v1.0.0"})

2.4.2 添加ApiVersion过滤

在apisFilter()函数中，添加以下过滤代码：

// 4.过滤组
if(groupsFilters !=null && groupsFilters.length >0){
    Predicate<RequestHandler> predicate = input -> {
        ApiVersion apiVersion = input.getHandlerMethod().getMethodAnnotation(ApiVersion.class);
        return apiVersion!=null && ArrayUtil.containsAny(apiVersion.group(),groupsFilters);
    };
    apis.add(predicate);
}

从接口方法中获取ApiVersion注解，并获取它的group参数，通过与指定的分组进行比较，存在即显示，否则不显示。

2.4.3 新建指定版本号分组的Docket

添加新的一个Docket Bean，指定groupName为当前需要显示的版本号，并输入需要过滤的分组数组。如下：

@Bean
public Docket v100Api() {
    Docket docket = new Docket(DocumentationType.SWAGGER_2)
        .groupName(ApiVersionConstant.VERVION_100)
        ...//略
    ApiSelectorBuilder builder = docket.select();
    //指定需要过滤的版本号
    builder = builder.apis(Predicates.and(apisFilter(false,true,new String[]{ApiVersionConstant.VERVION_100})));
    ...//略
    return builder.build();
}

经过上面的处理，显示的接口界面有两个分组，一个是default，一个是指定的版本号(v1.0.0)，指定版本显示的接口即是当前版本变更或新增的接口描述，如下：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-GYe2tXUy-1574311501516)( https://gitee.com/mianshenglee/datastorage/raw/master/md-photo/swagger/swagger2/swagger-group.png )]

3. 接口mock数据

有了接口文档，前后端可以并行开发，此时前端需要模拟接口的返回数据来显示效果，测试内容。虽然swagger提供example属性，可以在返回结果中提供示例，但对于前端而言，单一的示例不足以满足显示和测试的需求。需要对数据按接口情况进行mock。easy-mock是一个很好的选择，它可以连接swagger，自动生成mock数据，也可以自定义mock规则。下面对easy-mock+swagger的使用进行描述。

3.1 easy-mock安装

根据easy-mock的官网介绍（官网经常挂掉，建议直接使用它的github私有部署）， Easy Mock 是一个可视化，并且能快速生成模拟数据的持久化服务。 可以使用它的在线服务，也可以私有部署。它是开源项目，github地址：https://github.com/easy-mock/easy-mock，具有以下特征：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-uajirQb5-1574311501518)( https://gitee.com/mianshenglee/datastorage/raw/master/md-photo/swagger/swagger2/easy-mock.png )]

它的官方文档和github文档中，已经对easymock的安装和使用进行详细描述，读者可参考官方文档，此处只列出安装的关键点和需要注意的地方（本文使用的easy-mock及相关工具是在centos7上安装的）。

  1. 安装easy-mock前，需先安装了 Node.js（v8.x）、 MongoDB（>= v3.4）、 Redis（>= v4.0） ，且已正常运行。关于这几个软件的安装与运行，请读者自行查看官网教程。
  2. 安装 easy-mock。
$ git clone https://github.com/easy-mock/easy-mock.git
$ cd easy-mock && npm install
  1. 更改 easy-mock\config 文件夹下的配置文件 default.json，注意修改host为"0.0.0.0"，修改连接mongodb的地址以及redis的host，端口等信息。
  2. 启动 easy-mock，这种不是在后台运行的方式，直接ctrl+c可关闭。
$ npm run dev
# 启动后访问 http://127.0.0.1:7300
  1. 使用pm2进行后台启动， 启动成功后，在命令行中输入 netstat -ntlp 查看正在使用的端口（如mongodb的27017,redis的6379,easy-mock的7300等）
$ [sudo] npm install pm2 -g
$ pm2 start app.js

easy-mock启动后，通过浏览器可以访问， 输入用户名和密码（如果用户不存在会自动注册）。

easy-mock界面

3.2 easy-mock + swagger实现mock数据

easy-mock是使用项目来进行接口管理，可以创建个人项目，也可以加入到其它人创建的项目，项目即是需要mock的接口。

3.2.1 创建项目并添加swagger地址

在创建项目时，可以设置swagger的接口文档地址，以此导入swagger的接口进行管理与模拟。前面提到，使用分组过滤可以按版本号来显示接口，因此，创建项目时，可以使用版本号作为项目名称，一个版本对应一个项目。这样，前端在mock数据时就可以针对当前版本进行处理。如下为示例项目中的v1.0.0版本(填写的swagger接口文档地址为v2/api-docs?group=v1.0.0)：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-XylBVvYC-1574311501520)( https://gitee.com/mianshenglee/datastorage/raw/master/md-photo/swagger/swagger2/easy-mock-create.png )]

填写swagger地址后，会自动导入对应的接口，与前端看到swaggger-ui.html的接口一致，执行测试时，也会按swgger的返回数据类型或example进行返回。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fTyMrFAF-1574311501521)( https://gitee.com/mianshenglee/datastorage/raw/master/md-photo/swagger/swagger2/easy-mock-detail.png )]

3.2.2 自定义模拟数据

模拟数据使用的是 Mock.js ，在其官网中有相应的文档、示例和代码。读者可以上去详细阅读。简单来说，mockjs提供了对String，Number，Boolean，Object，Array等数据的模拟规则，只需按规则编写，即可生成随机数据，达到模拟数据效果。生成规则有 7 种格式：

  1. 'name|min-max': value
  2. 'name|count': value
  3. 'name|min-max.dmin-dmax': value
  4. 'name|min-max.dcount': value
  5. 'name|count.dmin-dmax': value
  6. 'name|count.dcount': value
  7. 'name|+step': value

使用了自定义的模拟数据后，需要注意以下几点：

  • 使用了自定义的模拟数据规则后，前端在使用此接口进行模拟数据时，原来在swagger中定义的示例和返回值就会被自定义的数据覆盖。
  • 当后端接口有变化，需要前端在easy-mock中重新同步新的swagger接口，同步前需要备份原来的自定义数据规则，否则，重新同步后，原来自定义的数据会swagger的接口定义覆盖。因此，最好是先备份，然后针对有改动的地方进行规则修改即可。

4.接口文档离线导出

一般在开发过程中使用swagger文档，直接使用浏览器访问swagger-ui.html页面即可满足要求，若有需求是需要导出离线接口文档，总体可以按以下思路进行：

  1. 使用swagger的v2/api-docs的url地址导出json文档（不导出也可以直接使用此url作为输入文档的地址）
  2. 使用swagger2markup工具将json文档转为asciidoc格式文档。
  3. 使用asciidoctor工具将asciidoc文件转html或pdf文件。

4.1 导出swagger的json文档

在浏览器中访问接口文档页面的地址是/swagger-ui.html，而swagger的规范文档的地址是/v2/api-docs，ctrl+s把此文件保存为json文件，如api-docs.json。在项目的根目录添加一个docs目录，用于存放离线文档相关内容，如下所示，分别建立对应文档格式的目录，并把api-docs.json放在swagger目录下：

├─asciidoc 
├─html 
├─pdf 
└─swagger
  └─api-docs.json

4.2 导出asciidoc文档

有了api-docs.json文档，即可使用swagger2markup导出asciidoc文档，Swagger2Markup是Github上的一个开源项目。该项目主要用来将Swagger自动生成的文档转换成几种流行的格式以便于静态部署和使用，比如：AsciiDoc、Markdown、Confluence。使用swagger2markup导出asciidoc文档有两种方式：

  • 引入swagger2markup的jar包，通过编码方式生成对应格式的文档输出。
  • 使用swagger2markup的maven插件，以mvn命令生成对应格式文档输出。

第一种方式示例代码中有提供SwaggerExportTest.java，其中编写了相应的测试代码用于生成文档，请读者自行阅读。本文主要使用第二种方式，即maven插件进行asciidoc文档输出。

4.2.1 设置文档输出相关插件版本

以下插件版本在示例可正常运行，更高的版本有可能会出现不兼容的情况，因此请读者按本文设置的版本进行处理。文档输出的路径以前面指定的相关docs目录为准（${basedir}是项目的根目录）。

<!-- 文档输出插件版本 -->
<swagger.plugin.version>3.1.8</swagger.plugin.version>
<swagger2markup.version>1.3.1</swagger2markup.version>
<swagger2markup.plugin.version>1.3.3</swagger2markup.plugin.version>
<asciidoctor.plugin.version>1.5.7</asciidoctor.plugin.version>
<!-- 文档输出路径 -->
<docs.path>${basedir}/docs</docs.path>
<docs.asciidoc.path>${docs.path}/asciidoc</docs.asciidoc.path>
<docs.html.path>${docs.path}/html</docs.html.path>
<docs.pdf.path>${docs.path}/pdf</docs.pdf.path>
<docs.swagger.json.path>${docs.path}/swagger/api-docs.json</docs.swagger.json.path>

4.2.2 添加swagger2markup-maven-plugin插件

在build/plugins元素下，添加以下元素：

<!-- 1.swagger.json文件转asciidoc文件-->
<plugin>
    <groupId>io.github.swagger2markup</groupId>
    <artifactId>swagger2markup-maven-plugin</artifactId>
    <version>${swagger2markup.plugin.version}</version>
    <configuration>
        <!-- 访问url -->
        <!--<swaggerInput>http://localhost:8080/swaggerdemo/v2/api-docs?group=default</swaggerInput>-->
        <!-- 访问json文件-->
        <swaggerInput>${docs.swagger.json.path}</swaggerInput>
        <!-- 生成多个文档输出路径 -->
        <!--<outputDir>${docs.asciidoc.path}</outputDir>-->
        <!-- 生成单个文档输出路径 -->
        <outputFile>${docs.asciidoc.path}/all</outputFile>
        <config>
            <swagger2markup.pathsGroupedBy>TAGS</swagger2markup.pathsGroupedBy>
            <!-- 选择：ASCIIDOC/MARKDOWN/CONFLUENCE_MARKUP-->
            <swagger2markup.markupLanguage>ASCIIDOC</swagger2markup.markupLanguage>
        </config>
    </configuration>
</plugin>

说明：

  • swaggerInput元素可以是导出的json文件路径，也可以使用访问url地址(v2/api-docs)，效果是一样的。但若使用url，则需要确保先把应用启动，能正常访问url。
  • outputFile元素是指把全部内容输出到一个文件中，若使用outputDir，则会把各种类型的内容，分开成多个文件输出。
  • swagger2markup.markupLanguage元素可以选择导出ASCIIDOC/MARKDOWN/CONFLUENCE_MARKUP三种格式的文档，此处使用ASCIIDOC即可。

4.2.3 使用命令输出文档

添加完此插件后，使用mvn swagger2markup:convertSwagger2markup命令即可以导出文件到指定的目录。如本示例中的输出是docs/asciidoc/all.adoc

4.3 导出html/pdf文档

导出asciidoc文档后，使用asciidoctor插件对其转换为html和pdf文档输出。

4.3.1 添加asciidoctor插件

如下所示，通过添加asciidoctor-maven-plugin，并对它进行配置：

<!-- 2.asciidoc文件转html/pdf文件-->
<plugin>
    <groupId>org.asciidoctor</groupId>
    <artifactId>asciidoctor-maven-plugin</artifactId>
    <version>${asciidoctor.plugin.version}</version>
    <!-- 转换pdf使用的依赖 -->
    <dependencies>
        <dependency>
            <groupId>org.asciidoctor</groupId>
            <artifactId>asciidoctorj-pdf</artifactId>
            <version>1.5.0-alpha.16</version>
        </dependency>
        <dependency>
            <groupId>org.jruby</groupId>
            <artifactId>jruby-complete</artifactId>
            <version>9.2.8.0</version>
        </dependency>
    </dependencies>
    <configuration>
        <sourceDirectory>${docs.asciidoc.path}</sourceDirectory>
        <doctype>book</doctype>
        <sourceHighlighter>coderay</sourceHighlighter>
        <headerFooter>true</headerFooter>
        <attributes>
            <!-- 菜单栏在左边 -->
            <toc>left</toc>
            <!-- 三级目录 -->
            <toclevels>3</toclevels>
            <!-- 数字序号 -->
            <sectnums>true</sectnums>
        </attributes>
    </configuration>
    <!-- 生成html和pdf两种格式 -->
    <executions>
        <execution>
            <id>output-html</id>
            <phase>generate-resources</phase>
            <goals>
                <goal>process-asciidoc</goal>
            </goals>
            <configuration>
                <outputDirectory>${docs.html.path}</outputDirectory>
                <backend>html</backend>
            </configuration>
        </execution>
        <execution>
            <id>output-pdf</id>
            <phase>generate-resources</phase>
            <goals>
                <goal>process-asciidoc</goal>
            </goals>
            <configuration>
                <outputDirectory>${docs.pdf.path}</outputDirectory>
                <backend>pdf</backend>
                <!-- 处理中文字符问题 -->
                <attributes>
                    <pdf-fontsdir>${docs.pdf.path}/fonts</pdf-fontsdir>
                    <pdf-stylesdir>${docs.pdf.path}/themes</pdf-stylesdir>
                    <pdf-style>cn</pdf-style>
                </attributes>
            </configuration>
        </execution>
    </executions>
</plugin>

此配置相对较长，其实主要分为三部分：

  1. 转换pdf使用的依赖，即<dependencies>元素，直接使用即可。
  2. 通用文档配置<configuration>元素，其中需要注意的是<sourceDirectory>，此处需要配置上一个步骤生成的asiidoc文件目录路径。
  3. <executions>元素：由于需要生成html和pdf两种格式的文档，因此分别使用executions来实现。其中html相对简单，配置outputDirectory和backend元素指定输出目录路径和文件格式html即可，对应的pdf也一样配置。

对于pdf文档的转换，需要解决中文字体缺失的问题。

  • 若不配置对应的中文字符支持（即配置中的<attributes>元素），则会出现中文乱码或文字缺失的情况，如下图，缺失了户，对这几个字：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qWf9Vy1b-1574311501522)( https://gitee.com/mianshenglee/datastorage/raw/master/md-photo/swagger/swagger2/doc-pdf1.png )]

  • pdf中文字符支持，在github中，已有对asciidoctor-pdf中文字体的支持，在下载页面下载KaiGenGothicCN开头和RobotoMono开头的ttf字体，同时下载cn-theme.yml文件，分别放到docs/pdf目录下：
├─pdf 
│ ├─fonts 
│ │ ├─KaiGenGothicCN-Bold-Italic.ttf 
│ │ ├─KaiGenGothicCN-Bold.ttf 
│ │ ├─KaiGenGothicCN-Regular-Italic.ttf 
│ │ ├─KaiGenGothicCN-Regular.ttf 
│ │ ├─RobotoMono-Bold.ttf 
│ │ ├─RobotoMono-BoldItalic.ttf 
│ │ ├─RobotoMono-Italic.ttf 
│ │ └─RobotoMono-Regular.ttf 
│ └─themes 
│   └─cn-theme.yml
  • 使用<attributes>元素设置对应的pdf-fontsdir,pdf-stylesdir及pdf-style，指定下载好的fonts目录和themes目录。

4.3.2 使用命令输出文档

使用命令mvn generate-resources，即可生成对应的html和pdf文档到对应的目录，分别是docs/html/all.html及docs/html/all.pdf。效果如下图所示：

  • html文档

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-NFtTHMxh-1574311501523)( https://gitee.com/mianshenglee/datastorage/raw/master/md-photo/swagger/swagger2/doc-html.png )]

  • pdf文档（缺失文字问题已解决）

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Q6G7QgPr-1574311501524)( https://gitee.com/mianshenglee/datastorage/raw/master/md-photo/swagger/swagger2/doc-pdf2.png )]

5. 总结

本篇文章针对接口过滤显示，前端mock数据和离线导出文档等问题，提供相应的解决方法，包括接口过滤（包过滤、类注解过滤、方法注解过滤、分组过滤等方式），实现按需发布指定接口的功能；使用easy-mock+swagger实现mock数据；使用maven插件实现接口文档的离线导出。希望对有需要的同学有所帮助。本文配套的示例工程地址：https://github.com/mianshenglee/my-example/tree/master/springboot-swagger-demo/advance-swagger-demo，读者可fork或pull下来，结合学习。

相关阅读

springboot+swagger接口文档企业实践（上）

参考资料

关注我的公众号，获取更多技术记录：

mason技术记录

masonlee32
关注
专栏目录
Asciidoctor-pdf生成pdf文件
往生堂
05-25 1146
​ asciidoctor-pdf是Asciidoctor一个使用Prawn将asciidoc文档转换成pdf的插件，由Asciidoctor组织开发维护，托管在 GitHub 上，本文将简单介绍下这个插件的使用，部分内容来源于官方。 ​
asciidoctor-pdf-live-reload-seed:asciidoctor + asciidoctor-pdf + asciidoctor-pdf-cjk +浏览器同步+ gulp的示例项目
05-15
asciidoctor-pdf-live-reload-seed 目录 asciidoctor + asciidoctor-pdf + asciidoctor-pdf-cjk +浏览器同步+ gulp的示例项目 这是一个用于PDF输出的Live Reload示例项目，该项目使用asciidoctor和外围工具支持日语输出。 该项目支持Windows和Mac。 1.安装 bundler install npm install -g gulp npm install 2.用法 2.1。简单生成html和pdf 转换为README .adoc转换为html和pdf。 ./generate.sh README.adoc 或者 . / generate.ps1 README.adoc 2.2。实时重新加载（观看并生成html和pdf） gulp 更多细节 我的博客 3.贡献 叉吧！ 创
springboot项目——基于springSecurity实现的前后端分离的企业级人事管理系统
10-03
此项目是采用springboot与springSecurity开发的人事管理系统，前端采用vue，是一个前后端分离的项目
记将github中Asciidoc文档格式项目导出pdf的一次实践
yqztgc123的博客
08-16 3800
首先将github中的Asciidoc项目下载到电脑， 为保留博主操作时的项目源码，这里不要脸的拿出自己fork的一份代码： https://github.com/yeqizhang/progit2-zh
Swagger UI简介
真香号
03-02 6万+
Swagger UI 简介 Swagger UI允许任何人（无论您是开发团队还是最终用户）都可以可视化API资源并与之交互，而无需任何实现逻辑。它是根据您的OpenAPI（以前称为Swagger）规范自动生成的，具有可视化文档，可简化后端实现和客户端使用。 SwaggerUI 特点 无依赖 UI可以在任何开发环境中使用，无论是本地还是在Web端中。 人性化 允许最终...
springBoot+mysql+swagger练手demo.zip
04-03
总结，"springBoot+mysql+swagger练手demo.zip"是一个理想的实践平台，它将带你走进SpringBoot的世界，体验MySQL的数据库操作，同时领略Swagger带来的API管理便利。无论你是初学者还是经验丰富的开发者，这个项目都...
springboot+swagger+版本控制
10-25
SpringBoot结合Swagger与版本控制是现代微服务开发中常见的实践，用于构建清晰、可交互的API文档。在本文中，我们将深入探讨如何在SpringBoot项目中整合Swagger，并实现API的版本控制，解决Swagger页面不显示及JSON...
Springboot+Mybatis+Swagger学生班级demo
08-16
Swagger UI可以自动生成API文档，方便开发者和测试人员理解接口的使用方法。在SpringBoot应用中，通过集成Springfox库，可以轻松地将Swagger与Spring的注解结合，实现API的自动文档化。在这个学生班级demo中，...
springboot+jpa+swagger 动态查询
03-15
Swagger是一个流行的API开发和文档化工具，它允许开发者以简洁的注解方式定义RESTful API接口，生成交互式的API文档。Swagger的文档是基于OpenAPI规范的，这使得API可以被机器和人类清晰理解。Swagger UI可以实时...
5分钟了解swagger
热门推荐
菜刚RyuGou的专栏
08-27 35万+
随着互联网技术的发展，现在的网站架构基本都由原来的后端渲染，变成了：前端渲染、先后端分离的形态，而且前端技术和后端技术在各自的道路上越走越远。 前端和后端的唯一联系，变成了API接口；API文档变成了前后端开发人员联系的纽带，变得越来越重要，swagger就是一款让你更好的书写API文档的框架。其他API文档工具没有API文档工具之前，大家都是手写API文档的，在什么地方书写的都有，有在confl
项目整合带你玩转SwaggerUI
05-20 1122
1.添加项目依赖（就是所谓的jar包） <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.8.0</version> </dependency> <dependency> <group
asciidoctor-pdf中文乱码问题或显示不全
xiaotianlaotian的专栏
02-06 1万+
asciidoctor-pdf是可以把asciidotor文件生成pdf的库 在处理中文adoc文件时，会提示， warning: regexp match /.../n against to UTF-8 string
SSM框架基于swagger2实现API管理
CatalpaFlat的博客
11-14 2424
SSM框架基于swagger实现API管理swagger官网： https://swagger.io/docs/ 1.添加maven依赖<!--swagger--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>${swaggger.v
大杀器！SpringMVC集成Swagger,解决后端接口和功能测试问题！
zx03070723的专栏
11-06 2087
不会或不熟悉前端？没关系！集成Swagger轻松帮助你！ 1.首先映入相关JAR包，我这里是maven项目，所以直接在pom文件引入。 &lt;!--Swagger start--&gt; &lt;!-- springfox-swagger2 --&gt; &lt;dependency&gt; &lt;groupId&gt;io.springfox&lt;/gro...
Spring Boot中使用Swagger2构建强大的RESTful API文档
weixin_34072458的博客
04-18 6093
由于Spring Boot能够快速开发、便捷部署等特性，相信有很大一部分Spring Boot的用户会用来构建RESTful API。而我们构建RESTful API的目的通常都是由于多终端的原因，这些终端会共用很多底层业务逻辑，因此我们会抽象出这样一层来同时服务于多个移动端或者Web前端。 这样一来，我们的RESTful API就有...
Swagger简单实例
weixin_30514745的博客
07-19 336
随着技术的不断发展，网站框架也开始向：前后端分离的形态发展，而且前端技术和后端技术在各自的道路上越走越远。而web api 接口成了前后端唯一的联系。所以web api会变得越来越重要。 那么什么是Web Api呢？ 主要有两点 1.可以对接各种客户端（浏览器，移动设备） 　　　　　　2.构建http服务的框架。 而我们今天要学的Swagger是一款可以让你更好的开发api的框架。 ...
SpringBoot+Swagger-ui：自动化API文档生成与实战
本文档主要介绍了如何在SpringBoot项目中集成Swagger-ui，...本文档为读者提供了一个SpringBoot项目中集成Swagger-ui生成API文档的具体实践教程，对后端开发者在项目开发中实时生成和管理API文档具有很高的实用价值。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值