3.2.4. Cambios de los servicios web

SPI y los componentes comunes fueron refactorizados en JBossWS 4. La siguiente tabla lista los cambios de empaque y API que pueden afectar la migración de su aplicación.

En JBossWS 3.4.x, esta anotación se empacó como org.jboss.wsf.spi.annotation.WebContext en el proyecto JBossWS SPI. En JBossWS 4.0, esta anotación se movió a org.jboss.ws.api.annotation.WebContexten el proyecto JBossWS API. Si su aplicación incluye la dependencia obsoleta entonces tiene que reemplazar las importaciones y las dependencias en su código fuente de la aplicación y compilarlo frente a la nueva JAR JBossWS API.

También hay un cambio en un atributo que no es retroactivo. El atributo String[] virtualHosts se cambió a String virtualHost. En JBoss EAP 6 se puede especificar solo un host virtual por implementación. Si múltiples webservices usan la anotación @WebContext entonces el valor virtualHost debe ser idéntico para todos los puntos finales definidos en el archivador de implementación.

JBossWS 4.0 proporciona integración de la pila de servicios web JBoss con la mayoría de los módulos del proyecto Apache CXF. La capa de integración permite el uso de APIs de servicios web estándares, incluyendo JAX-WS. También permite el uso de funcionalidades avanzadas de Apache CFX por encima del contenedor JBoss EAP 6 sin requirir una configuración compleja.

El subsistema webservice en la configuración de dominio de JBoss EAP 6 incluye configuraciones del punto final predefinidas. También puede definir sus propias configuraciones de punto final predefinidas. La anotación @org.jboss.ws.api.annotation.EndpointConfig se utiliza para hacer referencia a una configuración de punto final dada.

Para obtener mayor información sobre cómo configurar puntos finales de servicios web en el servidor JBoss, consulte el capítulo titulado JAX-WS Web Services en la Guía de desarrollo para JBoss EAP 6 en https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

JBossWS 4.0 introduce un nuevo descriptor de implementación para configurar servicios web. El archivo jboss-webservices.xml proporciona información adicional para la implementación dada y reemplaza parcialmente el archivo obsoleto jboss.xml.

Para las implementaciones de servicios web EJB, la ubicación esperada del archivo descriptor jboss-webservices.xml es en el directorio META-INF/. Para los puntos finales del servicio web EJB y POJO agrupados en un archivo WAR, la ubicación esperada del archivo jboss-webservices.xml es en el directorio WEB-INF/.

El siguiente es un ejemplo de un archivo descriptor jboss-webservices.xml y una tabla describiendo los elementos.

<webservices>
    <context-root>foo<context-root>    
    <config-name>Standard WSSecurity Endpoint</config-name>
    <config-file>META-INF/custom.xml</config-file>
    <property>
        <name>prop.name</name>
        <value>prop.value</value>
    </property>
    <port-component>
        <ejb-name>TestService</ejb-name>
        <port-component-name>TestServicePort</port-component-name>
        <port-component-uri>/*</port-component-uri>
        <auth-method>BASIC</auth-method>
        <transport-guarantee>NONE</transport-guarantee>
        <secure-wsdl-access>true</secure-wsdl-access>
    </port-component>
    <webservice-description>
        <webservice-description-name>TestService</webservice-description-name>
        <wsdl-publish-location>file:///bar/foo.wsdl</wsdl-publish-location>
    </webservice-description>
</webservices>