Incluindo Código Personalizado

Você pode ampliar um teste chamando código Java personalizado.

Seu código pode agir em um ou mais valores de entrada no teste e retornar valores modificados para o teste. Os valores de entrada do código personalizado residem em referências ou em referências de campo, que já deverão existir no teste. Referências ou referências de campo, que são entradas para seu código, devem aparecer em seqüência antes do código. Verifique se o teste contém as referências ou as referências de campo necessárias como entradas para o 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 personalizado utilizar arquivos JAR externos, você provavelmente precisará modificar o caminho de construção Java: consulte Visualizando e Editando o Caminho de Construção Java de um Projeto. Em alguns casos, é possível evitar a necessidade de modificação do caminho de construção manualmente pela execução de um teste antes de incluir o código personalizado no teste. Isso acontece porque na primeira vez que um teste é executado, determinadas classes e bibliotecas requeridas para compilação são incluídas no caminho de construção. Por exemplo, você poderá importar as classes Hyades necessárias para a criação de eventos personalizados no histórico de execução se o teste no qual você incluiu o código personalizado tiver sido executado anteriormente. Mas, se o teste nunca tiver sido executado anteriormente, você obterá erros de importação porque as classes não são nomeadas no caminho de construção do projeto até que o teste tenha sido executado.

O código pode utilizar recursos externos: por exemplo, um banco de dados SQL ou um produto Customer relationship management. Se for esse o caso, você deverá configurar o código personalizado para que funcione em todos os computadores nos quais seu teste foi implementado.

O código personalizado reside na pasta src do projeto que contém o(s) teste(s) que chama(m) o código. Por padrão, o código personalizado é colocado em um pacote chamado test (teste) dentro dessa pasta. Por exemplo, a figura a seguir mostra a visualização Navigator base de duas classes de código personalizado. (O Test Navigator não exibe arquivos de origem Java.)

Neste exemplo, se você incluir essas duas classes de código personalizado no teste e escolher retornar um valor para o teste (etapa 9), Substitute from (Substituir a partir de) listará essas duas classes da maneira mostrada na figura a seguir.

O pacote de test (teste) também contém o código Java gerado para testes no projeto. Mas, na etapa 3, você pode escolher colocar código personalizado em um pacote diferente (por exemplo, custom (personalizado)). A separação de código personalizado de gerado é recomendada, especialmente se você utiliza um sistema de controle de origem.

Para incluir código personalizado:

  1. Abra o teste e selecione um elemento (teste, página ou pedido).
  2. Clique em Add (Incluir) ou em Insert (Inserir) e selecione Custom Code (Código Personalizado). Add (Incluir) anexa o código personalizado ao final do elemento selecionado (teste ou página de teste). Insert (Inserir) inclui o código personalizado acima da página selecionada ou do pedido de página.
  3. Inspecione o campo Class name (Nome de Classe).
    • Se o código que você deseja chamar já existir, altere o nome de classe para corresponder a seu nome. Clicar em View Code (Visualizar Código) abre o código no editor Java.
    • Se o código não existir, altere o nome de classe para algo que sugira o objetivo do código. Clicar em Generate Code (Gerar Código) gera uma classe de gabarito para registrar os resultados e o abre no editor Java. Se uma classe com esse nome já existir, você será alertado que ela será sobrescrita e solicitado a verificar se é isso o que você deseja.
  4. Na caixa Arguments (Argumentos), clique em Add (Incluir). A caixa de diálogo Custom Code (Código Personalizado) é aberta listando todos os valores no teste que podem ser utilizados como entradas para o código (referências ou referências de campo no teste que estão seqüencialmente acima do código).
  5. Selecione todas as entradas necessárias para o código.
  6. Clique em OK. A janela é fechada, as referências selecionadas são incluídas na caixa Arguments (Argumentos) e a tabela Used by (Utilizada por) é atualizada com essas informações.
  7. No teste, seqüencialmente abaixo do código personalizado, localize um valor que seu código retorne para o teste.
  8. Realce o valor: com o botão esquerdo pressionado, arraste o mouse sobre ele.
  9. Clique com o botão direito do mouse no valor realçado, selecione Substitute from (Substituir a partir de) e selecione o nome de classe do código personalizado. Todas as classes de código personalizado incluídas no teste serão listadas. Depois de fazer sua seleção, a cor de realce do valor a ser retornado para o teste é alterada para laranja e a tabela Used by (Utilizada por) é atualizada com essas informações.
Termos de uso | Feedback
(C) Copyright IBM Corporation 2005. Todos os Direitos Reservados.