springboot简单整合swagger2

1.导入依赖

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

2.写配置类

package com.sky.config;

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.ParameterBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Parameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;
import java.util.List;

@Configuration
@EnableSwagger2
public class Swagger {

    private String title = "项目标题";

    private String description = "项目标题-描述";

    private String version = "项目版本";

    private String basePackage = "com.sky.controller";//这里需要填写swagger管理的接口 不然在网页上会报错 参数错误

    //控制swagger是否启动开发模式 测试模式 生产模式
    @Value("${swagger2.enable}")
    private boolean enable;

    //指定是否需要给所有接口添加头部信息
    private boolean header = false;

    @Bean
    public Docket createRestApi() {
        List<Parameter> pars = header == true ? addParameters() : null;
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage(basePackage))
                .paths(PathSelectors.any())
                .build()
                .globalOperationParameters(pars)
                .enable(enable);
    }

    /**
     * 为swagger接口的时候添加头部信息
     * 如何有多个头部信息 可以add()直接添加到pars就可以了
     *
     * @return