api和model swagger之间的差异

我是新来的，我正在定义一个API

---

我是否可以使用swagger定义api而不需要使用

@ApiModelProperty

注释？swagger中的对象模型到底是什么？

是的，您可以定义API，而无需使用

@ApiModelProperty

。Models对象不是OpenAPI规范中的必填字段

Models对象为每个模型定义保留一个字段，这与规范中其他对象的结构不同。它遵循JSON模式规范的一个子集

@ApiModelProperty

定义该对象的属性。此外，模型对象也是Swagger中响应的一部分

例如，您有一个model-

User

类

 class User {
   int id;
   String name;
   int age;
 }

模型对象将包含有关用户的信息

{
"User": {
  "id": "User",
  "properties": {
    "id": {
      "type": "integer",
      "format": "int64"
    },
    "name": {
      "type": "string"
    },
   "age": {
      "type": "integer"
    }
  }
 }
}

@ApiModelProperty

在Java类

User

中使用，通过在其中定义id、名称和年龄来生成此JSON