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