（ 九 ）使用swagger自动生成html接口文档

步骤一：引入 swagger 依赖

        <!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
        </dependency>
        <!-- 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>

步骤二：在需要生成文档的接口上使用注解

@EnableSwagger2

接下来就可以访问默认的接口文档了，只不过都是英文的，字段没有说明

访问地址：http://ip:port/swagger-ui.html

修改默认显示：

controller接口方法上使用：

@ApiOperation(value = "查询单个用户服务")

controller接口方法参数上使用：

@ApiParam(value = "用户id")

实体类字段说明使用：

@ApiModelProperty(value = "用户id")

接下来再次访问就可以显示想要的效果了：

字段添加了说明

接口方法参数添加说明

接口服务添加了说明