我已使用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
注释(或指定为示例的值)。有可能提供多个例子吗?
感谢。
答案 0 :(得分:2)
此后已经修复。最新的Enunciate版本是1.27。