使用 IBM WebSphere JAX-RPC 运行时环境创建 Web Service

概述

WebSphere Application Server 使用在 Java™ Community Process（JCP）下为 Java 开发的 Java Web Service 标准。这些标准是 Java API for XML-based RPC（也称为 JAX-RPC 或 JSR 101）和 Web Services for J2EE（JSR 109 和 JSR 921）。JAX-RPC 包含用于在 Java 中使用基于 WSDL 的 Web Service 的编程模型和绑定。Web Services for J2EE 包含在 J2EE 环境中使用 JAX-RPC，以及在 J2EE 服务器中实现和部署 Web Service 实现过程。JAX-RPC 和 JSR-109 都适用于 J2EE 1.3 发行版，而 JAX-RPC 和 JSR-921 适用于 J2EE 1.4。

开发工件使企业 bean 或 Java bean 模块能够成为 Web Service。要从企业 bean 或 Java bean 模块来创建 Web Service，在开发时将下列文件添加到了它们的 JAR 或 WAR 模块中：

Web Service 定义语言（WSDL）XML

WSDL XML 文件描述正在实现的 Web Service。

服务端点接口（SEI）

SEI 是与正在实现的 Web Service 端口类型相对应的 Java 接口。它是由 JAX-RPC 定义的，JAX-RPC 指定 WSDL 1.1 至 Java 的语言映射。

webservices.xml

webservices.xml 文件是 J2EE（JSR 109）Web Service 部署描述符，它指定 Web Service 是如何实现的。它是在 Web Services for J2EE 规范的第 7.1 节中定义的。

JAX-RPC 映射文件

“JAX-RPC 映射”部署描述符指定 Java 元素与 WSDL 元素之间是如何映射的。它是在 Web Services for J2EE 规范的第 7.3 节中定义的。

ibm-webservices-bnd.xmi 和 ibm-webservices-ext.xmi

这些文件包含主要用于安全 Web Service 的特定于 WebSphere 的部署信息。

在组装时，将下列文件添加至应用程序客户机或 Web 模块，以便 J2EE Application Client 能够访问 Web Service：

WSDL

WSDL 文件由 Web Service 实现者提供。

Web Service 的 Java 接口

Java 接口是从 WSDL 文件按照 Java API for XML-based RPC（JAX-RPC）指定的那样生成的。这些绑定是 SEI（它基于 WSDL 端口类型）或“服务接口”（它基于 WSDL 服务）。

webservicesclient.xml

webservicesclient.xml 文件是由使用 J2EE 1.3 的 Web Service 生成的客户端部署描述符。它描述正在访问的服务。它是在 Web Services for J2EE 规范的第 7.2 节中定义的。使用 J2EE 1.4 生成的 Web Service 不会创建 webservicesclient.xml 文件，它会将客户机描述符信息放入 J2EE 部署描述符（例如，web.xml、ejb-jar.xml 和 application-client.xml）中。

ibm-webservicesclient-bnd.xmi 和 ibm-webservicesclient-ext.xmi

这些文件包含特定于 WebSphere 产品的部署信息，例如，安全性信息。在配置 Web Service 部署描述符中更详细地讨论了 WebSphere 部署描述符。

其他 JAX-RPC 绑定文件

简单对象访问协议（SOAP）和 WSDL 至 Java 的映射中支持客户机应用程序的其他 JAX-RPC 绑定文件是由 WSDL2Java 工具从 WSDL 生成的。

注意：仅当在容器管理的环境中运行 Web Service 客户机时才使用 webservicesclient.xml、ibm-webservicesclient-bnd.xmi 和 ibm-webservicesclient-ext.xmi，而在非受管环境中运行 Web Service 客户机时将不会使用这些文件。因此，只能从在容器管理的环境中运行的 Web Service 客户机中访问受保护的 Web Service，否则，必需的安全性信息对于客户机不可用。

局限性

下面列示了将 IBM WebSphere 运行时环境与 Web Service 一起使用时的局限性。

