招摇的多个示例体

时间:2015-11-14 09:06:08

标签: swagger swagger-2.0

我是一个接受对象的方法。该对象是动态的,它可以以5种不同的方式构造,具体取决于它具有多少个子节点以及它是哪种类型的对象。我希望它清楚如何构建这个对象,并显示哪些子类型可以一起使用。

示例A:新Michael(id,name,Type.A,new Sara(id,name,ChildrenType.B));

示例B:新Sandra(id,name,Type.C,new Pheno(id,name,ChildrenType.D),new Leo(id,name,ChildrenType.E));

正如我之前所说,该对象是动态的,可以根据对象的类型和它有多少个孩子以不同的方式构建。

我认为展示所有这一切的最佳方式是拥有5个不同的示例身体。但是如果有可能的话吗?这是最好的解决方案吗?

我正在使用java,如果它使我使用哪种语言的差异。

谢谢!

2 个答案:

答案 0 :(得分:3)

每个mime类型只能定义一个示例。 但是,您可以使用externalDocs重定向到包含所有示例的其他页面。

答案 1 :(得分:0)

如果您有一个有效负载的公共接口,您可以使用鉴别器来选择可以实例化的不同具体类型。