使用基于swagger的knife4j自动生成接口文档

添加swagger依赖springfox，添加knife4j依赖

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
</dependency>
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>3.0.2</version>
</dependency>
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-spring-boot-starter</artifactId>
    <version>4.0.0</version>
</dependency>

接口代码，文档空格使用全角格式的空格

import javax.validation.Valid;
import java.util.List;
import java.util.Set;

import com.google.common.collect.Sets;
import io.swagger.annotations.ApiOperation;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

@Tag(name = "xx接口", description = "xxxxxController")
@RestController
@RequestMapping("/xx")
public class xxxxxController {
    @ApiOperation(tags = "xx接口", value = "xx",
            notes = "功能：xxxxx。  \n" +
                    "业务逻辑：  \n" +
                    "　xxxxx”。  \n" +
                    "备注：  \n" +
                    "　xxxxxx")
    @PostMapping(value = "/xxx/xx")
    public ResponseEntity<XXResponse> xxx(@RequestBody @Valid XXRequest xxRequest) {
        return ResponseEntity.status(HttpStatus.CREATED)
                .body(xxService.xxx(xxRequest));
    }
}

使用knief访问
在接口代码中有接口描述，可以借助基于swagger的knife4j自动生成接口文档说明。

http://localhost:8080/xxx/doc.html#/home

支持MarkDown、html、word、openApi 4种格式的接口文档

也支持原有的swagger访问

http://localhost:8080/xxxx/swagger-ui/#/