存在哪些方法來公開SOAP接口上的文檔？

Question

我正在嘗試公開SOAP服務的文檔（如Javadocs）。最好的情況下，它可以直接從WSDL中暴露出來，也可以通過自發生成的報告暴露出來。我使用CXF作爲我的SOAP實現。

我嘗試過使用WSDL查找器找到here，但是我沒有找到一個關於如何註釋我的方法以獲得他的示例中所見的結構和詳細程度的好教程。

Answer 1

迄今爲止發現的最佳解決方案是使用名爲Enunciate的引擎（http://enunciate.codehaus.org/）。一旦添加到項目中，它將讀取JavaDocs並組成一組HTML文件。我沒有完全理解所有的功能或問題（它生成並鏈接到它自己的WSDL，這並不理想，並且在項目中的額外文件夾中「臨時工作」，然後作爲錯誤讀取，除非被刪除） ，但它確實以清晰且可用的方式成功讀取並公開了JavaDoc。