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

Question

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

我正在使用 Maven，配置了 enunciate 插件(常规)以及构建插件 maven 节点中的文档目标。

这可能吗？

谢谢。

Answer 1

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

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

即使在今天，Enunciate 的 JSON 支持感觉就像是二等公民，因为它仅在 POJO 上受支持，而且即使如此，它也是基于 JAXB 注释而不是 Jackson 注释等。要使 JSON 成为一等公民，仍然需要做一些工作，但由于没有 Java 标准 JSON 注释集(如 JAXB 注释集)，这一努力受到阻碍。因此，如果今天完成这项工作，它必须与特定的 JSON 库实现(可能是 Jackson)相关联。