在Swagger与openapi 3.0中，我的嵌套对象方案不被显示

Question

我正在使用express框架的nodeJS项目中工作，我正在使用swagger-jsdoc和swagger-ui-express，我也在yaml文件中编写我的配置。我想记录我的服务，但我有一些问题，当我试图显示嵌套的对象。简单地说，当我展开嵌套对象树时，我看不到任何东西。请帮助。

[Swagger definition][1]
[My yaml file][2]
[Result in browser][3]
[1]: https://i.stack.imgur.com/by9EU.png
[2]: https://i.stack.imgur.com/KMyXN.png
[3]: https://i.stack.imgur.com/OHwlt.png

Answer 1

值为另一个对象实例的属性定义如下:

components:
schemas:
...
BuilderElementRequest:
type: object
properties:
pageSectionElementRequest:
$ref: '#/components/schemas/PageSectionElementRequest'   # <---------
removedElements:
type: array
items:
type: string

为OpenAPI 3.0中的引用模式添加一个自定义示例(即覆盖默认示例)。x，您需要将$ref包装成allOf:

pageSectionElementRequest:
allOf:
- $ref: '#/components/schemas/PageSectionElementRequest'
example:
element: '11112'