【汇智学堂】swagger-UI使用测试

now,Let us begin.

1、download from GitHub
https://github.com/swagger-api/swagger-ui.git

2、

3、add dependency

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

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

4、

SwaggerConfiguration:

package com.huizhi.userservice.config;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.ResponseEntity;
import org.springframework.util.StopWatch;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import javax.swing.*;
import java.util.Date;

import static springfox.documentation.builders.PathSelectors.regex;

@Configuration
@EnableSwagger2
public class SwaggerConfiguration {
    //定义API接口映射路径
    public static final String DEFAULT_INCLUDE_PATTERN="/user/.*";
    private final Logger log=
          LoggerFactory.getLogger(SwaggerConfiguration.class) ;
    @Bean
    public Docket swaggerSpringfoxDocket(){
        log.debug("Starting Swagger");
        StopWatch watch=new StopWatch();
        watch.start();
        //用于生成对应API接口文档的描述信息，可省略
        ApiInfo apiInfo=new ApiInfo("用户管理API接口测试文档","description",
                "termsOfServiceUrl","contact","version","","");

        Docket docket=new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo)
                .genericModelSubstitutes(ResponseEntity.class)
                .forCodeGeneration(true)
                .genericModelSubstitutes(ResponseEntity.class)
                .directModelSubstitute(java.time.LocalDate.class, Spring.class)
                .directModelSubstitute(java.time.ZonedDateTime.class, Date.class)
                .directModelSubstitute(java.time.LocalDateTime.class, Date.class)
                .select()
                .paths(regex(DEFAULT_INCLUDE_PATTERN))
                .build();

          watch.stop();
          log.debug("Started Swagger in{} ms",watch.getTotalTimeMillis());
          return docket;
    }
}