Criando Código Java Customizado

O código customizado utiliza referências no teste como entrada e retorna valores modificados ao teste. Use a interface ICustomCode2 para criar um código customizado e a interface ITestExecutionServices para estender a execução do teste. Essas interfaces estão contidas no pacote com.ibm.rational.test.lt.kernel.services.

Sobre Esta Tarefa

Nota: Ao utilizar a interface ITestExecutionServices no código customizado para reportar resultados do teste, os resultados do código customizado serão exibidos no log de teste. Se você registra vereditos de pontos de verificação, eles são refletidos no veredito geral do planejamento.

Os valores de entrada do código customizado estão localizados em referências ou em referências de campo. Você também pode transmitir uma sequência de texto como um argumento para customizar o código. As referências usadas como entrada para o código customizado devem estar incluídas no mesmo teste do código customizado. No teste, a referência deve preceder o código que ela afeta. Verifique se o teste contém as referências necessárias para entradas personalizadas em seu código. Para obter detalhes sobre como criar referências e referências de campo, consulte Criando uma Referência ou uma Referência de Campo.

Se seu código customizado usar arquivos JAR externos, poderá ser necessário alterar o caminho de construção Java™. Em alguns casos, é possível evitar a mudança do caminho de construção manualmente ao executar o teste antes de incluir nele o caminho customizado. A primeira vez que um teste é executado, as classes e bibliotecas necessárias para compilação são incluídas no caminho de construção. Por exemplo, você poderá importar as classes Test and Performance Tools Platform (TPTP) necessárias para criar eventos customizados no log de teste se o teste, no qual você incluiu o código customizado, tiver sido executado anteriormente. Entretanto, se o teste nunca tiver sido executado, ocorrerão erros de importação, visto que as classes não são nomeadas no caminho de construção para o projeto enquanto o teste não é executado.

Se o código utilizar recursos externos, por exemplo, um banco de dados SQL ou um produto que gerencie relacionamentos de cliente, o código customizado precisará ser configurado para funcionar em cada computador no qual o teste é executado.

O código customizado é salvo na pasta src do projeto que contém o teste que chama o código. Por padrão, o código customizado está localizado em um pacote chamado de test na pasta src.

É possível reutilizar um pacote de código customizado para testes localizados em vários projetos. Os projetos devem estar em uma área de trabalho. Para reutilizar código customizado em projetos, use o nome do projeto antes do pacote do código customizado. Por exemplo, campo Nome de Classe.

O exemplo a seguir mostra a visualização Navegador padrão de duas classes de código personalizado. (O Navegador de Teste não exibe os arquivos de origem Java.)

visualização Navegador com classes ReplaceCC.java e VerifyUserID.java

Quando você inclui as classes de código customizado ReplaceCC.java e VerifyYUserID.java no teste e um valor é retornado para o teste, Substituir lista essas duas classes.

O pacote de teste também contém o código Java gerado para testes no projeto.

Você pode colocar o código customizado em um pacote diferente (por exemplo, custom). Separe código personalizado de código gerado, especificamente se você utilizar um sistema de controle de origem.

Procedimento

Para incluir código customizado:

  1. Abra o teste e selecione um elemento de teste.
  2. Clique em Incluir ou em Inserir e selecione Código Customizado. Incluir anexa o código customizado ao final do elemento de teste selecionado. Inserir inclui o código customizado acima do elemento de teste selecionado.
    Nota: Após a inclusão ou inserção de código customizado, a visualização Problemas exibirá um erro indicando que o novo elemento de código customizado não tem nenhum arquivo Java. Essa mensagem de erro permanece até você clicar em Visualizar Código ou Gerar Código, para lembrá-lo que o elemento de teste de código customizado ainda não está associado a nenhum código Java.
  3. Examine o campo Nome da Classe e conclua uma das seguintes etapas:
    • Se o código que você deseja chamar já existir, altere o nome da classe para corresponder ao seu nome. Clique em Visualizar Código para abrir o código no editor Java.
    • Se o código não existir, altere o nome da classe para descrever o propósito do código. Clique em Gerar Código para gerar uma classe de modelo para registrar os resultados e abri-la no editor Java. Se houver uma classe com esse nome, você será alertado de que ela será sobrescrita.
  4. No campo Argumentos, clique em Incluir.
  5. Na janela Código Customizado, selecione todas as entradas que seu código requer. A janela Código Customizado lista todos os valores do teste os quais podem ser utilizados como entradas para o código (referências ou referências de campo no teste que precedem o código).
  6. Clique em OK. A janela é fechada, as referências selecionadas são incluídas no campo Argumentos.
  7. Opcional: Para incluir sequências de texto como entradas para seu código customizado, clique em Texto e digite a sequência de texto a ser usada.
  8. No teste, após o código customizado, localize um valor que o código retorna para o teste.
  9. Realce o valor.
  10. Clique com o botão direito do mouse no valor destacado, clique em Substituir e selecione o nome da classe de seu código customizado. As classes de código customizado que você incluiu são listadas. Depois de fazer sua seleção, o valor a ser retornado para o teste será realçado na cor laranja e a tabela Usado por será atualizada com essas informações.

O que Fazer Depois

O código customizado não é exibido na visualização Navegador de Teste. Para visualizar o código customizado, abra a visualização Package Explorer e use as ferramentas Java para identificar o código customizado que você incluiu.

Feedback