Skip to main content

Swagger

Swagger官网

  • API框架,RsetFul Api文档在线自动生成工具=>API文档与API定义同步更新。
  • 直接运行,可以在线测试API接口

在项目使用Swagger需要springbox:

  • swagger2

  • ui

注解说明
@Api(tags="xxx模块说明")作用在模块类上
@ApiParam("xxx参数说明")作用在参数、方法、和字段上,required为true表示必须传参数
@ApiModel("xxxPOJO说明")作用在模型类上
@ApiOperation("xxx接口说明")作用在接口方法上
@ApiModelProperty(value="xxx属性说明",hidden=true)作用在类方法和属性上,hidden为true可以隐藏该属性,required为true表示添加或修改数据时必须填参数