Red Hat Summit Red Hat SummitSuporteConsoleDesenvolvedoresComeçar um testeContato

3.2.4. Alterações dos Serviços da Web

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

O JBoss EAP 6 inclui suporte para a implantação dos pontos de extremidades do Serviço da Web JAX-WS. Este suporte é fornecido pelo JBossWS. Para maiores informações sobre os Serviços da Web, refira-se ao capítulo Serviços JAX-WS Web no Guia de Desenvolvimento para o JBoss EAP 6 no https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/.
O JBossWS 4 inclui as seguintes alterações que podem impactar sua migração.
Alterações do Projeto JBossWS API
Os componentes SPI e Comuns foram fabricados novamente no JBossWS 4. A seguinte tabela lista o API e as alterações de empacotamento que podem afetar a sua migração do aplicativo.
Expand
Tabela 3.7. Tamanho das Propriedades do Manuseador de Log
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
@WebContext Annotation
No JBossWS 3.4.x, esta anotação foi empacotada como org.jboss.wsf.spi.annotation.WebContext no projeto JBossWS SPI. No JBossWS 4.0, esta anotação foi movida ao org.jboss.ws.api.annotation.WebContext no projeto do JBossWS API. Caso o seu aplicativo incluir uma dependência, você deve substituir as importações e dependências no código de fonte do aplicativo e compilá-las em relação ao novo JBossWS API JAR.
Existe também uma mudança num 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. Caso diversos serviços da 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 integração da pilha dos JBoss Web Services com a maioria dos módulos do projeto Apache CXF. A camada de integração permite o uso de webservices APIs padrões, incluindo o JAX-WS. Isto permite também o uso dos recursos avançados do Apache CX na parte superior do contêiner do JBoss EAP 6 sem requerer montagem ou configuração complexa.
O subsistema webservice na configuração domain do JBoss EAP 6 inclui configurações do ponto de extremidade pré-definidos. Você pode definir também suas próprias configurações do ponto de extremidade adicional. A anotação @org.jboss.ws.api.annotation.EndpointConfig é usada para referenciar uma configuração do ponto de extremidade gerado.
Refira-se ao capítulo Serviços JAX-WS Web no Guia de Desenvolvimento do JBoss EAP 6 a partir do https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/ para maiores informações sobre este respeito.
jboss-webservices.xml Deployment Descriptor
O JBossWS 4.0 introduz um novo descritor de implantação para configurar os serviços da web. O arquivo jboss-webservices.xml fornece informação adicional para a implantação gerada e substitui parcialmente o arquivo jboss.xml obsoleto.
Para as implantações do EJB webservice, o local esperado para o arquivo do descritor jboss-webservices.xml está no diretório META-INF/. Para os pontos de extremidade do POJO e EJB webservice empacotados no arquivo WAR, o local esperado do arquivo jboss-webservices.xml está no diretório WEB-INF/.
Segue abaixo uma amostra do arquivo do 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.8. Descrição do Elemento do Arquivo jboss-webservice.xml
Nome do Elemento Descrição
context-root
Usado para personalizar a raiz do contexto da implantação dos webservices.
config-name
config-file
Usado para associar uma implantação do ponto de extremidade com uma configuração do ponto de extremidade gerado. As configurações do ponto de extremidade são especificadas no arquivo de configuração referenciados ou num subsistema webservices da configuração do domain.
propriedade
Usado para configurar os pares do valor do nome de propriedade simples para configurar o comportamento da pilha webservice.
port-component
Usado para personalizar o URI de destinação do ponto de extremidade ou para configurar as propriedades relacionadas com a segurança.
webservice-description
Usado para personalizar ou substituir o local publicado do webservice WSDL.
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