Spring Boot 使用 Swagger3 生成 API 接口文档

import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.ApiInfoBuilder;

import springfox.documentation.builders.PathSelectors;

import springfox.documentation.builders.RequestHandlerSelectors;

import springfox.documentation.oas.annotations.EnableOpenApi;

import springfox.documentation.service.ApiInfo;

import springfox.documentation.service.Contact;

import springfox.documentation.spi.DocumentationType;

import springfox.documentation.spring.web.plugins.Docket;

import java.util.ArrayList;

/**

• Created with IntelliJ IDEA.

• @author : 村雨遥

• @version : 1.0

• @project : springboot-swagger3-demo

• @package : com.cunyu.springbootswagger3demo.config

• @className : SwaggerConfig

• @createTime : 2022/1/6 14:19

• @email : 747731461@qq.com

• @微信 : cunyu1024

• @公众号 : 村雨遥

• @网站 : https://cunyu1943.github.io

• @description :

*/

@Configuration

@EnableOpenApi

public class SwaggerConfig {

/**

• 用于读取配置文件 application.properties 中 swagger 属性是否开启

*/

@Value(“${swagger.enabled}”)

Boolean swaggerEnabled;

@Bean

public Docket docket() {

return new Docket(DocumentationType.OAS_30)

.apiInfo(apiInfo())

// 是否开启swagger

.enable(swaggerEnabled)

.select()

// 过滤条件，扫描指定路径下的文件

.apis(RequestHandlerSelectors.basePackage(“com.cunyu.springbootswagger3demo.controller”))

// 指定路径处理，PathSelectors.any()代表不过滤任何路径

//.paths(PathSelectors.any())

.build();

}

private ApiInfo apiInfo() {

/作者信息/

Contact contact = new Contact(“村雨遥”, “https://cunyu1943.github.io”, “747731461@qq.com”);

return new ApiInfo(

“Spring Boot 集成 Swagger3 测试”,

“Spring Boot 集成 Swagger3 测试接口文档”,

“v1.0”,

“https://cunyu1943.github.io”,

contact,

“Apache 2.0”,

“http