现在的位置: 首页 > 综合 > 正文

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

2012年12月15日 ⁄ 综合 ⁄ 共 2023字 ⁄ 字号 评论关闭

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中。到您可以保证数据的在线显示方式时,互操作性对您来说就已经近在咫尺了!

抱歉!评论已关闭.