Swagger注解-@ApiParam

Swagger注解-@ApiParam使用场景在 Rest 接口上或 Rest 接口参数前边使用概述为 Rest 接口参数添加其它元数据 导入到 yapi 中不会被解析 属性属性名称数据类型默认值说明 nameString 参数名称 参数名称将从 filed method parameter 名称中派生 但你可以覆盖它 路径参数必须始终命名为它们所代表的路径部分 valueString



使用场景

在 Rest 接口上或 Rest 接口参数前边使用

概述

为 Rest 接口参数添加其它元数据(导入到 yapi 中不会被解析)

属性

属性名称 数据类型 默认值 说明
name String “” 参数名称,参数名称将从 filed/method/parameter 名称中派生,但你可以覆盖它,路径参数必须始终命名为它们所代表的路径部分
value String “” 参数简单描述
defaultValue String “” 描述参数默认值
allowableValues String “” 可接收参数值限制,有三种方式,取值列表,取值范围
required boolean false 是否为必传参数, false:非必传; true:必传
access String “” 参数过滤,请参阅:io.swagger.core.filter.SwaggerSpecFilter
allowMultiple boolean false 指定参数是否可以通过多次出现来接收多个值
hidden boolean false 隐藏参数列表中的参数
example String “” 非请求体(body)类型的单个参数示例
examples Example @Example(value = @ExampleProperty(mediaType = “”, value = “”)) 参数示例,仅适用于请求体类型的请求
type String “” 添加覆盖检测到类型的功能
format String “” 添加提供自定义format格式的功能
allowEmptyValue boolean false 添加将格式设置为空的功能
readOnly boolean false 添加被指定为只读的能力
collectionFormat String “” 添加使用 array 类型覆盖 collectionFormat 的功能


版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/216594.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月18日 上午11:30
下一篇 2026年3月18日 上午11:31


相关推荐

  • C语言 最长回文子串[通俗易懂]

    C语言 最长回文子串[通俗易懂]描述:输入一个字符串,求其中最长回文子串。子串的含义是:在字符串中连续出现得字符串片段。回文的含义是,正着看和倒着看是相同的,如abba何abbebba。在判断时要求忽略所有的标点和空格,且忽略大小写。但输出时按原样输出(首尾不要输出多余的字符串).输入字符串长度大于等于1小于等于5000.且单独占一行。输入:输入一行字符串。输出:输出所要求的回文子串。样例输入:L…

    2022年6月7日
    58
  • Claude Code 入门教程

    Claude Code 入门教程

    2026年3月16日
    2
  • html a标签打开新页面,A标签新窗口打开怎么设置

    html a标签打开新页面,A标签新窗口打开怎么设置超链 strong gt a 标签新窗口打开怎么设置怎么实现 a 锚文本打开方式设置首先看看 a 标签最简单最基本结构代码 p gt CSS5 lt a gt 这样 ldquo CSS5 rdquo 文字设置 A 锚文本超链接 p gt 如果要让新窗口打开那么还要对 a 标签内使用 target 属性 p gt 常用 target 属性值解析 target blank 设置新窗口新浏览器标签

    2026年3月20日
    3
  • 在Excel中使用频率最高的函数的功能和使用方法

    在Excel中使用频率最高的函数的功能和使用方法,按字母排序:1、ABS函数函数名称:ABS主要功能:求出相应数字的绝对值。使用格式:ABS(number)参数说明:number代表需要求绝

    2021年12月24日
    60
  • CAN总线应用开发接口

    CAN总线应用开发接口由于系统将CAN设备作为网络设备进行管理,因此在CAN总线应用开发方面,Linux提供了SocketCAN接口,使得CAN总线通信近似于和以太网的通信,应用程序开发接口更加通用,也更加灵活。此外,通过https://gitorious.org/linux-can/can-utils网站发布的基于SocketCAN的can-utils工具套件,也可以实现简易的CAN总线通信。下面具体

    2022年6月19日
    54
  • OpenClaw云部署实践

    OpenClaw云部署实践

    2026年3月13日
    2

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注全栈程序员社区公众号