2011-11-25 75 views
1

像標題所說:是否有可能導出我的Web服務方法參數的javadoc註釋到wsdl?我們使用CXF和java2ws目標,通過maven從源代碼生成wsdl。使用CXF和maven將源代碼註釋導出到WSDL?

+0

不確定關於JAXWS和params,但與JAXRS,你可以用'org.apache.cxf.jaxrs.ext.Description'註解*方法*,並在生成的WADL中顯示。 – Qwerky

+0

嗯,有一個'@ WSDLDocumentation'註釋,但這還不夠好。如果有一個參數不止一個或兩個參數的方法或必須用於創建參數的構造函數,那麼整個方法的描述就不夠了。我想讓javadocs可用,以便使用webservice的開發人員知道如何構建服務期望的對象。 – Pete

回答

2

您可以使用@WSDLDocumentationCollection註釋將多個@WSDLDocumentation註釋附加到單個方法(具有不同的展示位置),但不能將其用於比單據操作更爲深入的操作,因爲這是它停止的地方成爲WSDL問題併成爲XSD問題。 XSD文檔將由JAXB級別的註釋處理,但不存在此類註釋;生成的模式將不包含<xs:documentation>元素。 (當從模式開始時,文檔註釋可以生成爲Javadoc,但由於Javadoc註釋未保留在Java類文件中,因此不會發生相反的方向。)