J2EE 1.4 规范通过新的 JAX-RPC 1.0 API 添加了对 Web Service 的支持。
如 JSR-109 V1.0 所定义的那样,Web Service 部署描述符由文件 webservices.xml、webservicesclient.xml 及 webservices.xml 和 webservicesclient.xml 文件引用的所有 JAX-RPC 映射部署描述符组成。 与其它 J2EE 部署描述符一样,迁移会修改描述符中包含的信息的结构以使它们符合 J2EE 1.4 规范。对 Web Service 部署描述符来说比较特别的一个结构更改是对表示限定名的方式的更改。在 JSR-109 V1.0 中,限定名是使用两个元素(<namespaceURI> 和 <localpart>)的序列表示的,这两个元素分别包含名称空间 URI 和名称的本地部分。J2EE 1.4 中的限定名基于使用 XML 名称空间的 XMLSchema QName 类型。
webservices.xml 部署描述符出现在包含 J2EE Web Service 的 Web 项目和 EJB 项目中。<wsdl-port> 元素和 <soap-header> 元素都包含限定名并且它们的内容将迁移为 J2EE 1.4 格式。
webservices.xml 部署描述符出现在包含 J2EE Web Service 的 Web 项目中。<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”被用作所有已迁移限定名的名称空间前缀。
<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”被用作所有已迁移限定名的名称空间前缀。
webservices.xml 和 webservicesclient.xml 部署描述符都可以引用一个或多个 JAX-RPC 映射部署描述符。
在 webservices.xml 文件中,这些引用包含在每个 <webservice-description> 元素下面的 <jaxrpc-mapping-file> 元素中。在 webservicesclient.xml 文件中,这些引用包含在每个 <service-ref> 元素下面的 <jaxrpc-mapping-file> 元素中。
从 J2EE 1.3 到 1.4 的迁移期间,将迁移 webservices.xml 和 webservicesclient.xml 中引用的所有 JAX-RPC 映射部署描述符。迁移包括将所有限定名迁移为 J2EE 1.4 格式(有关迁移后限定名的示例,请参阅上面有关 webservices.xml 和 webservicesclient.xml 的小节)。