从WSDL生成HTML文档

从WSDL生成某种人类可读文档的方法是什么？在过去,我使用过WSDL查看器(由Tomi Vanek提供)(请参阅我关于将其集成到NAnt的博客文章),我对结果感到满意,但我对任何可能的替代方案感兴趣.

我也听说过x3sp,但我还没试过.

1> fglez..：

---

我尝试了几种替代品

TechWriter for Web Services:真的很强大,但HTML输出是(见注释)多文件.此外,评论表明它已经退役,但现在已经不再适用了.

XML Editor:它不处理嵌入式架构.

Altova XML Spy:它不处理匿名类型.

并最终根据我的需要调整WSDL查看器.

---

当前版本的TechWriter for Web Services也支持单页HTML输出.

2> Jian Chen..：

---

是的,有一个新的:wsdl2html.它侧重于请求/响应,并删除人们不关心的信息.

3> Tomáš Fejfar..：

---

使用http://code.google.com/p/wsdl-viewer/和cygwin的xsltproc

xsltproc wsdl-viewer.xsl downloaded-wsdl.xml > documetnation.html

奇迹般有效

4> Halfstop..：

---

它没有列在这里,但是SoapUI有一个有用的wsdl文档生成器.

右键单击您的项目,然后选择"生成文档".

5> Leonid Rudy..：

---

现在,还有一个工具,称为" DocFlex/XML WSDLDoc ".

它是一个新的WSDL/XSD文档生成器,它允许您记录任意数量的WSDL和XML模式(XSD)文件以及它们之间的任何互连.

还可以选择自动包含Altova XMLSpy或Oxygen XML生成的XSD图表.实际上,它们中的任何一个都可以用作动态链接的图表引擎.

主要特点

通过任意数量的WSDL/XSD文件生成单个框架(类似Javadoc)的HTML文档.(如果输入文件太多,可以使用类似Ant的路径名模式选择它们).

处理任意数量的XML模式(以及WSDL),包括:

以单独的XSD文件的形式

嵌入在WSDL中的XML模式(在/元素内)

处理任何引用的 WSDL文件和XML模式,特别是:

所有的正确处理,,,在所有参与WSDL/XSD文件中发现的元素.

所有直接/间接引用的WSDL/XSD文件的自动加载和处理(即包含在文档范围中).

XSD组件的复杂文档(XML模式文档):

支持任何XML架构设计模式.

可以自动包含由XMLSpy或Oxygen XML生成的XSD图,并支持所有图表超链接.

记录WSDL定义和XSD组件之间的所有互连:

从WSDL消息到描述消息数据的XSD元素/类型的详细信息的超链接.

在XSD元素/类型详细信息中,使用它们的所有WSDL定义的列表.

将XSD元素/类型的注释复制到使用它们的那些WSDL消息(甚至操作)的文档中.

可以无限制定制.WSDLDoc实际上是DocFlex/XML的模板集,DocFlex/XML是一个软件系统,用于从存储在XML文件中的任何数据开发和执行高性能文档和报告生成器.

例

以下是此类文档的演示(它由单个源文件生成:http: //developer.ebay.com/webservices/latest/ebaySvc.wsdl):

HTML本身:http://www.filigris.com/docflex-xml/wsdldoc/examples/html/ebaySvc/index.html

链接

http://www.filigris.com/docflex-xml/wsdldoc/