如何使用 swagger 为同一对象提供多个示例值

Question

我创建了一个模型类（产品），它包含两个字段名称和值。 我想为产品模型提供招摇的默认值。我能够在 @ApiModelProperty 注释的帮助下做到这一点，并且工作正常。 但我的实际要求是为同一个对象提供多个值，就像这样

{
  "products": [
    {
      "name": "X",
      "value": "100"
    },
    {
      "name": "Y",
      "value": "100"
    },
    {
      "name": "Z",
      "value": "100"
    },
    {
      "name": "A",
      "value": "01"
    }
  ]
} 

我正在尝试为 HTTP POST 请求创建此默认模型，如何使用 swagger2 和 springboot 实现此目标

Answer 1

你应该用datatype="List"标记文件

public class MyClass {
....
@ApiModelProperty(datatype="List", example = "'['{'name': 'X','value': '100'}']")
private List< Product> products;
....
}

编辑

public class MyClass {
....
@ApiModelProperty(value = "{\n'name':'X',\n'value':'100'\n},\n{\n'name':'Y',\n'value':'100'\n}")
private List< Product> products;
....
}