swagger注解文档

swagger 注解文档

1. @Api()

作用于类，放置于 controller 的一个类上，标志这个类是 swagger 资源

1.1 参数：

1.2 实例代码：

@Api(value = "swagger2测试api", tags = "管理员")
@RequestMapping("/api/admin")
public interface AdminFeign {
  
}

1.3 示例图：

2. @ApiOperation()

作用于方法之上，用户表示一个 http 的请求

2.1 参数

2.2 示例代码

@ApiOperation(value = "添加管理员", notes = "查询数据库中某个的学生信息")
@RequestMapping(value = "/", method = RequestMethod.POST)
Admin post(Admin admin);

2.3 示例图

3. @ApiParam()

作用于方法，用于参数字段的说明

3.1 参数

3.2 示例代码

@ApiOperation(value = "删除管理员", notes = "删除数据库中某个的学生信息")
@RequestMapping(value = "/{id}", method = RequestMethod.DELETE)
Admin delete(@ApiParam(name = "id", value = "管理员id", required = true)@PathVariable("id") String id);

3.3 示例图

4. @ApiModel()

作用于类，对类进行说明，用于实体类接收或者返回

4.1 参数

4.2 代码演示

@Data
@ApiModel("管理员")
public class Admin {
    /**
     * 管理员id
     */
    @ApiModelProperty(value = "管理员id")
    private String id;
    /**
     * 管理员姓名
     */
    @ApiModelProperty(value = "管理员姓名")
    private String name;
}

4.3 示例图

5. @ApiModelProperty()

作用于实体类，用于实体类中某个字段

5.1 参数

5.2 示例代码

@Data
@ApiModel("管理员")
public class Admin {
    /**
     * 管理员id
     */
    @ApiModelProperty(value = "管理员id", name = "id", required = true)
    private String id;
    /**
     * 管理员姓名
     */
    @ApiModelProperty(value = "管理员姓名", name = "name", required = true)
    private String name;
}

5.3 示例图

6. @ApiImplicitParams()

作用于方法之上，解释请求参数里边添加@ApiImplicitParam()注解

6.1 参数

6.2 示例代码

 @ApiOperation(value = "删除管理员", notes = "删除数据库中某个的学生信息")
 @ApiImplicitParams({
        @ApiImplicitParam(name = "id", value = "管理员ID", paramType = "path", required = true)
    })
 @RequestMapping(value = "/{id}", method = RequestMethod.DELETE)
 Admin delete(@PathVariable("id") String id);

6.3 示例图片