Testando um Nó Definido pelo Usuário

Quando você tiver criado e instalado os recursos necessários, poderá testar o seu nó definido pelo usuário.

Antes de começar

Conclua as seguintes tarefas:

  1. Ative o ambiente de Desenvolvimento de Plug-in do Eclipse. Esta tarefa é descrita em Ativando Capacidades do Tempo de Execução do PDE. Para obter informações adicionais sobre o PDE e a Perspectiva de Desenvolvimento de Plug-in, consulte o Guia PDE.
  2. Clique em Executar (Run) > Executar como (Run as) > Ambiente de Trabalho de Tempo de Execução (Runtime Workbench) para iniciar uma nova cópia do ambiente de trabalho que inclui seus novos nós.
  3. Abra o editor Fluxo de Mensagens. Seus novos nós aparecem na paleta do nó.
  4. Crie um fluxo de mensagens que inclua seu nó. Leia Incluindo um Nó do Fluxo de Mensagens para obter orientação sobre como concluir essa tarefa.
  5. Implemente o fluxo de mensagens em um intermediário. Esta tarefa é descrita em Implementando um Aplicativo do Fluxo de Mensagens.
  6. Envie uma mensagem de teste por meio do fluxo e procure pelos resultados esperados (por exemplo, uma mensagem colocada em uma fila de destino). Pode ser necessário gravar um aplicativo para enviar a mensagem de teste para o fluxo de mensagens.
  7. Utilize as ferramentas de diagnóstico fornecidas para determinar se o nó funciona, ou se não, o que aconteceu de errado:
    1. Consulte Resolvendo Problemas com Extensões Definidas pelo Usuário para obter uma descrição de alguns problemas comuns e suas soluções.
    2. Verifique o log de eventos. Os detalhes são fornecidos em Editor de Registro de Eventos.
    3. Grave as entradas no log de eventos a partir de seu nó. Consulte a seção Utilizando Registro de Eventos a partir de uma Extensão Definida pelo Usuário para obter informações adicionais.
    4. Ative o rastreio do usuário no nível de depuração. Consulte Utilizando o Rastreio para obter detalhes sobre como concluir essa tarefa.

      As seguintes mensagens de depuração são geradas por um rastreio do usuário para ajudá-lo a compreender a execução de seus nós e analisadores definidos pelo usuário:

      • BIP2233 e BIP2234: um par de mensagens rastreadas antes e depois da chamada de uma função de implementação de extensão definida pelo usuário. Essas mensagens informam os parâmetros de entrada e o valor retornado.

        Nessas mensagens, uma "função de implementação" pode ser interpretada como uma função de implementação C ou um método de implementação Java.

      • BIP3904: uma mensagem rastreada antes de chamar o método Java evaluate() de um nó definido pelo usuário.
      • BIP3905: Uma mensagem rastreada antes de chamar a função de implementação CcniEvaluate() (membro iFpEvaluate de CNI_VFT) de um nó definido pelo usuário.
      • BIP4142: uma mensagem de depuração rastreada durante a chamada de uma função de utilitário do nó definido pelo usuário, onde a função de utilitário altera o estado de um elemento de sintaxe. Todas as funções de utilitário iniciadas por cniSetElement*, onde * representa todos os nós com essa base, são incluídas.
      • BIP4144 e BIP4145: um par de mensagens rastreado por determinadas funções de implementação que, quando chamadas por uma extensão definida pelo usuário, podem modificar o estado interno de um objeto do intermediário de mensagens. Os objetos possíveis do intermediário incluem elemento, nó ou analisador de sintaxe.

        Nessas mensagens, uma "função de implementação" pode ser interpretada como uma função de implementação C ou um método de implementação Java.

      • BIP4146: uma mensagem de depuração rastreada durante a chamada de uma função de utilitário do analisador definido pelo usuário, onde a função de utilitário altera o estado de um elemento de sintaxe. Todas as funções de utilitário iniciadas por cpiSetElement*, onde * representa todos os nós com essa base, são incluídas.
      • BIP4147: uma mensagem de erro que é rastreada, quando uma extensão definida pelo usuário transmite um objeto de entrada inválido para uma função da API do utilitário de extensão definido pelo usuário.
      • BIP4148: uma mensagem de erro que é rastreada, quando uma extensão definida pelo usuário danifica um objeto do intermediário.
      • BIP4149: uma mensagem de erro que é rastreada, quando uma extensão definida pelo usuário transmite um ponteiro de dados de entrada inválido para uma função API do utilitário de extensão definido pelo usuário.
      • BIP4150: uma mensagem de erro rastreada quando uma extensão definida pelo usuário transmite dados de entrada inválidos para uma função de API do utilitário de extensão definido pelo usuário.
      • BIP4151: uma mensagem de depuração rastreada quando cniGetAttribute2 ou cniGetAttributeName2 configura o código de retorno para um valor inesperado. Os valores esperados são CCI_SUCCESS, CCI_ATTRIBUTE_UNKNOWN e CCI_BUFFER_TOO_SMALL. Qualquer outro valor é um valor inesperado.
      • BIP4152: uma mensagem de depuração que é rastreada nas seguintes situações:
        1. cniGetAttribute2 ou cniGetAttributeName2 configura o código de retorno para CCI_BUFFER_TOO_SMALL.
        2. cniGetAttribute2 ou cniGetAttributeName2 é chamado novamente com o buffer de tamanho correto, no entanto, o código de retorno é configurado para CCI_BUFFER_TOO_SMALL.
    5. Inclua um nó Trace em seu fluxo de mensagens e verifique a saída que é gerada.
    6. Utilize o depurador de fluxo para depurar o fluxo que contém o nó. Inicie com Testando e Depurando Aplicativos do fluxo de mensagens.

Quando o comportamento de seu nó estiver completo e correto, inclua o novo nó na paleta normal de nós no editor de Fluxo de Mensagens (consulte Empacotando um Projeto do ambiente de trabalho de Nó Definido pelo Usuário). Até fazer isso, os novos nós estão disponíveis somente na sessão de teste do ambiente de trabalho em seu sistema local.

Conceitos relacionados
Nós de Entrada Definidos pelo Usuário
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário
Tarefas relacionadas
Desenvolvendo Extensões Definidas pelo Usuário
Incluindo um Nó do Fluxo de Mensagens
Testando e Depurando Aplicativos do fluxo de mensagens
Resolvendo Problemas com Extensões Definidas pelo Usuário
Empacotando um Projeto do ambiente de trabalho de Nó Definido pelo Usuário
Referências relacionadas
Editor de Registro de Eventos
Nó Trace
Extensões Definidas pelo Usuário
API do Nó Definido pelo Usuário de Linguagem C
API do Analisador Definido pelo Usuário de Linguagem C
Informações relacionadas
API de Extensões Definidas pelo Usuário Java
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:06

as04505_