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

Question

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

我曾尝试使用此处找到的 WSDL 查看器，但我没有找到一个很好的教程来说明如何注释我的方法以获取在他的示例中看到的结构和详细程度。

Answer 1

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