Enunciate - 如何在生成的 REST 文档中显示媒体类型？答案

【问题标题】：Enunciate - How to display media types in the generated REST documents?Enunciate - 如何在生成的 REST 文档中显示媒体类型？
【发布时间】：2012-02-01 17:07:27
【问题描述】：

我已经使用 enunciate 成功地为我的端点创建了文档。这是来自端点的示例：

@Produces("application/json")
public class Messages {
  .....
  @DocumentationExample("provide an example")
  @Consumes("application/json")
  @GET
  Message createMessage (Message input) {
    .... store the message, validate, etc. 
  }
  ....
}

Message 通过Jackson 在 JAX-WS 中映射，并具有以下结构：

@XmlRootType
public class Message {
  ..
}

虽然这适用于发音，但我在文档中的任何地方都看不到@Produces，也看不到@Consumes。是否有可能以其他方式“标记”域类——不是通过@XmlRootElement，而是通过一些外部配置文件？我不热衷于仅仅为了发音而更改域（即使涉及注释）。

我也没有看到 @DocumentationExample 注释（或作为示例指定的值）。是否可以提供多个示例？

谢谢。

【问题讨论】：

标签： enunciate

【解决方案1】：

此问题已得到修复。最新的 Enunciate 版本是 1.27。

【讨论】：