Spring Boot - Enabling Swagger2

Swagger2 是一个为RESTful web服务生成API在线文档的开源项目，它通过web浏览器，提供一个测试RESTful web service的用户界面。
为了在SpringBoot项目中使用到Swagger2,你需要添加下面的依赖：

<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-swagger2</artifactId>
   <version>2.7.0</version>
</dependency>
<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-swagger-ui</artifactId>
   <version>2.7.0</version>
</dependency>

然后在SpringBoot主程序类上添加@EnableSwagger2注解开启Swagger2支持。其次，创建一个Docket Bean来配置Swagger2。案例如下：

package com.restfulapio.demo;


@SpringBootApplication
@EnableSwagger2
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @Bean
    public Docket productApi() {
        return new Docket(DocumentationType.SWAGGER_2).select()
                .apis(RequestHandlerSelectors.basePackage("com.restfulapio.demo.controller")).build();
    }

}

测试

访问http://localhost:8080/swagger-ui.html