Knife4j或Swagger在生产环境中根据配置文件禁用的方法

2021-11-08 4172点热度 0人点赞 0条评论

自动生成API文档,https://gitee.com/xiaoym/knife4j 这个还是挺好用的,需求希望在开发环境下启用API文档,而生产环境下则关闭API文档,我们可以在Knife4j的配置代码中,加入@ConditionalOnProperty来根据当前的环境判断是否使用Knife4j。

Knife4jConfig 生产环境禁用 @ConditionalOnProperty(name = "my.product-env", havingValue = "false")

意思是查看application.properties或者application.yml中,my.product-env如果是false的(不是生产环境)才开启Knife4j,如果你是原生Swagger,也是同样配置的地方,加上这个Annotation就可以了。

import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
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.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebFlux;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;
/**
* 2021/11/08 08:04
* @since: knife4j-spring-boot2-demo 1.0
* see https://gitee.com/xiaoym/knife4j
*/
@EnableKnife4j
@EnableSwagger2WebMvc
@EnableSwagger2WebFlux
@Configuration
@ConditionalOnProperty(name = "my.product-env", havingValue = "false")
public class Knife4jConfig {
@Bean(value = "defaultApi2")
public Docket defaultApi2() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
//分组名称
// .groupName("测试分组")
.select()
//这里指定Controller扫描包路径
.apis(RequestHandlerSelectors.basePackage("com.terrynow.test.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("Info APIs")
.description("Info APIs")
// .termsOfServiceUrl("http://www.group.com/")
.contact("test@terrynow.com")
.version("1.0")
.build();
}
}
import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; 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.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import springfox.documentation.swagger2.annotations.EnableSwagger2WebFlux; import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc; /** * 2021/11/08 08:04 * @since: knife4j-spring-boot2-demo 1.0 * see https://gitee.com/xiaoym/knife4j */ @EnableKnife4j @EnableSwagger2WebMvc @EnableSwagger2WebFlux @Configuration @ConditionalOnProperty(name = "my.product-env", havingValue = "false") public class Knife4jConfig { @Bean(value = "defaultApi2") public Docket defaultApi2() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) //分组名称 // .groupName("测试分组") .select() //这里指定Controller扫描包路径 .apis(RequestHandlerSelectors.basePackage("com.terrynow.test.controller")) .paths(PathSelectors.any()) .build(); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("Info APIs") .description("Info APIs") // .termsOfServiceUrl("http://www.group.com/") .contact("test@terrynow.com") .version("1.0") .build(); } }
import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
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.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebFlux;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;

/**
 * 2021/11/08 08:04
 * @since: knife4j-spring-boot2-demo 1.0
 * see https://gitee.com/xiaoym/knife4j
 */
@EnableKnife4j
@EnableSwagger2WebMvc
@EnableSwagger2WebFlux
@Configuration
@ConditionalOnProperty(name = "my.product-env", havingValue = "false")
public class Knife4jConfig {

    @Bean(value = "defaultApi2")
    public Docket defaultApi2() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                //分组名称
//                .groupName("测试分组")
                .select()
                //这里指定Controller扫描包路径
                .apis(RequestHandlerSelectors.basePackage("com.terrynow.test.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Info APIs")
                .description("Info APIs")
//                .termsOfServiceUrl("http://www.group.com/")
                .contact("test@terrynow.com")
                .version("1.0")
                .build();
    }
}

 

admin

这个人很懒,什么都没留下

文章评论

您需要 登录 之后才可以评论