初探Swagger

1.maven工程导入依赖
小提示：最好两个依赖的版本一致

        <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>

2.测试
将swagger集成到 spring容器中

package com.hui.swagger_demo.config;

import org.springframework.context.annotation.Configuration;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration//配置到配置中
@EnableSwagger2//开启Swagger2   EnableXXX开启。。。
public class SwaggerConfig {
}

浏览器输入测试：

3.进行配置
自定义
只能通过构造器来添加值，没有set方法

package com.hui.swagger_demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.VendorExtension;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;

import static springfox.documentation.service.ApiInfo.DEFAULT_CONTACT;

@Configuration//配置到配置中
@EnableSwagger2//开启Swagger2   EnableXXX开启。。。
public class SwaggerConfig {
    @Bean//配置了Swagger的Docket的bean实例
    public Docket docket(){
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo());
    }


    private ApiInfo apiInfo(){
        return  new ApiInfo(
                "辉辉的SwaggerAPI文档",
                "小灰灰",
                "1.0",
                "urn:tos",
                DEFAULT_CONTACT,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList<VendorExtension>());
    }
}

我们看修改完自定义信息后的界面
访问：http://localhost:8080/swagger-ui.html

4.