2
我已經使用聲明成功地爲我的端點創建了文檔。這是從終點的樣本:闡明 - 如何在生成的REST文檔中顯示媒體類型?
@Produces("application/json")
public class Messages {
.....
@DocumentationExample("provide an example")
@Consumes("application/json")
@GET
Message createMessage (Message input) {
.... store the message, validate, etc.
}
....
}
的Message
在JAX-WS通過Jackson
映射,並且具有這樣的結構:
@XmlRootType
public class Message {
..
}
儘管這適用於字正腔圓,我無法看到無論是文檔中的任何地方都有@Produces和@Consumes。是否有可能以某種方式「標記」域類 - 不是通過@XmlRootElement
,而是通過一些外部配置文件?我並不熱衷於僅僅爲了發音而改變域名(即使註釋涉及到)。
我也看不到@DocumentationExample
註釋(或例如指定的值)。是否可以提供多個示例?
謝謝。