Ho在swagger上添加多个示例项

Ho在swagger上添加多个示例项,swagger,swagger-ui,swagger-2.0,Swagger,Swagger Ui,Swagger 2.0,需要关于如何在“招摇过市”上执行此操作的帮助 @SWG\Property(property="LineItems", type="array", @SWG\Items(ref="#/definitions/LineItem")) @SWG\Definition( definition="LineItem", required={"Description","Quantity","UnitAmount"}, @SWG\Property(property="Descr

需要关于如何在“招摇过市”上执行此操作的帮助

@SWG\Property(property="LineItems", type="array", @SWG\Items(ref="#/definitions/LineItem"))

@SWG\Definition(
     definition="LineItem",
     required={"Description","Quantity","UnitAmount"},
     @SWG\Property(property="Description", type="string", example="Item 1"),
     @SWG\Property(property="Quantity", type="integer", example=100),
     @SWG\Property(property="UnitAmount", type="float", example=11)
)

@SWG\Definition(
     definition="LineItem2",
     required={"Description","Quantity","UnitAmount"},
     @SWG\Property(property="Description", type="string", example="Item 2"),
     @SWG\Property(property="Quantity", type="integer", example=10),
     @SWG\Property(property="UnitAmount", type="float", example=21)
)
我想在LineItems属性上添加LineItem和LineItem2,我想输出如下

"LineItems": [
        {
          "Description": "Item 1",
          "Quantity": 100,
          "UnitAmount": 11,
        },
        {
          "Description": "Item 2",
          "Quantity": 100,
          "UnitAmount": 22,
        }
      ]

要在Swagger UI中显示包含多个项目的数组示例,您需要一个数组级别的
示例
,例如:

行项目:
类型:数组
项目:
$ref:“#/definitions/LineItem”
#多项目示例
例子:
-说明:项目1
数量:100
总数:11
-说明:项目2
数量:100
总数:22
也就是说,数组项只有一个定义(
LineItem
),多项目示例是使用数组级别的
example
关键字定义的

这个版本的招摇过市的PHP版本是:

*@SWG\Property(
*property=“LineItems”,
*type=“数组”,
*@SWG\Items(ref=“#/definitions/LineItem”),
*示例={
*{“说明”:“第1项”,“数量”:100,“单位数量”:11},
*{“说明”:“第2项”,“数量”:100,“单位数量”:22}
*   }
* )