融资项目——swagger2的注解

发布时间：2023年12月23日

1. @ApiModel与@ApiModelProperty(在实体类中使用)

如上图，@ApiModel加在实体类上方，用于整体描述实体类。@ApiModelProperty(value="xxx",example="xxx")放于每个属性上方，用于对属性进行描述。swagger2网页上的效果如下图：

2.@Api、@ApiOperation、@ApiParam(在Controller中使用)

@Api使用方式如上图。其用于描述相应的Controller。效果如下：

@ApiOperation(value="xxx",notes="xxx")使用方式如上图，notes是对于value更详细的说明，其用于描述相关的接口。效果如下：

@ApiParam使用方法如上图，value用于对参数进行描述，example给出测试默认值，required用于指出参数是否为必须接收的参数。其效果如下图所示：

文章来源:https://blog.csdn.net/qq_45007794/article/details/135174269
本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
最新文章