Habilitar la cobertura de código desde la línea de mandatos

Para verificar que el código cumple los criterios de aceptación de cobertura de código especificados puede habilitar la cobertura de código desde la línea de mandatos. Para hacerlo, debe:

• Configurar la variable CLASSPATH para habilitar la cobertura de código
• Ejecutar el script de instrumentación de cobertura de código

También puede generar informes de cobertura de código desde fuera del entorno de trabajo e inhabilitar la cobertura de código desde la línea de mandatos.

Configurar la variable CLASSPATH para habilitar la cobertura de código

Para configurar la variable CLASSPATH para habilitar la cobertura de código, establezca las variables de entorno CLASSPATH siguientes:

• ECLIPSE_HOME - El directorio de instalación de eclipse. Si no se define, el valor predeterminado de esta variable de entorno es el directorio de instalación predeterminado de Rational.
• JAVA_HOME - El directorio de instalación para Java. <JAVA_HOME>/bin debe contener java.exe. Si se define, el valor predeterminado de esta variable de entorno es el directorio predeterminado de JRE de RAD.

Ejecutar el script de instrumentación de cobertura de código

En Windows, el script de instrumentación es instrument.bat; en Linux, instrument.sh.

El formato del script de instrumentación es:

instrument.bat/sh -in <src-input-directory> [-baseline <archivo-de-línea-base>] [-saveBackup] [-verbose] [-output <directorio-de-salida>]

donde:

in:

Especifica la lista "separada por vía de acceso" de los directorios que contiene los archivos de clase que deben instrumentarse. El separador de vía de acceso depende del sistema operativo (un punto y coma ";" en Windows y dos puntos ":" en Linux).

baseline:

Especifica la vía de acceso en la que se almacena el archivo de línea base. Solo debe utilizarse si pretende generar informes de cobertura de código desde fuera del entorno de trabajo. El archivo de línea base es el archivo con el que se compara el código instrumentado y para el que se generan las estadísticas de cobertura de código. Sirve como entrada al generador de informes de cobertura de código.

saveBackup:

Especifica si se deben redenominar los archivos de clase y jar originales como *.bak. Al incluir la opción saveBackup se generarán los archivos de copia de seguridad; al omitir la opción se sobrescribirán los archivos originales (y por lo tanto se perderán).

verbose:

Especifica que deben imprimirse los mensajes informativos.

output:

Especifica el directorio de salida en el que deben almacenarse los archivos instrumentados; de lo contrario, los archivos instrumentados se almacenan en el directorio de entrada.

Ejemplo 1

En el ejemplo siguiente, la cobertura de código está habilitada para los archivos en los directorios de Windows C:\java_code y C:\java_tests y no se generan copias de seguridad para estos archivos. El archivo de línea base se almacena en C:\llc\coverage_reports, los mensajes informativos se imprimen y los archivos de salida se almacenan en C:\instrumented_files

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

Ejemplo 2

En el ejemplo siguiente, la cobertura de código está habilitada para los archivos en los directorios de Linux C:/java_source y C:/testcase_source y se generan copias de seguridad para estos archivos. No se crea ningún archivo de línea base, no se imprimen mensajes informativos y los archivos de salida se almacenan en C:/instrumented_files

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

Generar informes de cobertura de código desde fuera del entorno de trabajo

Consulte el apartado Generar informes de cobertura de código

Inhabilitar la cobertura de código desde la línea de mandatos

Para inhabilitar las clases instrumentadas desde la línea de mandatos, vuelva a compilar el proyecto o sustituya los archivos .class por los archivos .class.bak si se habilitó saveBackup.

(C) Copyright IBM Corporation 2007, 2008. Reservados todos los derechos.