SpringBoot集成Swagger

1引依賴:

        <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>


        <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>

2.配置SwaggerBeen

package com.unicom.idpf.webapp.configuration;


import com.google.common.base.Function;
import com.google.common.base.Optional;
import com.google.common.base.Predicate;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.RequestHandler;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
/**
 * @ClassName SwaggerConfig
 * @Author LiC
 * @Description //TODO
 * @Date 2019/11/25 18:08
 **/
@Configuration
@EnableSwagger2
public class SwaggerConfig {
  // 定義分隔符
  private static final String splitor = ";";

  @Bean
  public Docket customDocket() {
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        .select()
        //.apis(RequestHandlerSelectors.any())//掃描的包路徑
        .apis(basePackage("com.unicom.idpf.webapp.module.place.cjrinfo" + splitor + "com.unicom.idpf.webapp.module.dingtalk"))
        .paths(PathSelectors.any())
        .build();
  }

  private ApiInfo apiInfo() {
    return new ApiInfoBuilder()
        .title("智慧殘聯項目 RESTful APIs")
        .description("智慧殘聯項目api接口文檔")
        .version("1.0")
        .build();
  }

  /**
   * 重寫basePackage方法,使能夠實現多包訪問
   * @author  jinhaoxun
   * @date 2019/1/26
   * @param
   */
  public static Predicate<RequestHandler> basePackage(final String basePackage) {
    return input -> declaringClass(input).transform(handlerPackage(basePackage)).or(true);
  }

  private static Function<Class<?>, Boolean> handlerPackage(final String basePackage)     {
    return input -> {
      // 循環判斷匹配
      for (String strPackage : basePackage.split(splitor)) {
        boolean isMatch = input.getPackage().getName().startsWith(strPackage);
        if (isMatch) {
          return true;
        }
      }
      return false;
    };
  }

  private static Optional<? extends Class<?>> declaringClass(RequestHandler input) {
    return Optional.fromNullable(input.declaringClass());
  }

}

3.訪問路徑

boot工程格式如下

http://127.0.0.1:9090/swagger-ui.html

非boot工程加個自己項目名

http://127.0.0.1:9090/xxx/swagger-ui.html

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章