swagger注解文档

  |   0 评论   |   1,870 浏览

swagger 注解文档

1. @Api()

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

1.1 参数:

参数名称参数介绍备注
value说明,可以使用 tags 替代
tags说明

1.2 实例代码:

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

1.3 示例图:

1553583146586png

2. @ApiOperation()

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

2.1 参数

参数名称参数介绍备注
value方法描述
notes方法描述详情
tags标签,可继承类的标签可不填
response返回类型class,可不填
httpMethod请求方法get,post 等,可不填

2.2 示例代码

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

2.3 示例图

1553583880132png

3. @ApiParam()

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

3.1 参数

参数名称参数介绍备注
name参数名称
value参数解释
required是否必需

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 示例图

1553585860846png

4. @ApiModel()

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

4.1 参数

参数名称参数介绍备注
value对象名
description对象描述

4.2 代码演示

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

4.3 示例图

1553586300807png

5. @ApiModelProperty()

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

5.1 参数

参数名称参数解释备注
value参数解释
name参数名称
dataType属性类型
required是否必填
example示例
hidden隐藏

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 示例图

1553586705956png

6. @ApiImplicitParams()

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

6.1 参数

参数名称参数解释备注
name参数名称
value参数解释
paramType参数类型
required是否必需

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 示例图片

1553587765884png


标题:swagger注解文档
作者:boolean-dev
地址:https://blog.booleandev.xyz/articles/2019/03/26/1553603104264.html
本站使用「CC BY 4.0」 创作共享协议,转载请在文章明显位置注明作者及出处。

评论

发表评论