Desenvolvendo um Descritor de Implementação webservices.xml para Aplicativos JAX-WS

Os descritores de implementação são arquivos de texto padrão, formatados utilizando XML e empacotados em um aplicativo de serviços da Web. Opcionalmente, é possível usar o descritor de implementação webservices.xml para aumentar ou substituir os metadados do aplicativo especificados em anotações dentro dos seus serviços da Web Java™ API for XML-Based Web Services (JAX-WS).

Sobre Esta Tarefa

Similar à Java API para serviços da Web XML-based RPC (JAX-RPC), é possível usar descritores de implementação para descrever serviços da Web JAX-WS. Para serviços da web JAX-WS, o uso do descritor de implementação webservices.xml é opcional porque é possível usar anotações para especificar todas as informações que estão contidas dentro do arquivo do descritor de implementação. É possível utilizar o arquivo do descritor de implementação para aumentar ou substituir anotações JAX-WS existentes. Qualquer informação definida no descritor de implementação webservices.xml substitui quaisquer informações correspondentes especificadas pelas anotações.

Um serviço da Web JAX-WS necessita que você anote a sua classe Java com a anotação javax.jws.WebService ou a anotação javax.jws.WebServiceProvider para terminais do Provedor. É possível utilizar descritores de implementação do servidor para substituir atributos correspondentes da anotação ou aprimorar as informações nas anotações. Existe um relacionamento definido entre os elementos do descritor de implementação e as anotações @WebService e @WebServiceProvider. Consulte a seção 5.3 na especificação Web Services for Java EE (Java Platform, Enterprise Edition), Versão 1.2 para obter informações detalhadas a respeito dos elementos do descritor de implementação e o mapeamento para os atributos de anotação @WebService e @WebServiceProvider. Também existem elementos no descritor de implementação webservice.xml que é mapeado para outras anotações. Por exemplo, o elemento do descritor de implementação <protocol-binding> é mapeado para a anotação @BindingType, e o elemento do descritor de implementação <enable-mtom> é mapeado para a anotação @MTOM. Para obter informações adicionais quanto aos elementos do descritor de implementação dos serviços da Web, consulte a seção 7.1 em Serviços da Web para especificaçãoJava Platform, Enterprise Edition (Java EE).

Procedimento

Utilize as ferramentas de montagem para gerar o descritor de implementação webservice.xml.

Resultados

Você possui modelos de descritor de implementação que pode utilizar para substituir atributos de anotação JAX-WS ou especificar atributos não definidos pela anotação.

Exemplo

No exemplo a seguir, a classe de implementação de serviço para um serviço da Web JAX-WS inclui a anotação @WebService:
@WebService(wsdlLocation=”http://myhost.com/location/of/the/wsdl/ExampleService.wsdl”)
O descritor de implementação webservices.xml associado especifica um nome de arquivo diferente para o documento WSDL da seguinte maneira:
<webservices>
<webservice-description>
<webservice-description-name>ExampleService</webservice-description-name>
<wsdl-file>META-INF/wsdl/ExampleService.wsdl</wsdl-file>
…
</webservice-description>
</webservices>
O valor que é especificado no descritor de implementação, META-INF/wsdl/ExampleService.wsdl, substitui o valor da anotação.

O que Fazer Depois

Configure o descritor de implementação webservice.xml. Depois de configurar os descritores de implementação, é preciso montar o aplicativo de serviços da Web para implementação.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxwsdeploydescriptor
Nome do arquivo: twbs_jaxwsdeploydescriptor.html