10

anyOf我正在尝试使用和allOf属性制作 OpenAPI 自动生成的 PHP 客户端。

目标是能够返回一个具有多态性的数组：不同类型的对象。
这些对象也有一个共同的基础对象。

在我的示例模式中，Items它是一个数组，其中项目可以是类型ItemOne或ItemTwo.
这两种类型的项目都有一个自己的属性（itemOneProperty和itemTwoProperty，分别）和一个公共属性（baseItemProperty从关键字继承）。BaseItemallOf

这里有 API 规范 yaml：

openapi: 3.0.0
info:
  title: Test API
  version: 1.0.0
servers:
  - url: https://api.myjson.com/bins

paths:
  /roxgd:
    get:
      operationId: getItems
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Items'
components:
  schemas:

    Items:
      type: array
      items:
        anyOf:
          - $ref: '#/components/schemas/ItemOne'
          - $ref: '#/components/schemas/ItemTwo'

    BaseItem:
      type: object
      properties:
        baseItemProperty:
          type: string

    ItemOne:
      allOf:
        - $ref: '#/components/schemas/BaseItem'
        - type: object
          properties:
            itemOneProperty:
              type: string

    ItemTwo:
      allOf:
        - $ref: '#/components/schemas/BaseItem'
        - type: object
          properties:
            itemTwoProperty:
              type: string

这是我发送请求的端点：https ://api.myjson.com/bins/roxgd

它返回这个示例 json：

[
    {
        type: "ItemOne",
        baseItemProperty: "foo1",
        itemOneProperty: "bar1"
    },
    {
        type: "ItemTwo",
        baseItemProperty: "foo2",
        itemTwoProperty: "bar2"
    }
]

PHP 客户端生成时没有错误，但是当它调用该getItems方法时，我得到了这个致命错误：

PHP Fatal error:  Uncaught Error: Class 'AnyOfItemOneItemTwo' not found in /home/user/projects/openapi-test/lib/ObjectSerializer.php:309
Stack trace:
#0 /home/user/projects/openapi-test/lib/ObjectSerializer.php(261): MyRepo\OpenApiTest\ObjectSerializer::deserialize(Object(stdClass), 'AnyOfItemOneIte...', NULL)
#1 /home/user/projects/openapi-test/lib/Api/DefaultApi.php(182): MyRepo\OpenApiTest\ObjectSerializer::deserialize(Array, 'AnyOfItemOneIte...', Array)
#2 /home/user/projects/openapi-test/lib/Api/DefaultApi.php(128): MyRepo\OpenApiTest\Api\DefaultApi->getItemsWithHttpInfo()
#3 /home/user/projects/tests-for-openapi-test/test.php(10): MyRepo\OpenApiTest\Api\DefaultApi->getItems()
#4 {main}
  thrown in /home/user/projects/openapi-test/lib/ObjectSerializer.php on line 309

如果我使用该oneOf属性，也会发生同样的情况，但我得到的错误是：Uncaught Error: Class 'OneOfItemOneItemTwo' not found....

当我使用任何其他有效的 yaml（没有多态性）时，我的设置工作正常。

另外，我已经检查了这个相关的问题，但那是关于 UI 的，我根本没有使用它。

你知道错误可能在哪里吗？我的 yaml 文档中有错误？PHP客户端生成器中的错误？

编辑：我正在使用 openapi-generator v4.0.3（此时的最新版本）。

4

1 回答 1

3

经过更多研究，我发现从 4.0.0 版本开始，openapi-generator 中的继承存在一个未解决的问题。

https://github.com/OpenAPITools/openapi-generator/issues/2845

于 2019-08-10T09:51:46.583 回答