springboot整合swagger3.0

pom文件中导入依赖

	<dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>
	<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
        </dependency>

application.yml中写入配置

swagger:
  enable: true
  application-name: little-class-api
  application-version: 1.0
  application-description: 小班操作
  try-host: http://localhost:8080

读取这个配置

package com.example.internship.config;
 
import lombok.Getter;
import lombok.Setter;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
 
/**
 * @Classname: SwaggerProperties
 * @Description:
 * @Author: Stonffe
 * @Date: 2023/10/22 15:10
 */
@Component
@ConfigurationProperties("swagger")
@Getter
@Setter
public class SwaggerProperties {
    /**
     * 是否开启swagger，生产环境一般关闭，所以这里定义一个变量
     */
    private Boolean enable;
 
    /**
     * 项目应用名
     */
    private String applicationName;
 
    /**
     * 项目版本信息
     */
    private String applicationVersion;
 
    /**
     * 项目描述信息
     */
    private String applicationDescription;
 
    /**
     * 接口调试地址
     */
    private String tryHost;
}

配置swagger

package com.example.internship.config;
 
import org.springframework.boot.SpringBootVersion;
import org.springframework.context.annotation.Bean;
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.*;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
 
/**
 * @Classname: SwaggerConfiguration
 * @Description:
 * @Author: Stonffe
 * @Date: 2023/10/22 15:09
 */
@Configuration
@EnableOpenApi
public class SwaggerConfiguration {
    private final SwaggerProperties swaggerProperties;
 
    public SwaggerConfiguration(SwaggerProperties swaggerProperties) {
        this.swaggerProperties = swaggerProperties;
    }
 
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.OAS_30).pathMapping("/")
 
                // 定义是否开启swagger，false为关闭，可以通过变量控制
                .enable(swaggerProperties.getEnable())
 
                // 将api的元信息设置为包含在json ResourceListing响应中。
                .apiInfo(apiInfo())
 
                // 接口调试地址
                .host(swaggerProperties.getTryHost())
 
                // 选择哪些接口作为swagger的doc发布
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
 
    }
 
    /**
     * API 页面上半部分展示信息
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title(swaggerProperties.getApplicationName() + " Api Doc")
                .description(swaggerProperties.getApplicationDescription())
                .contact(new Contact("lighter", null, "2449121473@qq.com"))
                .version("Application Version: " + swaggerProperties.getApplicationVersion() + ", Spring Boot Version: " + SpringBootVersion.getVersion())
                .build();
    }
 
 
 
}

然后在浏览器中输入url：http://localhost:8080/swagger-ui/index.html#/

如何发现Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException这样的报错，可以在启动类上面加上@EnableWebMvc注解