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

配置Swagger==>Config

@Configuration
@EnableSwagger2     //开启swagger2
public class SwaggerConfig {
    
}

编写hello工程
测试运行：http://localhost:8080/swagger-ui.html

4、配置Swagger信息

@Configuration
@EnableSwagger2     //开启swagger2
public class SwaggerConfig {

    //配置Swagger的Docket的bean实例
    @Bean
    public Docket docket(){
        return new Docket(DocumentationType.SWAGGER_2)
            .apiInfo(apiInfo());
    }

    //配置Swagger信息：apiInfo
    private ApiInfo apiInfo(){
        //作者相关信息
        Contact contact = new Contact("天赐", "abcd...", "[email protected]");
        return new ApiInfo(
            "Swagger-Demo",
            "Swagger-test",
            "1.0",
            "urn:tos",
            contact,
            "Apache 2.0",
            "http://www.apache.org/licenses/LICENSE-2.0",
            new ArrayList());
    }
}

5、Swagger配置扫描接口

Docket.select()方法

@Bean
public Docket docket(){
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        .select()
        //RequestHandlerSelectors，配置扫描接口方式
        //basePackage:指定要扫描的包 一般是这个
        //any:扫描全部
        //none:不扫描
        //withClassAnnotation：扫描类上的注解，参数是一个注解的反射对象
        //RequestHandlerSelectors.withClassAnnotation(controller.class)
        //withMethodAnnotation：扫描方法上的注解
        //RequestHandlerSelectors.withMethodAnnotation(RequestMapping.class)
        .apis(RequestHandlerSelectors.basePackage("com.wen.swaggerdemo.controller"))
        //path():过滤xx路径
        //ant:过滤该路径下的
        //any:过滤所有
        //none:不过滤
        //regex:正则
        //.paths(PathSelectors.ant("/wen/**"))
        .build();//build前面select的方法：apis(扫描接口)、paths(过滤接口)
}

5.1、apis

apis中有RequestHandlerSelectors，点击进入看源码：

RequestHandlerSelectors，配置扫描接口方式
basePackage:指定要扫描的包一般是这个
any:扫描全部
none:不扫描
withClassAnnotation：扫描类上的注解，参数是一个注解的反射对象 RequestHandlerSelectors.withClassAnnotation(controller.class)
withMethodAnnotation：扫描方法上的注解 RequestHandlerSelectors.withMethodAnnotation(RequestMapping.class)

5.2、paths

paths中有PathSelectors，点击进入查看源码：

path():过滤xx路径
ant:过滤该路径下的
any:过滤所有
none:不过滤
regex:正则
例：.paths(PathSelectors.ant("/wen/**"))

6、配置是否启动Swagger

Docket.enable()方法

@Bean
public Docket docket(){
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        //enable:是否启用Swagger，如果为False，则Swagger不能再浏览器中访问
        .enable(false)
        .select()
        .apis(RequestHandlerSelectors.basePackage("com.wen.swaggerdemo.controller"))
        //.paths(PathSelectors.ant("/wen/**"))
        .build();//build前面的方法：apis、paths、build
}

点击查看源码可知：

传入布尔值：如果为False，则Swagger不能再浏览器中访问

6.1、enable应用

只想Swagger在生产环境中使用，但在发布时不使用

判断是不是生产环境 flag=false
注入enable(flag)

添加两个环境application-dev.properties(项目环境)、application-pro.properties(发布环境)

2.在两个环境中设置各自的端口号，然后在application.properties中激活dev环境

application.properties：
spring.profiles.active=dev

application-dev.properties：
server.port=8081

application-pro.properties：
server.port=8082：

3.因为是在enable中通过布尔值来判断是否是当前环境，所以在Docket中添加Environment，通过Environment的acceptsProfiles方法来实现。

//配置Swagger的Docket的bean实例
@Bean
public Docket docket(Environment environment){

    //获取项目的环境：dev
    //设置要显示的Swagger环境
    Profiles profiles = Profiles.of("dev");
    //通过environment.acceptsProfiles(profiles)判断是否处在设定的环境中
    boolean flag = environment.acceptsProfiles(profiles);

    ...

点击acceptsProfiles可以看到有两个方法，但第一个方法已过期了，所以用第二个方法，第二个方法内有一个Profiles参数，所以得创建一个Profiles，Profiles便是设置要显示的环境。

4.启动项目可以看到，当端口号为dev：8081时，可以进入Swagger界面，但是为pro：8082时却进不了。

7、配置Api文档的分组

通过Docket内的.groupName()方法来设置文档的名字

.groupName("小天")

7.1、配置多个分组

可以通过创建多个Docket实例来创建多个分组，这样就可以实现每个人负责各自的组

有助于协同开发。

@Bean
public Docket docket2(){
    return new Docket(DocumentationType.SWAGGER_2).groupName("小小");
}
@Bean
public Docket docket3(){
    return new Docket(DocumentationType.SWAGGER_2).groupName("小三");
}
@Bean
public Docket docket4(){
    return new Docket(DocumentationType.SWAGGER_2).groupName("老四");
}

7.2、实体类配置(Model)

@ApiModel("")：实体类注释
@ApiModelProperty("")：字段注释

@NoArgsConstructor
@AllArgsConstructor
@Data
@ApiModel("用户实体类")	//实体类注释
public class User {
    @ApiModelProperty("用户名")	//字段注释
    private String username;
    @ApiModelProperty("密码")
    private String password;
}

@ApiOperation("")：controller方法注释
@ApiParam("")：方法参数注释

//只要接口中，返回值中存在实体类，就会被扫描到swagger中
@PostMapping("/user")
public User user(){
    return new User();
}

@ApiOperation("hello2控制类")
@PostMapping("/hello2")
public String user2(@ApiParam("用户名") String username){
    return "hello"+username;
}

7.3、总结

可以通过swagger给一些比较难以理解的属性或接口增加注释信息
接口文档实时更新
可以在线测试

注意：在项目发行时要关闭swagger避免出现问题以及省内存。

Swagger简单应用

1、前后端分离

1.2、为什么要进行前后端分离

1.3、前后端分离存在的问题

2、Swagger

2.1、在项目中使用Swagger

3、SpringBoot集成Swagger