Swagger快速生成文档

Swagger

快速生成文档

导入配置

    io.springfox
    springfox-swagger2
    2.8.0


    io.springfox
    springfox-swagger-ui
    2.8.0

配置Application

@SpringBootApplication
@EnableSwagger2
public class DemoApplication {
    public static void main(String[] args){
        SpringApplication.run(DemoApplication.class);
    }
}

增加注释

@ApiModelProperty(value = "用户年龄起始值")
private int age;

@ApiOperation(value = "获取用户详情")
public User getInfo(@ApiParam(value = "用户ID") @PathVariable String id){
    ...
}

常用注释

1. @ApiIgnore：使用注解忽略该API，不会参与文档生成
2. @ApiOperation：描述该api,如： @ApiOperation(value=”创建用户”, notes=”根据User对象创建用户”)
3. 请求方法：@RequestMapping(value = “user”, method = RequestMethod.POST)
4. 参数x信息：@ApiImplicitParam(name = “user”, value = “用户详细实体user”, required = true, dataType = “User”)
5. @Api：修饰整个类，描述Controller的作用
6. @ApiParam：单个参数描述
7. @ApiModel：用对象来接收参数
8. @ApiResponses：HTTP响应整体描述
9. @ApiProperty：用对象接收参数时，描述对象的一个字段