2016-07-30 344 views
0

我在做java-first web服務開發。我想爲@XmlElement添加一個字段的描述,以便生成的WSDL將包含該字段的文檔。將描述添加到JAXB @XmlElement?

看來你不能用@XmlElement來做到這一點。不知道爲什麼Oracle不支持它。

如果我選擇JAXB以外的其他綁定,我可以這樣做嗎?

回答

1

這是不可能使用JAXB註釋,以便文檔的細節將包含在生成的模式(見this

您可以使用CXF custom annotations,但只適用於港口和操作

@WebService 
@WSDLDocumentationCollection(
    { 
     @WSDLDocumentation("My portType documentation"), 
     @WSDLDocumentation(value = "My top level documentation", 
          placement = WSDLDocumentation.Placement.TOP), 
     @WSDLDocumentation(value = "My binding doc", 
          placement = WSDLDocumentation.Placement.BINDING) 
    } 
) 
public interface MyService { 

    @WSDLDocumentation("The docs for echoString") 
    String echoString(String s); 

} 
+0

很酷。順便說一下,是否有任何JIRA問題跟蹤CXF的WebParams和XmlElements的另一個文檔註釋的要求? –

+1

有一些問題報告,你可以看到通過自由文本'@ WSDLDocumentation'搜索。 https://issues.apache.org/jira/browse/CXF-6291?jql=text%20~%20%22%40WSDLDocumentation%22我認爲CXF-6291與您的要求類似。 https://issues.apache.org/jira/browse/CXF-6291 – pedrofb