Servicios Web (de J2EE 1.3 a J2EE 1.4)

La especificación J2EE 1.4 ha añadido soporte para los servicios Web mediante la nueva API JAX-RPC 1.0.

La API JAX-RPC da soporte a los puntos finales de servicio mediante: La especificación J2EE 1.4 da soporte a los servicios Web correspondientes a la especificación J2EE (JSR 109). JSR 109 define los requisitos de despliegue de los servicios Web y utiliza el modelo de programación JAX-RPC.
Los artefactos de servicios Web que migran mediante el asistente de migración J2EE son:
  • Descriptor de servicios Web
  • Descriptor de cliente de servicios Web
  • Descriptor de correlación de JAX-RPC

Migrar descriptores de despliegue de servicios Web

Los descriptores de despliegue de servicios Web que estén contenidos en proyectos de J2EE 1.3 migrados al nivel de especificación J2EE 1.4 migrarán de JSR-109 V1.0 (para J2EE 1.3) a J2EE 1.4.

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.

A continuación se dan más detalles sobre la migración de cada uno de los descriptores de despliegue de servicios Web.
  • Descriptor de servicios Web (webservices.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.

  • Descriptor de cliente de servicios Web (webservicesclient.xml)
    En J2EE 1.3, el descriptor de despliegue webservicesclient.xml está presente en los proyectos Web, proyectos EJB y proyectos de cliente de aplicaciones que contienen clientes de servicios Web J2EE. Durante la migración de J2EE 1.3 a 1.4, el contenido de webservicesclient.xml migra y se traslada al descriptor de despliegue del proyecto. El proceso que se produce es el siguiente:
    • En el caso de los proyectos Web, todos los elementos <service-ref> de webserivcesclient.xml se trasladan al elemento <web-app> de web.xml.
    • En el caso de los proyectos de cliente de aplicaciones, todos los elementos <service-ref> de webservicesclient.xml se trasladan al elemento <application-client> de application-client.xml.
    • En el caso de los proyectos EJB, todos los elementos <service-ref> que haya en un elemento <component-scoped-refs> de webserviceclient.xml se trasladan al correspondiente elemento <enterprise-bean> de ejb-jar.xml.
    • El descriptor webservicesclient.xml se suprime.

    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.

  • Descriptor de correlación JAX-RPC

    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).

Tareas relacionadas
Migrar servicios Web seguros
Referencia relacionada
Proyectos Enterprise JavaBean (de EJB 2.0 a EJB 2.1)
Proyectos Web (del nivel Servlet 2.3 al nivel Servlet 2.4)
Proyectos de conector (de JCA 1.0 a JCA 1.5)
Migración del nivel de especificación J2EE 1.3 al nivel de especificación J2EE 1.4
Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.