Swagger HashMap属性类型

Question

是否有任何方法可以在模型部分定义HashMap或泛型对象类型？我有一个返回产品的REST服务，这些产品可以有不同的选择。options属性基本上是一个HashMap，其中id是选项名，其值是选项值。

Answer 1

这对我有用。没有任何值类型限制

      definitions:
        dynamicFields:
          type: object
          additionalProperties: {}

示例：您可以在此处传递任何类型的值

{
   "dynamicFields" : {
      "accountNo": "aaaaaa3455",
      "customerNo": 123455,
      "isApplicable": true,
      "phoneNo": [
        "38859379384",
        3948399448,
        true
      ]
    }
}

Answer 2

是的，这是可能的。

在OpenAPI（fka. Swagger）2.0和3.0中，hashmap始终是一个

• 键始终是字符串，不需要定义。
• 值类型是所需的值类型，并使用附加属性进行定义。

假设您想要描述一个<代码>

{
  "key1": "value1",
  "key2": "value2"
}

相应的OpenAPI 2.0定义将是:

definitions:
  StringStringMap:
    type: object
    additionalProperties:
      type: string

在OpenAPI 3.0中，定义为：

components:
  schemas:
    StringStringMap:
      type: object
      additionalProperties:
        type: string


A＜代码＞

{
  "key1": {"someData": "data", "someOtherData": true},
  "key2": {"someData": "data2", "someOtherData": false}
}

在 OpenAPI 2.0 中将按以下方式定义：

definitions:
  ComplexObject:
    type: object
    properties:
      someData:
        type: string
      someOtherData:
        type: boolean

  StringObjectMap:
    type: object
    additionalProperties:
      $ref: "#/definitions/ComplexObject"

在OpenAPI 3.0中：

components:
  schemas:
    ComplexObject:
      type: object
      properties:
        someData:
          type: string
        someOtherData:
          type: boolean

    StringObjectMap:
      type: object
      additionalProperties:
        $ref: "#/definitions/ComplexObject"

我刚刚在我的OpenAPI（fka Swagger教程）的第4部分中深入介绍了这一点。

OpenAPI (fka。Swagger)规范也简要地解释了这一点。