从WSDL生成HTML文档[已关闭]

我试过几种选择

• TechWriter for Web Services :非常强大,但HTML输出是多文件的(参见注释)。此外,评论指出它已退役,但情况已不再如此。
• <oXygen/> XML Editor
• Altova XML Spy :它不处理匿名类型。

最后根据我的需要调整WSDL查看器。

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

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

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

这里没有列出,但是 SoapUI 有一个有用的wsdl文档生成器。

现在,还有一个工具,叫做“ DocFlex/XML WSDLDoc

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

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

主要特征

• 生成单帧(类似Javadoc) WSDL/XSD文件 在一起(如果有太多的输入文件,可以使用类似Ant的路径名模式将它们全部拾取)。
• 处理任意数量的 (连同WSDL)包括:
  • 以单独的XSD文件的形式
  • 嵌入在WSDL中的XML模式(在 <wsdl:definitons>/<wsdl:types> 元素)
• 处理任何
  • 正确处理所有 <wsdl:import> , <xs:import> , <xs:include> <xs:redefine> 在所有涉及的WSDL/XSD文件中找到的元素。
  • 自动加载和处理(即包含在文档范围内)所有直接/间接引用的WSDL/XSD文件。
• 复杂的数据记录 (XML模式文档):
  • 支持任何XML模式设计模式。
  • XSD图 产生于 XMLSpy 或 Oxygen XML ,并支持所有图表超链接。
• 所有文件的记录 互连 在WSDL定义和XSD组件之间:
  • 从WSDL消息到描述消息数据的XSD元素/类型细节的超链接。
  • 在XSD元素/类型详细信息中,使用它们的所有WSDL定义的列表。
• 无限可能性 定制 . WSDLDoc实际上是为 DocFlex/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/

我刚刚发现,安装了Xml工具插件的Notepad++也可以进行xsl转换。如果您提供前面提到的wsdl-viewer.xsl和wsdl文件,您将得到一个格式良好的html。

Altova的XMLSpy确实从WSDL生成HTML文档

我知道这是一种穷人的文档编制方法,但我曾在VisualStudio中打开wsdl的XSD,并在其中添加注释和箭头以清晰地显示出来,我们的客户似乎喜欢它,而不必使用其他工具。您也可能没有这个版本,但可以使用免费VPC或MSDN订阅的版本。我还使用BizTalk模式编辑器查看XSD,并使用snag-it或其他屏幕捕获应用程序记录XSD。我会尽量利用你所拥有的!

-布莱恩

您可以使用“wsimport”,它是JDK的一部分,并对生成的文件运行Javadoc。假设您已经添加了注释,它会将它们作为文档的一部分。

你可以使用iDocIt!为WSDL编制文档,然后将文档导出为HTML。它是一个可下载的开源Eclipse插件 here

它提供了一种使用主题网格和主题角色创建文档的新方法,但您不需要使用它们。您仍然可以创建纯文本形式的文档。