java - 使用发音为列表、数组、地图等的消息正文生成示例 xml/json？

Question

我能够通过 enunciate 生成 REST API 文档，我非常喜欢它为消息正文生成的示例 xml 和 json。我找不到如何让它为列表、数组、地图等生成那些。

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

这可能吗？

谢谢。

Answer 1

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

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

即使在今天，Enunciate 的 JSON 支持也感觉像是二等公民，因为它仅在 POJO 上受支持，而且即使在那时，它也是基于 JAXB 注释而不是例如 Jackson 注释。仍然需要做一些工作才能使 JSON 成为一等公民，但是由于没有 Java 标准 JSON 注释集（如 JAXB 注释集），这项工作受到了阻碍。因此，如果今天完成了这项工作，则必须将其绑定到特定的 JSON 库实现（可能是 Jackson）。