Swagger2 demo

为了减少程序员撰写文档，提高生产力，swagger2应运而生，使用swagger2可以减少便携过多的文档，只需要通过代码就能生成api文档，非常方便。（代码取自慕课网：java架构师课程）

步骤

1. 引入依赖

<!-- swagger2 配置 -->
<dependency>
		<groupId>io.springfox</groupId>
		<artifactId>springfox-swagger2</artifactId>
		<version>2.4.0</version>
</dependency>
<dependency>
		<groupId>io.springfox</groupId>
		<artifactId>springfox-swagger-ui</artifactId>
		<version>2.4.0</version>
</dependency>
<dependency>
		<groupId>com.github.xiaoymin</groupId>
		<artifactId>swagger-bootstrap-ui</artifactId>
		<version>1.6</version>
</dependency>

2. 文档标题和简介编写
   创建配置类Swagger2

@Configuration
@EnableSwagger2
public class Swagger2 {
    // http://localhost:8088/swagger-ui.html  原路径
    // 配置swagger2核心配置
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2) // 指定api类型为swagger2
                .apiInfo(apiInfo()) // 用于定义api文档汇总信息
                .select()
                .apis(RequestHandlerSelectors.basePackage("work.jimmmy.foodie.controller")) // 指定controller的包
                .paths(PathSelectors.any()) // 所有controller
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("天天吃货 电商平台api") // 文档页标题
                .contact(new Contact("imooc",
                        "https://www.imooc.com",
                        "abc@imooc.com"))
                .description("转为天天吃货提供的api文档")
                .version("1.0.1")
                .termsOfServiceUrl("https://www.imooc.com")
                .build();
    }
}

3. 常用注解

@ApiIgonre 
// 当前类的所有方法，不在文档中显示

@Api  // 用于修饰controller对象
// 例：  - value: 值		- tags：显示的tab名
@Api(value = "注册登录", tags = {"用于注册登录的相关接口"})

@ApiOperation  // 用于controller对象中的方法
// 例： value - 接口名称   notes - 接口说明
@ApiOperation(value = "用户名是否存在", notes = "用户名是否存在", httpMethod = "GET")

@ApiParam // 用于controller对象的方法中的参数
// 例：name - 参数名（parameter）  value - 描述
@RequestBody @ApiParam(name = "userBo", value = "用户模型", required = true) UserBo userBo

@ApiModel // 用于修饰模型类
// 例： - value 对象类型
@ApiModel(value = "用户对象BO", description = "从客户端，由对象传如的数据封装在此entity中")

@ApiModelProperty
// 例：- value 说明， - name 参数名称  - example 调试中的默认值
@ApiModelProperty(value = "用户名", name = "username", example = "imooc", required = true)