Web Service(J2EE 1.3 到 J2EE 1.4)

J2EE 1.4 规范通过新的 JAX-RPC 1.0 API 添加了对 Web Service 的支持。

JAX-RPC API 通过下列内容支持服务端点: J2EE 1.4 规范支持 J2EE 规范(JSR 109)的 Web Service。JSR 109 定义 Web Service 的部署需求并使用 JAX-RPC 编程模型。
使用 J2EE 迁移向导迁移的 Web Service 工件如下:
  • Web Service 描述符
  • Web Service 客户机描述符
  • JAX-RPC 映射描述符

迁移 Web Service 部署描述符

J2EE 1.3 项目中包含的要迁移到 J2EE 1.4 规范级别的任何 Web Service 部署描述符都将从 JSR-109 V1.0(J2EE 1.3)迁移到 J2EE 1.4。

如 JSR-109 V1.0 所定义的那样,Web Service 部署描述符由文件 webservices.xmlwebservicesclient.xmlwebservices.xmlwebservicesclient.xml 文件引用的所有 JAX-RPC 映射部署描述符组成。 与其它 J2EE 部署描述符一样,迁移会修改描述符中包含的信息的结构以使它们符合 J2EE 1.4 规范。对 Web Service 部署描述符来说比较特别的一个结构更改是对表示限定名的方式的更改。在 JSR-109 V1.0 中,限定名是使用两个元素(<namespaceURI><localpart>)的序列表示的,这两个元素分别包含名称空间 URI 和名称的本地部分。J2EE 1.4 中的限定名基于使用 XML 名称空间的 XMLSchema QName 类型。

下面提供了有关迁移每个 Web Service 部署描述符的更多详细信息。
  • Web Service 描述符(webservices.xml

    webservices.xml 部署描述符出现在包含 J2EE Web Service 的 Web 项目和 EJB 项目中。<wsdl-port> 元素和 <soap-header> 元素都包含限定名并且它们的内容将迁移为 J2EE 1.4 格式。

    例如,如果迁移前 <wsdl-port> 的表示如下所示,

    <wsdl-port>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBook</localpart>
    </wsdl-port>

    迁移后 <wsdl-port> 将显示为:

    <wsdl-port xmlns:pfx="http://addressbook.webservice">pfx:AddressBook</wsdl-port>

    前缀“pfx”被用作所有已迁移限定名的名称空间前缀。

  • Web Service 客户机描述符(webservicesclient.xml
    webservicesclient.xml 部署描述符出现在包含 J2EE Web Service 客户机的 J2EE 1.3 Web 项目、EJB 项目和应用程序客户机项目中。从 J2EE 1.3 到 1.4 的迁移期间,webservicesclient.xml 的内容被迁移并且移动到项目的部署描述符中。发生的流程如下所示:
    • 对于 Web 项目,webserivcesclient.xml 中的所有 <service-ref> 元素都移动到 web.xml 中的 <web-app> 元素下面。
    • 对于应用程序客户机项目,webservicesclient.xml 中的所有 <service-ref> 元素都移动到 application-client.xml 中的 <application-client> 元素下面。
    • 对于 EJB 项目,webserviceclient.xml 中的 <component-scoped-refs> 内的所有 <service-ref> 元素都移动到 ejb-jar.xml 中相应的 <enterprise-bean> 下面。
    • 将删除 Webservicesclient.xml

    <service-qname> 元素和 <soap-header> 元素都包含限定名并且它们的内容将迁移为 J2EE 1.4 格式。例如,如果迁移前 <service-qname> 的表示如下所示,

    <service-qname>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBookService</localpart>
    </service-qname>

    迁移后 <service-qname> 将显示为:

    <service-qname xmlns:pfx="http://addressbook.webservice">pfx:AddressBookService</service-qname>

    前缀“pfx”被用作所有已迁移限定名的名称空间前缀。

  • JAX-RPC 映射描述符

    webservices.xmlwebservicesclient.xml 部署描述符都可以引用一个或多个 JAX-RPC 映射部署描述符。

    webservices.xml 文件中,这些引用包含在每个 <webservice-description> 元素下面的 <jaxrpc-mapping-file> 元素中。在 webservicesclient.xml 文件中,这些引用包含在每个 <service-ref> 元素下面的 <jaxrpc-mapping-file> 元素中。

    从 J2EE 1.3 到 1.4 的迁移期间,将迁移 webservices.xmlwebservicesclient.xml 中引用的所有 JAX-RPC 映射部署描述符。迁移包括将所有限定名迁移为 J2EE 1.4 格式(有关迁移后限定名的示例,请参阅上面有关 webservices.xmlwebservicesclient.xml 的小节)。

相关任务
迁移安全 Web Service
相关参考
Enterprise JavaBean 项目(EJB 2.0 到 EJB 2.1)
Web 项目(Servlet 级别 2.3 到 Servlet 级别 2.4)
连接器项目(JCA 1.0 到 JCA 1.5)
J2EE 1.3 到 1.4 规范级别迁移
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.