使用enunciate为列表，数组，映射等生成消息体的示例xml / json？

Question

我能够通过enunciate生成REST API文档，我真的很喜欢它为消息体生成的xml和json示例。我找不到如何让它为列表，数组，地图等生成它们。

我正在使用maven，使用enunciate插件（常规）配置build plugins maven节点中的docs目标。

这可能吗？

感谢。

Answer 1

不幸的是，Enunciate目前不支持此功能。

原因是历史性的。 Enunciate是在JSON受欢迎之前编写的，因此最初的设计是仅记录返回JAXB个对象的Web服务。之后添加了对JSON的支持，并且从那时起已经多次增强。

即便在今天，Enunciate的JSON支持感觉就像是二等公民，因为它只支持POJO，即便如此，它也是基于JAXB注释而不是Jackson注释。仍然需要完成使JSON成为一等公民的工作，但是由于没有Java标准JSON注释集（如JAXB注释集）这一事实阻碍了这种努力。因此，如果工作今天完成，则必须绑定到特定的JSON库实现（可能是Jackson）。