@Schema和@ApiModel等注解的联系

这篇具有很好参考价值的文章主要介绍了@Schema和@ApiModel等注解的联系。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

我在看公司之前的文档,发现了@schema注解,不太了解,所以查询了一些资料,把我的见解记录下:

@Schema和@ApiModel等注解的联系

开始的时候,没查到太多信息,后来查到了,原来就是用过的@APImodel注解,一个是swagger2常用的注解,一个是swagger3常用的注解。

swagger2常用的5个注解:

最常用的5个注解
@Api:修饰整个类,描述Controller的作用
@ApiOperation:描述一个类的一个方法,或者说一个接口
@ApiParam:单个参数描述
 
@ApiModel:用对象来接收参数
@ApiProperty:用对象接收参数时,描述对象的一个字段
 
 
其它若干
@ApiResponse:HTTP响应其中1个描述
 
@ApiResponses:HTTP响应整体描述
 
@ApiClass
 
@ApiError
 
@ApiErrors
 
@ApiParamImplicit
 
@ApiParamsImplicit

用 swagger 3 注释替换 swagger 2 注释

(它已经包含在springdoc-openapi-ui依赖项中)。swagger 3 注释的包是io.swagger.v3.oas.annotations

依赖项:

swagger3只需要一个依赖即可

<!-- https://mvnrepository.com/artifact/io.springfox/springfox-boot-starter -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

swagger2到swagger3的变化规则:

@Api → @Tag
 
@ApiIgnore→@Parameter(hidden = true)或@Operation(hidden = true)或@Hidden
 
@ApiImplicitParam → @Parameter
 
@ApiImplicitParams → @Parameters
 
@ApiModel → @Schema
 
@ApiModelProperty(hidden = true) → @Schema(accessMode = READ_ONLY)
 
@ApiModelProperty → @Schema
 
@ApiOperation(value = "foo", notes = "bar") → @Operation(summary = "foo", description = "bar")
 
@ApiParam → @Parameter
 
@ApiResponse(code = 404, message = "foo") → @ApiResponse(responseCode = "404", description = "foo")

之后我问了GPT4:

 @Schema和@ApiModel等注解的联系

 今天又学到一个新注解@schema,加油

 文章来源地址https://www.toymoban.com/news/detail-471075.html

到了这里,关于@Schema和@ApiModel等注解的联系的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • SpringBoot 使用【AOP 切面+注解】实现在请求调用 Controller 方法前修改请求参数和在结果返回之前修改返回结果

    在项目中需要实现 在请求调用 Controller 方法前修改请求参数和在结果返回之前修改返回结果 。 我们可以使用 AOP 切面+注解的形式实现。这样我们就可以在不修改原始代码的情况下,通过切面类在方法调用前后插入额外的逻辑。 自定义注解 @PreProcess 自定义注解 @PreProcess 用于

    2024年03月20日
    浏览(44)
  • 机电公司管理小程序|基于微信小程序的机电公司管理小程序设计与实现(源码+数据库+文档)

    机电公司管理小程序目录 目录 基于微信小程序的机电公司管理小程序设计与实现 一、前言 二、系统设计 三、系统功能设计  1、机电设备管理 2、机电零件管理 3、公告管理 4、公告类型管理 四、数据库设计    五、核心代码   六、论文参考 七、最新计算机毕设选题推荐

    2024年03月19日
    浏览(47)
  • 基于Java供电公司安全生产考试系统设计实现(源码+lw+部署文档+讲解等)

    博主介绍 : ✌ 全网粉丝30W+,csdn特邀作者、博客专家、CSDN新星计划导师、Java领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java技术领域和毕业项目实战 ✌ 🍅 文末获取源码联系 🍅 👇🏻 精彩专栏 推荐订阅 👇🏻 不然下次找不到哟 2022-2024年

    2024年02月04日
    浏览(46)
  • 基于Java的钢铁集团公司安全管理系统的设计与实现(源码+lw+部署文档+讲解等)

    💗 博主介绍 :✌全网粉丝10W+,CSDN特邀作者、博客专家、CSDN新星计划导师、全栈领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战✌💗 👇🏻 精彩专栏 推荐订阅 👇🏻 2023-2024年最值得选的微信小程序毕业设

    2024年02月21日
    浏览(39)
  • 大数据|海豚调度官方文档注解(3)

    官方文档地址:https://dolphinscheduler.apache.org/zh-cn/docs/3.1.8 因为官方文档经常出现文档桑、图片加载缓慢、中文名对应关系较差,且存在部分链接异常的情况,所以我将其重新整理、排版以方便阅读。 同时做了部分优化,增加了一些注解,补充了中英文对应关系。 DolphinSchedul

    2024年02月04日
    浏览(57)
  • 关于Spark基本问题及结构[月薪2w的人都在看]

    目录   1.Spark是什么? 2.Spark与Hadoop  Spark与MapReduce对比 Spark与Hadoop 优点                          3. 什么是结构化数据? 什么是非结构化数据? 什么是结构化数据? 什么是非结构化数据? 4.Spark 架构作业执行原理 了解Spark架构 客户端 Driver  SparkContext  Cluster Manager SparkWorker

    2024年03月14日
    浏览(54)
  • Python 文档注解|strftime 和 strptime(时间格式字符串)

    Python 3 官方文档地址:https://docs.python.org/zh-cn/3/library/datetime.html#strftime-and-strptime-behavior 文档目录层级: datetime —— 基本日期和时间类型 strftime() 和 strptime() 的行为 本文在 Python 3 官方文档的基础上,增加注解(会用全角方括号标出)以补全含义和修正机翻的错误,并补充实

    2024年02月03日
    浏览(38)
  • 百万粉丝都在看的Python上手教程----滚雪球学Python

    前言: Hello大家好,我是Dream。 今天为大家带来一本书: 《滚雪球学Python》 一起来看看吧~ 《滚雪球学Python》之所以这样命名本书,是希望大家用滚雪球的思维学习编程语言,“滚”的第一遍,从全局掌握Python技术体系,“滚”的第二遍继续为自己的技术栈沾上更多的雪花,

    2024年01月24日
    浏览(46)
  • Spring AOP官方文档学习笔记(二)之基于注解的Spring AOP

    1.@Aspect注解 (1) @Aspect注解用于声明一个切面类,我们可在该类中来自定义切面,早在Spring之前,AspectJ框架中就已经存在了这么一个注解,而Spring为了提供统一的注解风格,因此采用了和AspectJ框架相同的注解方式,这便是@Aspect注解的由来,换句话说,在Spring想做AOP框架之前,

    2023年04月17日
    浏览(42)
  • 【Python】重磅!这本30w人都在看的Python数据分析畅销书更新了!

    Python 语言极具吸引力。自从 1991 年诞生以来,Python 如今已经成为最受欢迎的解释型编程语言。 【文末送书】今天推荐一本Python领域优质数据分析书籍,这本30w人都在看的书,值得入手。 pandas 诞生于2008年。它是由韦斯·迈金尼(Wes McKinney)于2008年开始开发的,最初的目标是

    2024年02月05日
    浏览(47)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包