Red Hat Summit Red Hat SummitSuporteConsoleDesenvolvedoresComeçar um testeContato

3.2.4. Alterações dos Serviços Web

3.2.4.1. Alterações dos Serviços Web
Copiar o link

O JBoss EAP 6 inclui suporte para a implantação dos pontos de extremidade do Serviço Web JAX-WS. Este suporte é fornecido pelo JBossWS. Para mais informações sobre os Serviços Web, consulte o capítulo Serviços Web JAX-WS no Guia de Desenvolvimento para o JBoss EAP 6 em https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.
O JBossWS 4 inclui as seguintes alterações que podem impactar a sua migração.
Alterações JBossWS API
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.
Expand
Tabela 3.8. Alterações JBossWS API
JAR Antigo Pacote Antigo Novo JAR Novo Pacote
JBossWS SPI org.jboss.wsf.spi.annotation.* JBossWS API org.jboss.ws.api.annotation.*
JBossWS SPI org.jboss.wsf.spi.binding.* JBossWS API org.jboss.ws.api.binding.*
JBossWS SPI org.jboss.wsf.spi.management.recording.* JBossWS API org.jboss.ws.api.monitoring.*
JBossWS SPI org.jboss.wsf.spi.tools.* JBossWS API org.jboss.ws.api.tools.*
JBossWS SPI org.jboss.wsf.spi.tools.ant.* JBossWS API org.jboss.ws.tools.ant.*
JBossWS SPI org.jboss.wsf.spi.tools.cmd.* JBossWS API org.jboss.ws.tools.cmd.*
JBossWS SPI org.jboss.wsf.spi.util.ServiceLoader JBossWS API org.jboss.ws.api.util.ServiceLoader
JBossWS Common org.jboss.wsf.common.* JBossWS API org.jboss.ws.common.*
JBossWS Common org.jboss.wsf.common.handler.* JBossWS API org.jboss.ws.api.handler.*
JBossWS Common org.jboss.wsf.common.addressing.* JBossWS API org.jboss.ws.api.addressing.*
JBossWS Common org.jboss.wsf.common.DOMUtils JBossWS API org.jboss.ws.api.util.DOMUtils
JBossWS Native org.jboss.ws.annotation.EndpointConfig JBossWS API org.jboss.ws.api.annotation.EndpointConfig
JBossWS Framework org.jboss.wsf.framework.invocation.RecordingServerHandler JBossWS Common org.jboss.ws.common.invocation.RecordingServerHandler
Anotação @WebContext
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.
Configuração do Ponto de Extremidade
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.
jboss-webservices.xml Descritor de Implantação
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>
Copy to Clipboard Toggle word wrap
Expand
Tabela 3.9. Descrição do Elemento do Arquivo jboss-webservice.xml
Nome do Elemento Descrição
contexto-raiz
Usado para personalizar a raiz de contexto da implantação dos serviços web.
nome de configuração
arquivo de configuração
Usado para associar uma implantação do ponto de extremidade com uma dada configuração do ponto de extremidade. As configurações do ponto de extremidade são especificadas no arquivo de configuração referenciado ou no subsistema webservices da configuração de domínio.
propriedade
Usado para configurar pares de valor de nome de propriedade simples para configurar o comportamento de pilha do serviço web.
porta-componente
Usado para personalizar o URI de destino do ponto de extremidade EJB ou para configurar as propriedades relacionadas com a segurança.
descrição do serviço web
Usado para personalizar ou substituir o local publicado WSDL do serviço web.
Reportar um erro
Voltar ao topo
Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2025 Red Hat