La especificación J2EE 1.4 ha añadido soporte para los servicios Web mediante la nueva API JAX-RPC 1.0.
Los descriptores de despliegue de servicios Web, tal como están definidos en JSR-109 V1.0, constan de los archivos webservices.xml, webservicesclient.xml y de todos los descriptores de despliegue de correlación JAX-RPC a los que hagan referencia los archivos webservices.xml y webservicesclient.xml. Al igual que con los otros descriptores de despliegue J2EE, la migración modificará la estructura de la información contenida en los descriptores para que estén en conformidad con la especificación J2EE 1.4. Uno de los cambios estructurales que es específico de los descriptores de despliegue de servicios Web es el que se produce en la manera de representar los nombres calificados. En JSR-109 V1.0, los nombres calificados se representan mediante una secuencia de dos elementos, <namespaceURI> y <localpart>, los cuales contienen el URI del espacio de nombres y el componente local del nombre, respectivamente. En J2EE 1.4, los nombres calificados se basan en el tipo de nombre calificado del esquema XML, que utiliza espacios de nombres XML.
El descriptor de despliegue webservices.xml está presente en los proyectos Web y en los proyectos EJB que contienen servicios Web J2EE. El elemento <wsdl-port> y el elemento <soap-header> contienen, ambos, nombres calificados, y su contenido migrará al formato J2EE 1.4.
Por ejemplo, supongamos que, antes de la migración, <wsdl-port> viene representado de la siguiente manera:
<wsdl-port> <namespaceURI>http://addressbook.webservice</namespaceURI> <localpart>AddressBook</localpart> </wsdl-port>
Después de la migración, <wsdl-port> sería:
<wsdl-port xmlns:pfx="http://addressbook.webservice">pfx:AddressBook</wsdl-port>
En todos los nombres calificados que se migran, se utiliza "pfx" como prefijo del espacio de nombres.
El elemento <service-qname> y el elemento <soap-header> contienen, ambos, nombres calificados, y su contenido migrará al formato J2EE 1.4. Por ejemplo, supongamos que, antes de la migración, <service-qname> viene representado de la siguiente manera:
<service-qname> <namespaceURI>http://addressbook.webservice</namespaceURI> <localpart>AddressBookService</localpart> </service-qname>
Después de la migración, <service-qname> sería:
<service-qname xmlns:pfx="http://addressbook.webservice">pfx:AddressBookService</service-qname>
En todos los nombres calificados que se migran, se utiliza "pfx" como prefijo del espacio de nombres.
Los descriptores de despliegue webservices.xml y webservicesclient.xml pueden hacer referencia, ambos, a uno o más descriptores de despliegue de correlación JAX-RPC.
En el archivo webservices.xml, las referencias están en el elemento <jaxrpc-mapping-file> de cada elemento <webservice-description>. En el archivo webservicesclient.xml, las referencias están en el elemento <jaxrpc-mapping-file> de cada elemento <service-ref>.
Durante la migración de J2EE 1.3 a 1.4, migran todos los descriptores de despliegue de correlación JAX-RPC a los que se haga referencia en webservices.xml y webservicesclient.xml. En la migración, todos los nombres calificados migran al formato J2EE 1.4 (en los apartados anteriores sobre webservices.xml y webservicesclient.xml encontrará ejemplos de nombres calificados después de la migración).