springboot集成Swagger2

目录

第一步： 添加所需依赖

第二步：创建Swagger2配置类

---

第一步： 添加所需依赖

    <!-- swagger2 依赖 -->
    <dependency>
       <groupId>io.springfox</groupId>
       <artifactId>springfox-swagger2</artifactId>
       <version>2.9.2</version>
    </dependency>
    <!-- 1.swagger第三方ui依赖 -->
    <dependency>
       <groupId>io.springfox</groupId>
       <artifactId>springfox-swagger-ui</artifactId>
       <version>2.9.2</version>
    </dependency>
http://localhost:端口/swagger-ui.html
-------------------------------------------------------------------	   
<!-- 2.Swagger第三方ui依赖 -->
    <dependency>
      <groupId>com.github.xiaoymin</groupId>
      <artifactId>swagger-bootstrap-ui</artifactId>
       <version>1.9.6</version>
    </dependency>
http://localhost:端口/doc.html

第二步：创建Swagger2配置类

使用@EnableSwagger2开启Swagger2

@Configuration   // 作为配置类
@EnableSwagger2  // 开启Swagger2
public class Swagger2Config {
    /**
     *  配置swagger2的bean实例
     * @return
     */
    @Bean
    public Docket createRestApi(){
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())                          // 添加swagger信息 = apiInfo信息

                .select()                                    // 通过.select()方法，去配置扫描接口,RequestHandlerSelectors配置如何扫描接口
                .apis(RequestHandlerSelectors.basePackage("com.xxx.server.controller"))
                .paths(PathSelectors.any())                  // 配置如何通过path过滤,即这里只扫描任何
                .build();

    }

    /**
     *  配置swagger信息 = apiInfo
     * @return
     */
    private ApiInfo apiInfo(){
        return new ApiInfoBuilder()
                .title("接口文档")
                .description("接口文档简单描述")
                .contact(new Contact("小明","http:localhost:8081/doc.html","xxxx@xxxx.com"))
                .version("1.0")
                .build();
    }
}