如何记录基于 Metro 的 JAX-WS 应用程序答案

【问题标题】：How to document a metro based JAX-WS application如何记录基于 Metro 的 JAX-WS 应用程序
【发布时间】：2015-07-30 08:31:25
【问题描述】：

我已经使用 Metro 实现开发了一些 JAX-WS Web 服务。

现在我想添加到这些 Web 服务的是某种文档。 Metro 本身会为您生成一个“简单”的 doc html 文件，其中包括 WSDL 的位置等等。

所以我一直在做一些研究，并且发现了 Enunciate，它可以帮助您以多种编程语言生成文档和 Web 服务的客户端（这非常有用）。但我暂时只对文档的生成感兴趣。我可以看到支持 Apache CXF、JAX-WS、JAX-RS 但不支持 Metro，或者我找不到插件。

那么，我能否为我的网络服务生成文档？

是否有任何其他工具可以生成 JAX-WS 应用程序的文档（基于 Metro）？

提前谢谢你

【问题讨论】：

刚刚注意到这个有趣的问题。 Metro 生成的“简单 doc html 文件”是什么意思？有一个从 WSDL 生成文档的简洁工具，我们已经使用了多年，如果您正在寻找它，我将在单独的答案中解释它。
@MiljenMikic metro 在根目录生成一个简单的 html 文档页面，其中出现服务名称、服务端口、wsdl 位置、位置和实现类。顺便说一句，我确实找到了一个可以帮助您记录大量应用程序的工具：enunciate.webcohesion.com

【解决方案1】：

您发现的Eunciate 确实很强大，不仅仅是记录服务。但是，如果您只是在搜索文档，那么我们团队已经使用了很长一段时间的一个简洁工具 - Tomi Vanek 的WSDL viewer。

使用非常简单，除了现有的.wsdl文件外，附上已经提供的.xsl文件，用一行增强.wsdl文件

<?xml-stylesheet type="text/xsl" href="wsdl-viewer.xsl"?>

然后在浏览器中打开 .wsdl 文件。你会看到这样的：（刚刚准备了一个演示 :)）

一些备注：

将文档添加到 .wsdl 文件是使用 <wsdl:documentation> 标签执行的
您将能够在除 Chrome 之外的所有现代浏览器中打开此类 .wsdl 文件，因为 Chrome blocks XSL transform on a local file

HTH。

【讨论】：