API 文档构建工具 - Swagger2简单应用

return new ApiInfoBuilder()

.title( “用户管理接口API文档” )

.version( “1.0” )

.build();

}

}

@Api 作用到类上面 说明类的作用

@Api(tags=“APP用户注册Controller”)

@ApiModel

用于响应类上，表示一个返回响应数据的信息

（这种一般用在post创建的时候，使用@RequestBody这样的场景，

请求参数无法使用@ApiImplicitParam注解进行描述的时候）

@ApiModelProperty：用在属性上，描述响应类的属性

@ApiOperation

@ApiOperation：“用在请求的方法上，说明方法的作用”

value=“说明方法的作用”

notes="方法的备注说明

@ApiOperation(value=“用户注册”,notes=“手机号、密码都是必填项，年龄是选填项，但必须是数字”)

@ApiImplicitParams：用在请求的方法上，包含一组参数说明

@ApiImplicitParam：用在 @ApiImplicitParams 注解中，指定一个请求参数的配置信息

name：参数名

value：参数的汉字说明、解释

required：参数是否必须传

paramTypeÿ