Web服务互操作开发的十大要点


在过去一段时间里，很多供应商纷纷以惊人的速度发布其Web服务的实现。这包括产品的主要版本、辅助版本和许多开发服务包。随着新版本越来越符合标准，不同供应商之间的互操作性越来越高。

尽管如此，仍然需要在共同使用这些Web服务时的建议和策略。有些实践允许您确保以互操作的方式既使用又公开Web服务。基于已有的经验，我整理了关于Web服务互操作性的“十大”要点列表。有些要点基于在Microsoft上运行的测试结果的发现，另外一些是在开发项目时觉得有用。这里的提示可以应用于IBM、BEA及多个开放源码堆栈。我希望它们对您有用。下面从下往上依次介绍这些要点：



本页内容
10. 当心空数组
9. 生成客户端代理时使用包和类型名称选项
8. 测试生成的Java Bean是否为空
7. Java可以识别空的日期和时间值，但.NET不能
6. 比较日期/时间时始终使用compareTo()
5. 使用“跟踪工具”进行研究
4. 为“更改主机和端口”添加选项
3. 生成Web服务时确保使用Document/Literal
2. 使用单元测试来测试互操作性
1.首先使用XSD

10. 当心空数组
通过Web服务发送空数组可能产生问题。有些工具包将空数组识别为单个空值，而另外一些则将其表示为一组空数组元素。我的一般原则是，通过Web服务发送对象数组时，始终确保让数组包含有效数据。


9. 生成客户端代理时使用包和类型名称选项
很多基于Java的工具有生成客户端代理时指定独特的包和类型名称的选项（例如，BEA WebLogic使用“clientgen”参数，IBM Rational Application Developer使用向导）。

为共享同一数据类型的Web服务创建代理时，对包和类型名称的控制非常重要，例如在调用两个具有相同Order类型的Web服务时。

8. 测试生成的Java Bean是否为空
使用工具或IDE从XSD文件生成Java Bean时，始终确保您知道如何执行测试操作以了解对象是否为空。您可能认为下面的代码可以完成这样的测试：

if (myObject == null)

但是在某些情况下，您是在测试对象是否存在，而不是对象的值是否存在。我的建议是，始终在生成的bean上检查isNil()方法（或类似方法）。如果它存在，则可确保得到真值。


7. Java可以识别空的日期和时间值，但.NET不能
在Java中，java.util.Date和java.util.Calendar被分类为引用类型。在.NET Framework 1.1中，System.DateTime被视为值类型。

这将会如何？引用类型可以为空，而值类型不能。如果要跨越Web服务发送空日期值，则始终以复杂类型发送值，并将复杂类型的值设置为空。这将有助于避免空的日期值被曲解（从而引发异常）。

6. 比较日期/时间时始终使用compareTo()
如果通过Web服务在.NET和Java之间发送日期和时间，则始终使用Java中适当的compareTo()方法来比较日期。例如使用：

if (myDate.compareTo(yourDate) == 0)

而不要使用：

if (myDate == yourDate)

这将有助于确保平台间日期比较的准确性，尤其是试图比较毫秒值时。

5. 使用“跟踪工具”进行研究
“跟踪工具”是研究SOAP请求和Web服务间响应的理想选择。它可以帮助验证数据类型和消息构造，还会报告您在浏览器中可能错过的SOAP错误。

可用的跟踪工具有很多类型 —— 有些在客户端上运行，有些在服务器上运行，有些甚至运行于客户端和服务器之间（如代理）。这些类型的跟踪工具设置起来比较困难，但是总的来说还是很有用的，因为您可以看到在系统之间传递的消息。有些代理跟踪工具甚至还可以让您编辑和回复消息——这一点对于调试非常有用。

4. 为“更改主机和端口”添加选项
设计Web服务客户端时，考虑添加一个帮助器方法用于更改Web服务位置的主机和端口值。这会为将来Web服务的位置变更或者把输出重定向到跟踪工具带来方便。我发现这在Web服务间进行故障切换时特别有用。

3. 生成Web服务时确保使用Document/Literal
有些工具包提供一个选项，让您从以下内容中为Web服务做出选择：

• RPC/Encoding

• RPC/Literal

• Document/Literal


这些选项为Web服务契约控制样式和编码机制。要帮助确保与WS-I Basic Profile一致，始终确保将Document/Literal作为您所有Web服务的默认编码机制。RPC/Literal仅在特殊情况下使用。永远不要使用RPC/Encoding。

2. 使用单元测试来测试互操作性
单元测试（使用.NET的NUnit或Java的JUnit）是通过Web服务检查多种数据类型的互操作性的最好方式。

如果数据类型变更（或如果更改Web服务工具包的版本！），则需要再次运行测试。这可以让您确信您设计的Web服务具有完整的互操作性。


1.首先使用XSD
设计互操作性时，始终一开始先定义数据。决定要发送的数据后，首先在XSD中创建数据类型，然后使用工具从XSD文件生成类。依此顺序执行操作，有助于确保数据类型的在线互操作性。为此，需要熟悉XSD —— 了解如何在XSD中建模数据和可用于建模数据的工具。XSD文件可以在Visual Studio .NET中直接创建和编辑。有了XSD后，在每个平台上使用适当的工具生成数据类型。在.NET中，可以使用xsd.exe（框架的一部分）或XsdObjectGen（可从MSDN免费下载）。对于Java，这取决于您所使用的工具包。对于IBM，使用Java Bean for XML Schema Wizard；对于BEA，将XSD文件拖到WebLogic Workshop中的Schemas文件夹中。如果是其他工具包，则搜索Schema2Java工具。完成后，在Web服务中公开生成的数据类型 ——此步骤的前提是，您需要确保这些类型能够被正确地序列化到XSD和XML中。到您可以保证数据的在线显示方式时，互操作性对您来说就已经近在咫尺了！