Swagger快速入门

1.导入Swagger maven依赖

springfox-swagger-ui依赖是swagger默认ui界面，

本地访问默认路径为swagger-ui.html

缺点：页面不美观且不是很好 

  <!--Swagger-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <!--Swagger-UI-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>

2.导入美化UI依赖

  <!--Swagger-Bootstrap-UI-->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>swagger-bootstrap-ui</artifactId>
            <version>1.9.6</version>
        </dependency>

3.配置swagger配置类

访问路径：

        端口号设置为自己服务的

        美化ui：

http://localhost:8081/doc.htmlhttp://localhost:8081/doc.html       默认ui：

        http://localhost:8081/swagger-ui.htmlhttp://localhost:8081/swagger-ui.html

@Configuration
@EnableSwagger2//启动swagger
@EnableSwaggerBootstrapUI //启动美化ui
public class Swagger2Config extends WebMvcConfigurationSupport {

  @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");
        // 解决 doc.html 404 报错
        registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
    }


    @Bean
    public Docket docket(){
        return new Docket(DocumentationType.SWAGGER_2).
                apiInfo(new ApiInfoBuilder().
                        title("微信支付案例接口文档")
                                .description("接口文档")
                                .version("2.0.0")
                                .build()).groupName("all")
                .select().apis(RequestHandlerSelectors.basePackage("com.example.paymentdemo.controller")).paths(PathSelectors.any()).build();
    }