我已经使用 enunciate 成功地为我的端点创建了文档。这是来自端点的示例:
@Produces("application/json")
public class Messages {
.....
@DocumentationExample("provide an example")
@Consumes("application/json")
@GET
Message createMessage (Message input) {
.... store the message, validate, etc.
}
....
}
在 JAX-WS 中通过Message
映射Jackson
并具有以下结构:
@XmlRootType
public class Message {
..
}
虽然这适用于发音,但我在文档中的任何地方都看不到@Produces,也看不到@Consumes。是否有可能以其他方式“标记”域类——不是通过@XmlRootElement
,而是通过一些外部配置文件?我不热衷于仅仅为了发音而改变域(即使涉及注释)。
我也没有看到@DocumentationExample
注释(或作为示例指定的值)。是否可以提供多个示例?
谢谢。