SPI und Common Komponenten wurden in JBossWS 4 refakturiert. Die folgende Tabelle listet API und Verpackungsänderungen, die die Migration Ihrer Applikation beeinflussen können.

In JBossWS 3.4.x war diese Annotation als org.jboss.wsf.spi.annotation.WebContext in JBossWS SPI JAR verpackt. In JBossWS 4.0 wurde diese Annotation zum org.jboss.ws.api.annotation.WebContext im JBossWS API JAR verschoben. Wenn Ihre Applikation veraltete Abhängigkeiten beinhaltet, müssen Sie die Importe und Abhängigkeiten in Ihrem Applikations-Sourcecode ersetzen und das neue JBossWS API JAR kompilieren.

Es gibt auch eine Änderung an einem Attribut, das nicht rückwärts kompatibel ist. Das String[] virtualHosts-Attribut wurde zu String virtualHost geändert. In JBoss EAP 6 können Sie nur einen virtuellen Host pro Deployment festlegen. Falls mehrere Webdienste die @WebContext-Annotation verwenden, so muss der virtualHost-Wert für alle im Deployment-Archiv definierten Endpunkte identisch sein.

JBossWS 4.0 bietet Integration des JBoss Web Services Stacks mit den meisten Apache CXF Modulen. Die Integrationsebene ermöglicht die Nutzung von standardmäßigen Webdienst APIs, einschließlich JAX-WS. Sie ermöglicht Ihnen außerdem ohne komplexe Konfiguration oder Setup die Nutzung von Apache CFX erweiterten Features zusätzlich zu JBoss EAP 6 Container.

Das webservice-Untersystem in der Domain-Konfiguration der JBoss EAP 6 beinhaltet vordefinierte Endpunkt-Konfigurationen. Sie können auch Ihre eigenen, zusätzlichen Endpunkt-Konfigurationen definieren. Die @org.jboss.ws.api.annotation.EndpointConfig-Annotation wird zur Referenzierung einer gegebenen Endpoint-Konfiguration verwendet.

Weitere Informationen zur Konfiguration von Webdienst Endpunkten im JBoss Server finden Sie im Kapitel JAX-WS Webdienste im Entwicklungshandbuch für die JBoss EAP 6 unter https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.

JBossWS 4.0 führt einen neuen Deployment Deskriptor zur Konfiguration von Webdiensten ein. Die jboss-webservices.xml-Datei liefert zusätzliche Informationen zu dem gegebenen Deployment und ersetzt zum Teil die veraltete jboss.xml-Datei.

Für EJB Webdienst-Deployments ist der erwartete Speicherort für die jboss-webservices.xml-Deskriptordatei im META-INF/-Verzeichnis. Für in der WAR-Datei gebündelte POJO- und EJB-Wedienst Endpunkte ist der erwartete Speicherort der jboss-webservices.xml-Datei im WEB-INF/-Verzeichnis.

Nachfolgend sehen Sie ein Beispiel für eine jboss-webservices.xml-Deskriptordatei und eine Tabelle, die die Elemente beschreibt.

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