Os componentes Common e SPI foram reformulados no JBossWS 4. A tabela a seguir lista a API e as alterações de empacotamento que podem afetar a migração do seu aplicativo.

No JBossWS 3.4.x, esta anotação foi empacotada como org.jboss.wsf.spi.annotation.WebContext no JBossWS SPI JAR. No JBossWS 4.0, esta anotação foi movida para org.jboss.ws.api.annotation.WebContext no JBossWS API JAR. Caso o seu aplicativo inclua a dependência obsoleta, você deve substituir as importações e as dependências no código fonte do seu aplicativo e compilá-lo ao novo JBossWS API JAR.

Há também uma alteração de um atributo que não é compatível com versões anteriores. O atributo String[] virtualHosts foi alterado para String virtualHost. No JBoss EAP 6, você pode especificar apenas um host virtual por implantação. Se diversos serviços web usarem a anotação @WebContext, o valor do virtualHost deve ser idêntico a todos os pontos de extremidade definidos no arquivo de implantação.

O JBossWS 4.0 fornece uma integração da pilha dos Serviços Web JBoss com a maioria dos módulos do Apache CXF. A camada de integração permite o uso de APIs de serviços web padrões, incluindo JAX-WS. Ela também permite o uso dos recursos avançados do Apache CX na parte superior do contêiner do JBoss EAP 6 sem exigir instalação ou configuração complexa.

O subsistema webservice na configuração de domínio do JBoss EAP 6 inclui configurações do ponto de extremidade predefinidas. Você pode definir também as suas próprias configurações adicionais do ponto de extremidade. A anotação @org.jboss.ws.api.annotation.EndpointConfig é usada para fazer referência a uma dada configuração do ponto de extremidade.

Consulte o capítulo JAX-WS Web Services no Guia de Desenvolvimento (em inglês, Development Guide) para o JBoss EAP 6 em https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ para mais informações sobre como configurar os pontos de extremidade do serviço web no servidor JBoss.

O JBossWS 4.0 introduz um novo descritor de implantação para configurar os serviços web. O arquivo jboss-webservices.xml fornece informações adicionais para a implantação dada e substitui parcialmente o arquivo jboss.xml obsoleto.

Para as implantações do serviço web EJB, o local esperado do arquivo do descritor jboss-webservices.xml está no diretório META-INF/. Para os pontos de extremidade dos serviços web EJB e POJO agrupados no arquivo WAR, o local esperado do arquivo jboss-webservices.xml está no diretório WEB-INF/.

Segue um exemplo do arquivo de um descritor jboss-webservices.xml e uma tabela descrevendo os 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>