spring-boot 1.X集成swagger

1、引入POM依赖

<properties>
    <swagger-annotations.version>1.5.13</swagger-annotations.version>
    <springfox-swagger.version>2.7.0</springfox-swagger.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-annotations</artifactId>
            <version>${swagger-annotations.version}</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>${springfox-swagger.version}</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>${springfox-swagger.version}</version>
        </dependency>
    </dependencies>
</dependencyManagement>

2、装配swagger

 package com.tomato.boss.common.autoconfig;

 import java.time.LocalDateTime;
 import java.util.ArrayList;
 import java.util.List;

 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;

 import lombok.Getter;
 import lombok.Setter;
 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;

 @Configuration
 @EnableSwagger2
 @ConditionalOnProperty("swagger.conf.host")
 @ConfigurationProperties("swagger.conf")
 @Setter
 @Getter
 public class Swagger2AutoConfiguration {
     private String groupName;
     private String basePackage;
     private String title;
     private String host;
     private String desc;
     private String serviceUrl;
     private String version;

     @Bean
     public Docket createRestApi() {
         // 添加header头
         List<Parameter> pars = new ArrayList<Parameter>() {
             private static final long serialVersionUID = 1L;
             { add(new ParameterBuilder().name("gsid").description("全局会话ID(open服务不需要)").modelRef(new ModelRef("string")).parameterType("header").required(false).build()); }
         };  

         return new Docket(DocumentationType.SWAGGER_2)
                 .groupName(groupName)
                 .apiInfo(apiInfo())
                 .host(host)
                 .select()
                 .apis(RequestHandlerSelectors.basePackage(basePackage))
                 .paths(PathSelectors.any())
                 .build()
                 .globalOperationParameters(pars);
     }

     private ApiInfo apiInfo() {
         return new ApiInfoBuilder()
                 .title(title)
                 .description(desc)
                 .termsOfServiceUrl(serviceUrl)
                 .version(version + LocalDateTime.now())
                 .build();
     }
 }

3、properties配置

swagger.conf.desc=api地址：http://${swagger.conf.host}/
swagger.conf.service-url=http://${swagger.conf.host}/
swagger.conf.title=BOSS项目组${swagger.conf.group-name}接口

#注册中心列表直接跳转到swagger页面
eureka.instance.status-page-url=http://${swagger.conf.host}/swagger-ui.html

swagger.conf.host=bosstest.xx.com/api/sso
swagger.conf.group-name=boss-sso-rest
swagger.conf.base-package=com.tomato.boss.sso.rest
swagger.conf.version=1.0

当然，现在可以引入官方的start来自动注解

<dependency>
        <groupId>com.spring4all</groupId>
        <artifactId>swagger-spring-boot-starter</artifactId>
        <version>1.7.0.RELEASE</version>
</dependency>

当引入Zuul后可以在zuul层进行doc的集成，具体的实现方式可以参考：

https://my.oschina.net/didispace/blog/1818417