Criando uma Nova Configuração de Rotina de Tratamento JAX-RPC

Crie uma configuração de manipulador JAX-RPC para uso, como parte de uma lista de manipuladores, com os serviços da Web implementados pelo barramento de integração de serviços. As rotinas de tratamento monitoram as mensagens em portas e agem apropriadamente dependendo do emissor e do conteúdo de cada mensagem.

Antes de Iniciar

Esta tarefa considera que você já criou seu manipulador. É possível fazer isso usando o IBM® Rational Application Developerou uma ferramenta similar. Para obter informações adicionais, consulte o artigo do IBM developerWorks Support for J2EE Web Services in WebSphere Studio Application Developer V5.1 -- Part 3: JAX-RPC Handlers.

Você também deve disponibilizar a classe do manipulador para o servidor ou cluster que hospeda a porta para o serviço que deseja monitorar, conforme detalhado em Carregando Classes de Manipulador JAX-RPC.

Sobre Esta Tarefa

Um manipulador JAX-RPC (Java™ API for XML-based Remote Procedure Calls) é uma classe Java que executa uma variedade de tarefas de manipulação. Por exemplo, log de mensagens ou transformação de seu conteúdo ou encerramento de um pedido que chega. Para tornar o WebSphere Application Server ciente de seu manipulador e o manipulador disponível para inclusão em uma ou mais listas de manipuladores, use o console administrativo para criar uma nova configuração de manipulador.

Procedimento

  1. Na área de janela de navegação, clique em Integração de serviços -> Serviços da web -> Manipuladores JAX-RPC. É exibido o formulário de coleta de rotinas de tratamento JAX-RPC.
  2. Clique em Nova. É exibido o formulário de configurações de rotinas de tratamento JAX-RPC.
  3. Digite as seguintes propriedades gerais:
    Nome de ausente
    Digite o nome pelo qual a rotina de tratamento é conhecida.
    Esse nome deve ser exclusivo e obedecer as seguintes regras de sintaxe:
    • Não deve iniciar com "." (um ponto).
    • Não deve iniciar ou terminar com um espaço.
    • Não deve conter nenhum dos seguintes caracteres: \ / , # $ @ : ; " * ? < > | = + & % '
    Por exemplo, TestHandler.
    Description
    Digite a descrição (opcional) da rotina de tratamento.
    Nome da classe
    Digite o nome da classe que deve ser instanciada. Por exemplo, com.ibm.jaxrpc.handler.TestHandler.
    Nota: É possível configurar várias instâncias de um manipulador criando cada instância com um nome de manipulador diferente e apontando para a mesma classe de manipuladores.
  4. Clique em OK. As propriedades gerais para este item são salvas e as opções de propriedades adicionais são disponibilizadas.
  5. Digite as seguintes propriedades adicionais:
    Funções SOAP
    Inclua definições do agente SOAP na lista de funções SOAP nas quais esta rotina de tratamento age. Para obter informações adicionais, consulte A Especificação do SOAP.
    Cabeçalhos JAX-RPC
    Inclua definições de cabeçalhos JAX-RPC (URI de Espaço de Nomes e Parte Local) na lista de cabeçalhos JAX-RPC nos quais esta rotina de tratamento opera. Os cabeçalhos JAX-RPC são cabeçalhos SOAP que são processados por uma rotina de tratamento JAX-RPC.
    Propriedades Personalizadas
    Inclua propriedades personalizadas (pares de nome/valor, em que o nome é uma chave de propriedade e o valor é um valor de cadeia que pode ser utilizado para definir propriedades internas de configuração do sistema).
  6. Salve suas alterações na configuração principal.

Resultados

Se o processamento for concluído com êxito, a lista de rotinas de tratamento será atualizada para incluir a nova rotina de tratamento. Caso contrário, uma mensagem de erro é exibida.

O que Fazer Depois

Para utilizar esta rotina de tratamento, inclua-a na lista de rotinas de tratamento conforme descrito em Criando uma Nova Lista de Rotinas de Tratamento JAX-RPC ou Modificando uma Lista de Rotinas de Tratamento JAX-RPC Existente.

Í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=tjw_jaxrpc_handler_new
Nome do arquivo: tjw_jaxrpc_handler_new.html