Les composants communs et SPI ont été refactorisés dans JBossWS 4. Le tableau suivant énumère les changements qui pourraient avoir un impact sur votre migration d'application.

Dans JBossWS 3.4.x, cette annotation a été empaquetée sous la forme org.jboss.wsf.spi.annotation.WebContext dans le JAR du SPI JBossWS. Dans JBossWS 4.0, cette annotation a été déplacée dans org.jboss.ws.api.annotation.WebContext dans le JAR de l'API JBossWS. Si votre application inclut la dépendance obsolète, vous devrez remplacer les importations et les dépendances dans le code source de votre application et le compiler avec le nouveau JAR de l'API JBossWS.

Il y a également un changement à un attribut non rétrocompatible. L'attribut String [] virtualHosts a été changé en String virtualHost. Dans JBoss EAP 6, vous ne pouvez spécifier qu'un seul hôte virtuel par déploiement. Si plusieurs services Web utilisent l'annotation @WebContext, la valeur de virtualHost doit être identique pour tous les points de terminaison définis dans l'archive de déploiement.

JBossWS 4.0 assure l'intégration de la pile de Services Web JBoss dans la plupart des modules d'Apache CXF. La couche d'intégration permet l'utilisation d'API de services Web standards, y compris JAX-WS. Il permet également l'utilisation des fonctionnalités avancées d'Apache CFX sur le conteneur de JBoss EAP 6, sans nécessiter d'installation ou de configuration complexe.

Le sous-système de webservice dans la configuration du domaine de JBoss EAP 6 inclut les configurations de points de terminaison prédéfinis. Vous pouvez également définir vos propres configurations de points de terminaison supplémentaires. L'annotation @org.jboss.ws.api.annotation.EndpointConfig est utilisée pour faire référence à une configuration de point de terminaison donné.

Pour plus d'informations sur la façon de configurer les points de terminaison du serveur JBoss, voir le chapitre intitulé JAX-WS Web Services dans le Guide développement de JBoss EAP 6 https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

JBossWS 4.0 introduit un nouveau descripteur de déploiement pour configurer des services web. Le fichier jboss-webservices.xml fournit des informations supplémentaires pour le déploiement donné et remplace partiellement le fichier obsolète jboss.xml.

Pour les déploiements du webservice EJB, l'emplacement du fichier descripteur jboss-webservices.xml attendu est dans le répertoire META-INF /. Pour les points de terminaison de service Web POJO et EJB regroupés dans le fichier WAR, l'emplacement prévu du fichier jboss-webservices.xml est dans le répertoire WEB-INF /.

Voici un exemple de fichier descripteur jboss-webservices.xml et un tableau décrivant les éléments.

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