从WSDL生成HTML文档

Question

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

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

Answer 1

我尝试了几种替代品

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

Answer 2

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

Answer 3

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

奇迹般有效

Answer 4

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

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

Answer 5

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

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

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

主要特点

通过任意数量的WSDL/XSD文件生成单个框架(类似Javadoc)的HTML文档.(如果输入文件太多,可以使用类似Ant的路径名模式选择它们).
处理任意数量的XML模式(以及WSDL),包括:
- 以单独的XSD文件的形式
- 嵌入在WSDL中的XML模式(在<wsdl:definitons>/<wsdl:types>元素内)
处理任何引用的 WSDL文件和XML模式,特别是:
- 所有的正确处理<wsdl:import>,<xs:import>,<xs:include>,<xs:redefine>在所有参与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):

易趣交易API - WSDL文档

链接