如何使用XFire创建文档化的WSDL

Question

我使用XFire在我的应用程序周围创建一个webservice包装器。XFire在运行时提供webservice接口和WSDL (或者在编译时创建它们，不是很清楚)。

我们的许多客户并不是很了解webservices，而且他们根本不会阅读任何像Javadoc这样的外部文档。我知道可以将文档(参数和方法)直接添加到WSDL文件中。

我想过注释或Aegis XML文件，但我不知道如何...你知道怎么做吗？

编辑:我刚找到这个JIRA issue，但最后一次活动是2006年。有什么想法吗？

Answer 1

XFire慢慢地走向/dev/null。请改用CXF。换句话说，XFire正在被弃用，取而代之的是CXF --它们是几乎相同的开发人员。

由于您使用的是Java-first方法，因此我建议您使用CXF的java2wsdl工具一次性生成WSDL，然后将您的文档放入其中，并告诉CXF使用有文档的WSDL，而不是让CXF在运行时/部署时生成自己的(无文档的) WSDL。

关于在This page中创建web服务，CXF几乎包含了您需要了解的所有内容。

Answer 2

和我关于CXF的最后一个提示-使用Aegis进行数据绑定，而不是JAXB。它不适用于复杂的POJO。

根据我的经验，使用复杂的POJO和JAXB没有问题，唯一的问题是代码开始被JAXBElements弄得乱七八糟。另一方面，Aegis文档相当稀疏，与CXF相关的维护也不好。

Answer 3

让我补充一下我对XFire的两点看法。在JDK6 (Tomcat6.0和5.5).Please下，我们遇到了非常严重的XFie问题，看看that issue吧。在我们的例子中，使用JDK6下的4+ web服务的XFire会导致应用程序服务器挂起(线程死锁等)。这很有趣，但是在JDK5下一切都很好。

我完全同意Christian Vest关于从XFire迁移到CXF的观点。它在很多情况下都有意义，比如ESBMule2不再支持原生XFire连接器(see also)。

我想补充的是，从XFire迁移到CXF并不是一种直接的方式(例如，CXF具有与一些hibernate版本see also冲突的jar依赖)，但它是可行的。在我们的例子中，我们做了几天没有纠正代码(仅Spring配置)。

关于CXF，我的最后一个提示是使用Aegis进行数据绑定，而不是JAXB。它不适用于复杂的POJO。