Java Swagger-描述JSON有效负载字段

在一个使用招摇过市的休息服务中，我有 公共用户响应createUser@RequestBodyCreateUserRequest请求

此CreateUserRequest是一个POJO/bean。 调用者将其作为JSON传入

是否有任何夸张的注释来描述： a哪些POJO字段是必填字段，哪些是可选字段 b POJO字段的默认值

我发现了这样的注释，例如GET参数，但是如果我需要描述JSON负载/主体呢

我只使用注释，没有大摇大摆的YAML

请求主体通常与“创建”和“更新”操作POST、PUT和PATCH一起使用。例如，当使用POST或PUT创建资源时，请求主体通常包含要创建的资源的表示。OpenAPI3.0提供了requestBody关键字来描述请求主体

schema关键字用于描述响应主体。模式可以定义：

对象或数组-通常与JSON和XML API一起使用， 基本数据类型，如数字或字符串–用于纯文本响应， 一个文件–见下文。

---

查看annotation@ApiModelProperty，检查swagger wiki中的所有注释

我找到了这个页面。但我没有YAML。我只有注解。我不确定我是否在使用OpenAPI3。我使用的是从父POM继承的swagger-annotations-1.5.20.jar。所以我无法控制。谢谢，这正是我需要的。