JBossWS では、SPI および Common コンポーネントがリファクタリングされました。下表は、アプリケーションの移行に影響する可能性がある API およびパッケージの変更を表しています。

JBossWS 3.4.x では、このアノテーションは JBossWS SPI JAR の org.jboss.wsf.spi.annotation.WebContext としてパッケージ化されていました。JBossWS 4.0 では、このアノテーションは JBossWS API JAR の org.jboss.ws.api.annotation.WebContext に移動されました。アプリケーションに廃止された依存関係が含まれている場合は、アプリケーションのソースコードのインポートおよび依存関係を置き換え、新しい JBossWS API JAR に対してコンパイルする必要があります。

また、後方互換性への非対応が変更になりました。String[] virtualHosts 属性が String virtualHost に変更になりました。JBoss EAP 6 では、デプロイメント毎に 1 つの仮想ホストのみを指定できます。複数の Web サービスが @WebContext アノテーションを使用する場合は、デプロイメントアーカイブに定義されるすべてのエンドポイントで virtualHost の値が同じになるようにする必要があります。

JBossWS 4.0 は、JBoss Web Services スタックと、ほとんどの Apache CXF モジュールとの統合を実現します。統合レイヤーにより、JAX-WS を含む標準の Web サービス API を使用できます。また、複雑な設定を必要とせずに、JBoss EAP 6 コンテナ上で Apache CFX の拡張機能を使用できます。

JBoss EAP 6 のドメイン設定にある webservice サブシステムには、事前定義されたエンドポイントの設定が含まれています。独自のエンドポイント設定を追加で設定することも可能です。指定のエンドポイント設定の参照には、@org.jboss.ws.api.annotation.EndpointConfig アノテーションを使用します。

JBoss サーバーで Web サービスエンドポイントを設定する方法の詳細は、https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ にある JBoss EAP 6 向け『開発ガイド』の章「JAX-WS Web サービス」を参照してください。

JBossWS 4.0 には、Web サービスを設定する新しいデプロイメント記述子が導入されました。jboss-webservices.xml ファイルが指定のデプロイメントの追加情報を提供し、廃止された jboss.xml ファイルを部分的に置き換えます。

EJB Web サービスデプロイメントでは、jboss-webservices.xml 記述子ファイルの想定される場所は META-INF/ ディレクトリー内になります。WAR ファイルでバンドルされた POJO および EJB Web サービスエンドポイントの想定される場所は、WEB-INF/ ディレクトリーの jboss-webservices.xml ファイル内になります。

以下に jboss-webservices.xml 記述子ファイルの例と、要素を説明する表を示します。

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