Ativando a cobertura de código a partir da linha de comandos

Para verificar se o código corresponde aos seus critérios de aceitação de cobertura de código especificados, é possível ativar a cobertura de código a partir da linha de comandos. Para fazer isso, é necessário:

• Configurar seu CLASSPATH para ativar a cobertura de código
• Execute o script de instrumentação de cobertura de código

Também é possível gerar relatórios de cobertura de código a partir de fora do ambiente de trabalho e desativar a cobertura de código a partir da linha de comandos.

Configure seu CLASSPATH para ativar a cobertura de código

Para configurar seu CLASSPATH para ativar a cobertura de código, defina as seguintes variáveis de ambiente CLASSPATH:

• ECLIPSE_HOME - O diretório de instalação para o eclipse. Se não definido, esta variável de ambiente é o padrão para o diretório de instalação padrão do Rational.
• JAVA_HOME - O diretório de instalação para o Java. <JAVA_HOME>/bin deve conter java.exe. Se não definido, esta variável de ambiente é o padrão para o diretório do RAD JRE padrão.

Execute o script de instrumentação de cobertura de código

No Windows, o script de instrumentação é instrument.bat; no Linux, instrument.sh.

O formato do script de instrumentação é:

instrument.bat/sh -in <src-input-directory> [-baseline <baseline-file>] [-saveBackup] [-verbose] [-output <output-dir>]

em que:

in:

Especifica a lista de "caminho separado" dos diretórios que contêm os arquivos de classe que devem ser instrumentados. O separador de caminho depende do sistema operacional (um ponto-e-vírgula ";" no Windows e dois-pontos ":" no Linux).

baseline:

Especifica o caminho no qual o arquivo de linha de base está armazenado. Utilize apenas se pretender gerar relatórios de cobertura de código de fora do ambiente de trabalho. O arquivo de linha de base é o arquivo em relação ao qual o código instrumentado é comparado e as estatísticas de cobertura de código são geradas. Ele serve como entrada para o gerador de relatórios de cobertura de código.

saveBackup:

Especifica se a classe original e os arquivos jar devem ser renomeados para *.bak. Incluir a opção saveBackup gerará os arquivos de backup; omitir a opção resultará na substituição (e, portanto, perda) dos arquivos originais.

verbose:

Especifica se as mensagens informativas devem ser impressas.

output:

Especifica o diretório de saída no qual os arquivos instrumentados devem ser armazenados; caso contrário, os arquivos instrumentados são armazenados no diretório de entrada.

Exemplo 1

No exemplo a seguir, a cobertura de código é ativada para os arquivos nos diretórios Windows C:\java_code e C:\java_tests e nenhum backup é gerado para esses arquivos. O arquivo de linha de base é armazenado em C:\llc\coverage_reports, as mensagens informativas são impressas e os arquivos de saída são armazenados em C:\instrumented_files

instrument.bat -in C:\java_code;C:\java_tests -baseline C:\llc\coverage_reports -verbose -output C:\instrumented_files

Exemplo 2

No exemplo a seguir, a cobertura de código é ativada para os arquivos nos diretórios Linux C:\java_source e C:/testcase_source e são gerados backups para esses arquivos. Nenhum arquivo de linha de base é criado, nenhuma mensagem informativa é impressa e os arquivos de saída são armazenados em C:/instrumented_files

instrument.sh -in /java_source:/testcase_source -saveBackup -output /instrumented_files

Gerando relatórios de cobertura de código de fora do ambiente de trabalho

Consulte Gerando relatórios de cobertura de código

Desativando a cobertura de código a partir da linha de comandos

Para desativar as classes instrumentadas a partir da linha de comandos, recompile o projeto ou substitua os arquivos .class pelos arquivos .class.bak, se saveBackup foi ativado.

(C) Copyright IBM Corporation 2007, 2008. Todos os direitos reservados.