springboot之swagger2

1.pom.xml添加以下代码

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

2.创建swagger配置类

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
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;
/**
 * swagger自定义配置
 *
 * @ClassName: Swagger2
 * @author Lhc
 * @date 2019年4月9日
 */
@Configuration
@EnableSwagger2
public class Swagger2
{
    @Value("${swagger.show}")
    private boolean swaggerShow;

    @Bean
    public Docket createRestApi()
    {
        return new Docket(DocumentationType.SWAGGER_2)
                .enable(swaggerShow)
                .apiInfo(apiInfo())
                .select()
//                .apis(RequestHandlerSelectors.basePackage("com.module.controller")) //swagger扫描指定包下面的接口
                .paths(PathSelectors.any()).build();
    }

    private ApiInfo apiInfo()
    {
        return new ApiInfoBuilder()
                .title("Spring Boot中使用Swagger2构建RESTful APIs")
                .description("此API提供接口调用")
                .contact("lhc")
                .version("1.0").build();
    }
}

3.application.yaml或application.properties添加以下代码

swagger:
  show: true

注：上线之前将true改为false，则swagger不能被访问

4.启动项目，访问http://localhost:8010/项目名称/swagger-ui.html即可。