Visão Geral da Interface de Log de Resultados

Se seu código personalizado utiliza a interface IKLog para informar os resultados do teste, os resultados poderão ser inspecionados no histórico de execução do teste. Se você registra vereditos de pontos de verificação, eles são refletidos no veredito geral do planejamento.

A seguir, alguns exemplos do que pode ser feito com código personalizado:

Em seu código personalizado, você utiliza a interface IKLog para informar os resultados dos testes. Essa interface faz parte do pacote com.ibm.rational.test.lt.logging. Os métodos IKLog apresentam dois tipos:

Quando você inclui código personalizado em um teste, você vê o seguinte no editor de teste:
detalhes do elemento de teste com o nome de classe, os botões Visualizar Código e Gerar Código

Se você clicar em Generate Code (Gerar Código), será criada uma classe de código personalizado do gabarito na pasta src do projeto. Antes de gerar a classe de gabarito, você pode fornecer um nome de pacote diferente (recomendado, porque senão, o código personalizado residirá no mesmo pacote e teste do código de teste gerado) e um nome de classe que descreva a função executada pelo código. Ou você pode reutilizar o código personalizado existente digitando seu nome de pacote e de classe e, em seguida, abrir a classe clicando em View Code (Visualizar Código). Por exemplo, se você digitar test.custom.VerifyCustID como o nome do pacote e da classe, o código mostrado a seguir será gerado em src/test/custom/VerifyCustID.java e será aberto no editor Java.

package test.custom;

import com.ibm.rational.test.lt.kernel.logging.IKLog;

/**
 * @author unknown
 */
public class VerifyCustID implements
		com.ibm.rational.test.lt.kernel.custom.ICustomCode {

	/**
	 * Instances of this will be created using the no-arg constructor.
	 */
	public VerifyCustID() {
	}

	/**
	 * @see com.ibm.rational.test.lt.kernel.custom.ICustomCode#exec(IKLog, java.lang.String[])
	 */
	public String exec(IKLog log, String[] args) {
		return null;
	}

}

Por padrão, a visualização Test Navigator será aberta na perspectiva Teste. Normalmente, essa é a melhor visualização para a navegação de testes porque remove vários arquivos que não são relevantes para os testadores, incluindo o conteúdo da pasta src. Ao gravar código personalizado, talvez você queira abrir o Navigator padrão ou uma visualização de navegação Java, uma vez que isso permitirá a navegação direta pelo código. (É possível abrir código personalizado a partir do teste de chamada, selecionando-o e clicando no botão View (Visualizar).)

Suas instruções personalizadas de lógica e de log estão no bloco exec no final. Se você digitar log. dentro desse bloco e clicar em Ctrl-Espaço, o editor Java listará os métodos IKLog e exibirá os Javadoc correspondentes. Para manipular os valores de entrada do teste de chamada, opere na matriz args, que contém os argumentos que você designou ao incluir o código no teste: consulte Incluindo Código Personalizado, etapas 4-6. A instrução return retorna opcionalmente um valor ao teste de chamada.

Conforme ilustrado em Registrando uma Mensagem Simples, você pode gravar uma mensagem no histórico de execução com reportMessage diretamente. Os outros métodos requerem acesso a classes que criam objetos de eventos. Para obter acesso a elas, inclua uma ou mais destas instruções de importação:

import org.eclipse.hyades.test.common.event.ExecutionEvent
import org.eclipse.hyades.test.common.event.MessageEvent
import org.eclipse.hyades.test.common.event.VerdictEvent

Se você incluir código personalizado que contenha as instruções de importação acima em um teste que esteja localizado em um projeto no qual ainda não foi executado nenhum teste, poderão ser obtidos erros de importação. Entretanto, se pelo menos um teste do projeto tiver sido executado anteriormente, não serão obtidos erros. Isso acontece porque a execução de um teste inclui bibliotecas conhecidas requeridas para a execução, incluindo as classes denominadas nas instruções de importação, no caminho de construção do projeto.

A classe VerdictEvent é a mais apropriada para o código personalizado, porque os vereditos registrados no histórico de execução com o método reportVerificationPoint são refletidos no veredito transmitido/com falha do teste. O veredito de um planejamento será transmitido somente se todos os seus testes forem transmitidos ou se nenhum veredito for informado por nenhum teste. O exemplo Registrando um Evento de Veredito ilustra como criar e registrar um evento de veredito.

O editor de planejamento permite definir o nível de log do histórico de execução. A tabela a seguir mostra as configurações do editor e a literal IKLog equivalente.
Tabela 1.
Configuração do editor de planejamento Literal IKLog
Todos HISTORY_ALL
Nenhum HISTORY_NONE
Planejamento HISTORY_SCHEDULE
Página HISTORY_PAGES
Pedido HISTORY_REQUESTS

Com base nas configurações do editor de planejamento, os resultados serão removidos do histórico de execução. Portanto, é possível que um resultado registrado pelo código personalizado não apareça no histórico de execução. Utilize getHistoryLevel para obter a configuração de nível do histórico e wouldReportHistory para informar condicionalmente um resultado com base na configuração. (Se você executar um teste individual diretamente, a configuração será HISTORY_ALL.)

Termos de uso | Feedback
(C) Copyright IBM Corporation 2005. Todos os Direitos Reservados.