Configurando o Descritor de Implementação webservices.xml para Classes do Manipulador

É possível utilizar uma ferramenta de montagem para configurar o descritor de implementação webservices.xml para classes do manipulador fornecidas pelo usuário.

Antes de Iniciar

É possível configurar descritores de implementação com ferramentas de montagem fornecidas com o servidor de aplicativos.

Uma classe do manipulador é uma classe criada para modificar uma mensagem SOAP que representa um pedido ou resposta da RPC (Remote Procedure Call). Manipuladores podem ser associados com um serviço da Web ou um cliente de serviço da Web.

Similar à Java™ API para serviços da Web XML-based RPC (JAX-RPC), é possível usar descritores de implementação para descrever aJava API para serviços da Web XML Web Services (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.

Para concluir esta tarefa, é necessário um arquivo EAR (Enterprise Archive) para os aplicativos que você deseja configurar. Para algumas utilizações de manipuladores, tais como log ou rastreio, apenas o aplicativo servidor ou cliente exige configuração. Para outros usos de manipuladores, incluindo envio de informações nos cabeçalhos SOAP, os aplicativos cliente e servidor devem ser configurados com manipuladores simétricos.

Sobre Esta Tarefa

Os módulos no arquivo EAR contêm as classes do manipulador a serem configuradas. Essas classes implementam a interface javax.xml.rpc.handler.Handler. Para obter informações adicionais sobre como gravar classes de manipulador, consulte o capítulo 6 da especificação de Web Services for Java EE. Consulte o capítulo 9 na especificação JAX-WS ou o capítulo 12 na especificação JAX-RPC para obter informações adicionais sobre a estrutura do manipulador para seu modelo de programação. Os módulos de aplicativos devem conter o descritor de implementação webservices.xml. Consulte as especificações de serviços da Web e as informações sobre API para revisar a especificação JAX-RPC juntamente com uma lista completa dos padrões e especificações suportados.

Procedimento

  1. Inicie uma ferramenta de montagem. Leia sobre como iniciar a ferramenta de montagem nas informações do Rational Application Developer.
  2. Se você ainda não fez isso, configure a ferramenta de montagem para que ela funcione em módulos Java EE. Você precisa ter certeza de que as categorias Java EE e Web estejam ativadas. Leia sobre como configurar a ferramenta de montagem nas informações do Rational Application Developer.
  3. Migre os arquivos web application archive (WAR) que são criados com o Assembly Toolkit, Application Assembly Tool (AAT) ou uma ferramenta diferente da ferramenta do conjunto do Rational Application Developer. Para migrar os arquivos, importe seus arquivos WAR para a ferramenta de montagem. Leia sobre como migrar artefatos de código para uma ferramenta de montagem nas informações do Rational Application Developer.
  4. Configure o descritor de implementação do cliente. Leia sobre como configurar o descritor de implementação do cliente nas informações do Rational Application Developer.

Í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_atkddhandler
Nome do arquivo: twbs_atkddhandler.html