• IBM WebSphere Web Service 运行时环境不能处理使用缺省 Java 包的 Java bean。结果是在服务器启动期间将抛出异常并且 Web Service 在运行时不工作。
• 当使用 WebSphere 运行时环境从 Java bean 或 EJB 创建 Web Service 时，不要使用包名称以 Java 基本类型（例如，int、float 和 double）开头的复杂类型 bean。否则，生成的 WSDL 文件的模式可能会不正确地将复杂类型看作 Java 基本类型。
• WebSphere 运行时环境在处理具有不是按约定命名标识的 Java 类的方面能力有限。在从原始 bean 生成 WSDL 之后，WSDL 中的操作名称就是正确的。但是，在 WebSphere 从 WSDL 文件生成 bean 后，方法名称将被更改为小写以支持 Java 约定。Web Service 向导将废弃生成的框架并使用原始 bean。这将导致 bean 名称与 WSDL 文件不匹配。

  例如，如果 bean 方法名称是 BodyMassIndex，则部署描述符操作名称将是 bodyMassIndex（其中“b”是小写）以使其符合标准 Java 命名约定。

  有两种可能的解决方案：
  • 更改原始 bean 的方法名称。
  • 修改部署描述符并重新部署服务。除非熟悉 WebSphere 部署工具，否则建议不要使用这种解决方案。
• 对于 RPC 样式消息，不能混合 SOAP 编码与文字编码。但是，这是 DADX 将生成的 WSDL 文档。因此，不能正确地从使用 RPC 为 DADX Web Service 生成的 WSDL 文件来创建 WebSphere 客户机。要防止发生此问题，使用 DOC 样式创建 DADX Web Service。WebSphere 运行时环境可以在不产生问题的情况下从此 WSDL 创建客户机。要使用 DOC 样式 DADX Web Service，将 DADX 组的 group.properties 文件中的 useDocumentStyle 参数设置为 true。这也可以通过 DADX 组配置向导来完成。
• 在 WebSphere 运行时环境上部署 Web Service 之后，如果更改该 Web Service 使用的其中一个类，则可能不会刷新更改并且可能在服务器控制台中产生 ClassCastException。如果真的产生异常，则右键单击“服务器”视图中的服务器，选择重新启动项目，然后选择包含具有已更改类的项目的 EAR。
• 如果使用 WebSphere 运行时环境创建 Web Service 客户机，则客户机代理的 JNDI 查询在“通用测试客户机”中不起作用。因此，不会选择在客户机的部署描述符（包括 webservicesclient.xml、ibm-webservicesclient-ext.xmi 和 ibm-webservicesclient-bnd.xmi）中定义的客户机配置。此类客户机配置的一个示例是安全性。使用样本 JSP 而不是“通用测试客户机”来测试代理。
• 在 RPC/文字中不支持数组：当创建 RPC/文字服务时，方法特征符中不能包含数组。如果方法特征符包含数组，则不能使用生成的客户机代码调用服务。此问题当前没有变通方法。请尽可能尝试使用文档/文字。注意：这只会影响针对 WebSphere Application Server V5.x 的 Web Service，并不会影响使用 WebSphere Application Server V6.x 的 Web Service。
• WSDL 导入：WSDL import 语句只能具有绝对 URL 或同一目录中的相对 URL。例如，不支持以下格式的相对导入：<import namespace="http://someNamespace/" location="../someFile.wsdl"/>
• 当从 WSDL 文件（该文件使用没有任何缺省 JAX-RPC 映射的类型）生成 EJB 框架时，在用户尝试调用 Web Service 时将返回运行时异常。产生问题的原因是运行时对 javax.xml.soap.SOAPElement 进行反序列化有困难。java.xml.soap.SOAPElement 是在类型没有任何相关联的映射时使用的，因此，它被作为文档片段映射。注意：这只会影响针对 WebSphere Application Server V5.x 的 Web Service，并不会影响使用 WebSphere Application Server V6.x 的 Web Service。
• 如果使用具有输入输出参数的操作从 WSDL 文件生成 EJB 框架，在为 EJB 生成部署代码时将出现错误。产生问题的原因是输入输出参数被映射至 javax.xml.rpc.holders.Holder 类。因为 java.xml.rpc.holders.Holder 不实现 java.io.Serializable，所以它们将导致 EJB 部署错误。注意：这只会影响针对 WebSphere Application Server V5.x 的 Web Service，并不会影响使用 WebSphere Application Server V6.x 的 Web Service。