Springboot整合swagger

一、前提

已经搭建好springboot环境，并正确运行！！！
搭建Springboot框架：王林博客_Springboot框架搭建

二、导入依赖

<!-- swagger文档-->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>3.0.2</version>
        </dependency>

三、配置application.yml 文件

# swagger
swagger:
  enabled:
  application-name: ${spring.application.name}
  application-version: 1.0
  application-description: 项目接口文档
  try-host: http://localhost:${server.port}
# 日志
logging:
  file:
    path: ./logs/frame/

四、新建配置类Swagger2Config

@Configuration
@EnableOpenApi
@EnableSwagger2
@EnableKnife4j
@Import(BeanValidatorPluginsConfiguration.class)
{"enable"},havingValue = "true")
public class Swagger2Config {
    @Bean(value = "defaultApi2")
    public Docket defaultApi2(Environment environment) {
        String groupName = "2.X版本";

        //设置要显示的swagger环境:只在生产环境中使用，在发布环境中不适用！
        Profiles profiles = Profiles.of("dev", "test");

        //通过environment.acceptsProfiles判断是否启动处于设定的环境中
        boolean flag = environment.acceptsProfiles(profiles);

        Docket docket = new Docket(DocumentationType.OAS_30)
                .useDefaultResponseMessages(false)
                .apiInfo(apiInfo())
                .select()
.apis(RequestHandlerSelectors.basePackage("cqie.cn.frame.controller"))
                .paths(PathSelectors.any())
                .build()
                .enable(flag);
        return docket;
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("项目文档Api")
                .description("swagger2 API 文档")
                .termsOfServiceUrl("")
                .contact(new Contact("王林", "/doc.html", "2741933961@qq.com"))
                .version("1.0")
                .build();
    }
}