package com.doumee.config.swagger; import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j; import com.google.common.base.Function; import com.google.common.base.Optional; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.web.util.UriComponentsBuilder; import springfox.documentation.PathProvider; import springfox.documentation.RequestHandler; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.ParameterBuilder; import springfox.documentation.service.Parameter; import springfox.documentation.builders.PathSelectors; import springfox.documentation.oas.annotations.EnableOpenApi; import springfox.documentation.schema.ModelRef; import springfox.documentation.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.paths.DefaultPathProvider; import springfox.documentation.spring.web.paths.Paths; import springfox.documentation.spring.web.plugins.Docket; import java.util.ArrayList; import java.util.List; import java.util.function.Predicate; import static springfox.documentation.spring.web.paths.Paths.removeAdjacentForwardSlashes; /** * Swagger配置 * @author Eva.Caesar Liu * @date 2022/03/11 10:24 */ @Configuration @EnableOpenApi @EnableKnife4j public class SwaggerConfig { @Value("${swagger.host}") private String host; @Value("${swagger.context-path}") private String contextPath; @Value("${swagger.title:接口文档}") private String title; @Value("${swagger.description}") private String description; @Value("${project.version}") private String version; @Bean public ApiInfo getApiInfo() { return new ApiInfoBuilder() .title(title) .description(description) .version(version) .build(); } @Bean public Docket getDocket3() { Docket docket = new Docket(DocumentationType.SWAGGER_2) .apiInfo(this.getApiInfo()).groupName("【安泰访客系统交互接口openapi】") .host(host) .select() .apis( basePackage("com.doumee.api.web")) // 设置需要被扫描的类,这里设置为添加了@Api注解的类 // .apis(RequestHandlerSelectors.withClassAnnotation(Api.class)) .paths(PathSelectors.any()) .build() .globalOperationParameters(this.getParameterList()); docket.pathProvider(new DefaultPathProvider(){ @Override public String getOperationPath(String operationPath) { return contextPath+super.getOperationPath(operationPath); } }) ; return docket; } private List getParameterList() { ParameterBuilder tokenPar = new ParameterBuilder(); List pars = new ArrayList<>(); tokenPar.name("token").description("令牌").modelRef(new ModelRef("string")).defaultValue("设置token默认值").modelRef(new ModelRef("string")).parameterType("header").required(false).build(); pars.add(tokenPar.build()); return pars; } /* @Bean public Docket getDocket1() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(this.getApiInfo()).groupName("【公共接口API】") .host(host) .select() .apis( basePackage("com.doumee.api.common")) // 设置需要被扫描的类,这里设置为添加了@Api注解的类 // .apis(RequestHandlerSelectors.withClassAnnotation(Api.class)) .paths(PathSelectors.any()) .build(); }*/ /** * 重写basePackage方法,使能够实现多包访问,复制贴上去 * @author teavamc * @date 2019/1/26 * @return com.google.common.base.Predicate */ public static Predicate basePackage(String basePackage) { return input -> declaringClass(input).transform(handlerPackage(basePackage)).or(true); } private static Function, Boolean> handlerPackage(String basePackage) { return input -> { // 循环判断匹配 for (String strPackage : basePackage.split(";")) { boolean isMatch = input.getPackage().getName().startsWith(strPackage); if (isMatch) { return true; } } return false; }; } private static Optional> declaringClass(RequestHandler input) { return Optional.fromNullable(input.declaringClass()); } }