swagger2 导出离线 word文档

Swagger2 导出离线文档简述

继上一篇搬运国外的swagger2导出离线文档之后，最近发现国内一款不错的swagger ui组件和导出离线的方法，比之前的更简单优雅。这里主要用的组件是下面的：

<dependency>
  <groupId>net.ifok.swagger</groupId>
  <artifactId>swagger-spring-boot-starter</artifactId>
  <version>1.3.0</version>
</dependency>

Swagger2 如何导出离线word呢？

本次的方法非常简单，首先新建一个spring boot项目，建议。2.2.x-2.4.x版本，可以直接引入上方的组件即可。

项目的pom.xml依赖部分看起来像这样：

$title(pom.xml)
<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>net.ifok.swagger</groupId>
            <artifactId>swagger-spring-boot-starter</artifactId>
            <version>1.3.0</version>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

其他低版本的spring boot 使用，请参考说明 Swagger Spring Boot Stater

接下来就是配置了，配置我这里建议使用yml格式的，因为yml格式支持UTF8编码，可以更好的使用中文。当然properties 通过编码转换也行。下面就是一个简单的yml格式配置例子

$title(application.yml)
spring:
  swagger:
    api-title: 某某APP接口文档
    api-version: v1.0
    contact:
      url: https://www.leftso.com
      email: example@leftso.com
      name: leftso.com
    url-pattern: /api/**

更多的配置请参考说明：Swagger Spring Boot Stater

编写一个测试用的controller

$title(DemoController.java)
package com.example.swagger;

import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
/**
 * @Description:  测试类
 * @Author: xq 
 * @Date: 2021/3/17 8:51
 **/
@RestController
@RequestMapping("/api/")
public class DemoController {

    @ApiOperation("get获取接口")
    @GetMapping("get")
    public String getData(String param){
        return "Ok";
    }

    @ApiOperation("post提交接口")
    @PostMapping("post")
    public Result postData(String name,String age){
        return Result.success(name);
    }
}

启动项目，并访问 http://localhost:8080/doc.html



离线导出word的重点来了，首先点开文档管理，就可以看到离线文档栏目


点击箭头指的地方，下载一个word文件，word文件的格式大概如下：

swagger2离线导出word swagger离线word

https://www.leftso.com/article/794.html