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

标签 java rest maven-2 enunciate

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

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

这可能吗?

谢谢。

最佳答案

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

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

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

关于java - 使用 enunciate 为列表、数组、 map 等的消息正文生成示例 xml/json?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/11978936/

相关文章:

javascript - ExtJS 存储/代理不向服务器发送删除方法

java - 处理 JAR 和开发中的资源文件路径

maven-2 - 如何在一个子模块中覆盖 maven-release-plugin 配置

java - SimGrid。模拟异常情况

java - 在运行时动态地将 CORS 映射添加到 Rest Controller

Java 向 JPanel 添加虚线或点线边框

rest - 如何根据客户端调用实现具有多个数据库的Web API

java - 如何运行 pom.xml 中定义的依赖项的 buildr (buildr + eclipse + maven : integration)

java - FindBugs 新公式

java - Selenium 中的 Webelement.click