Swagger：如何在swagger文件中引用Document对象？

Question

我无法在我的招摇文件中引用org.w3c.dom.Document。这是必要的，因为其中一个端点将从第三方服务接收xml文档 我试过了两个： $ref: '#/definitions/org.w3c.dom.Document'和$ref: '#/definitions/Document'，但没有运气。

Answer 1

Swagger要求您指定要接收的对象的架构。 Document不是一个模式 - 它是一个XML对象表示的实现，从摇摆不定的角度来看，在构造一个对象来调用你的服务时并不是非常有用。更有用的信息将是您发送的对象的架构或形状。

您有两种选择：

1）为输入对象建模。您可以使用xml提示来告诉它是否为包装数组等。

2）将其定义为object类型。这意味着，您没有具体的对象定义。