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

时间:2012-02-01 17:07:28

标签: enunciate

我已使用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 {
  ..
}

虽然这适用于enunciate,但我在文档中的任何地方都看不到@Produces和@Consumes。有可能以某种方式“标记”域类 - 不是通过@XmlRootElement,而是通过一些外部配置文件?我并不热衷于仅仅为了发音而更改域名(即使注释也是如此)。

我也没有看到@DocumentationExample注释(或指定为示例的值)。有可能提供多个例子吗?

感谢。

1 个答案:

答案 0 :(得分:2)

此后已经修复。最新的Enunciate版本是1.27。

相关问题