Abilitazione della copertura codice dalla riga di comando

Per verificare che il codice soddisfi i criteri di accettazione della copertura del codice specificati, abilitare la copertura del codice da riga di comando. A tale scopo, è necessario eseguire le seguenti operazioni:

• Configurazione di CLASSPATH per abilitare la copertura del codice
• Esecuzione dello script di strumentazione di copertura del codice

È possibile anche generare report di copertura del codice esternamente al workbench e disabilitare la copertura del codice dalla riga di comando..

Configurazione di CLASSPATH per abilitare la copertura del codice

Per configurare CLASSPATH per abilitare la copertura del codice, impostare le seguenti variabili di ambiente CLASSPATH:

• ECLIPSE_HOME - La directory di installazione per Eclipse. Se non è definita, questa variabile di ambiente assume come valore predefinito la directory di installazione Rational.
• JAVA_HOME - La directory di installazione per Java. <JAVA_HOME>/bin deve contenere java.exe. Se non è definita, questa variabile di ambiente assume come valore predefinito la directory di RAD JRE predefinita.

Esecuzione dello script di strumentazione di copertura del codice

Su Windows, lo script di strumentazione è instrument.bat; su Linux, instrument.sh.

Il formato dello script di strumentazione è:

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

dove:

in:

Specificare l'elenco "separato dei percorsi" delle directory che contengono i file di classe che devono essere forniti. Il separatore percorso è dipendente dal sistema operativo (un punto e virgola ";" su Windows e i due punti ":" su Linux).

baseline:

Specifica il percorso in cui viene memorizzato il file baseline. Utilizzarlo solo se si prevede di generare i report di copertura del codice esternamente al workbench. Il file baseline è il file con cui viene confrontato il codice fornito e con cui vengono generate le statistiche di copertura del codice. Serve anche come input al generatore dei report di copertura del codice.

saveBackup:

Specifica se rinominare la classe originale e i file jar in *.bak. Includendo l'opzione saveBackup verranno generati file di backup; se la si omette, i file originali verranno sovrascritti (e quindi persi).

verbose:

Specifica che i messaggi informativi devono essere visualizzati.

output:

Specifica la directory di output in cui vengono memorizzati i file forniti; altrimenti i file forniti vengono memorizzati nella directory di input.

Esempio 1

Nel seguente esempio, i dati di copertura del codice vengono abilitati per i file nelle directory di Windows C:\java_code e C:\java_tests e non viene generato alcun backup per questi file. Il file baseline viene memorizzato in C:\llc\coverage_reports, i file informativi vengono visualizzati e i file di output vengono memorizzati in C:\instrumented_files

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

Esempio 2

Nel seguente esempio, la copertura del codice viene abilitata per i file nelle directory di Linux C:\java_source e C:/testcase_source e i backup vengono generati per questi file. Non viene creato alcun file baseline, non vengono visualizzati messaggi informativi e i file di output vengono memorizzati in C:/instrumented_files

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

Generazione dei report di copertura del codice esternamente al workbench

Fare riferimento a Generazione dei report di copertura del codice

Disabilitazione della copertura del codice dalla riga di comando

Per disabilitare le classi fornite utilizzando la riga di comando, ricompilare il progetto o sostituire i file .class con i file .class.bak, se saveBackup è stato abilitato.

(C) Copyright IBM Corporation 2007, 2008. Tutti i diritti riservati.