有哪些方法可以公开SOAP接口上的文档？

Question

我正在尝试为SOAP服务公开文档（如Javadocs）。最好的情况是，它可以直接从WSDL中公开，也可以通过自动生成的报告公开。我使用CXF作为我的SOAP实现。

我尝试过使用找到here的WSDL Viewer，但是我没有找到一个很好的教程，如何注释我的方法以获得他的例子中所见的结构和细节级别。

Answer 1

到目前为止，我发现的最佳解决方案是使用称为Enunciate（http://enunciate.codehaus.org/）的引擎。一旦添加到项目中，它就会读取JavaDocs并组成一组HTML文件。我不完全理解所有的功能或问题（它生成并链接到自己的WSDL，这是不理想的，并且在项目中的额外文件夹中进行“临时工作”，然后读取为错误，除非删除） ，但它确实以清晰可用的方式成功读取和公开JavaDoc。