Activation de la couverture de code à partir d'une ligne de commande

Pour vérifier que le code répond à vos critères définis de couverture de code autorisés, vous pouvez activer la couverture de code à partir de la ligne de commande. Pour ce faire, vous devez :

• Configurer votre variable d'environnement CLASSPATH pour activer la couverture de code
• Exécuter le script de création de la couverture de code

Vous pouvez également générer des rapports de couverture de code en dehors du plan de travail et désactiver la couverture de code à partir de la ligne de commande.

Configuration de votre variable d'environnement CLASSPATH pour activer la couverture de code

Pour configurer votre variable d'environnement CLASSPATH pour activer la couverture de code, paramétrez les variables d'environnement CLASSPATH suivantes :

• ECLIPSE_HOME - Répertoire d'installation d'Eclipse. Si elle n'est pas définie, cette variable d'environnement se trouve par défaut dans le répertoire d'installation de Rational par défaut.
• JAVA_HOME - Le répertoire d'installation pour Java. <JAVA_HOME>/bin doit contenir java.exe. Si elle n'est pas définie, cette variable d'environnement se trouve par défaut dans le répertoire RAD JRE par défaut.

Exécution du script de création de la couverture de code

Sous Windows, le script de création est instrument.bat ; sous Linux, instrument.sh.

Le format du script de création est le suivant :

instrument.bat/sh -in <répertoire-entrée-src> [-baseline <fichier-référence>] [-saveBackup] [-verbose] [-output <rép-sortie>]

où :

in:

Indique la liste "séparée par les chemins" des répertoires qui contiennent les fichiers classe devant être créés. Le séparateur de chemins dépend du système d'exploitation (un point virgule ";" sous Windows et deux points ":" sous Linux).

baseline:

Indique le chemin de l'emplacement de stockage du fichier baseLine. A n'utiliser que si vous comptez générer des rapports de couverture de code en dehors du plan de travail. Le fichier baseLine est le fichier auquel le code créé est comparé et qui déclenche la génération des statistiques de couverture de code. Il sert d'entrée dans le générateur de rapports de couverture de code.

saveBackup:

Indique s'il faut renommer la classe d'origine et les fichiers jar avec l'extension *.bak. Inclure l'option saveBackup génère les fichiers de sauvegarde alors que l'exclure entraîne l'écrasement (et donc la perte) des fichiers d'origine.

verbose:

Indique que les messages d'informations doivent être imprimés.

output:

Indique le répertoire de sortie où doivent être stockés les fichiers créés ; sinon, les fichiers créés sont stockés dans le répertoire d'entrée.

Exemple 1

Dans l'exemple suivant, la couverture de code est activée pour les fichiers se trouvant dans les répertoires Windows C:\java_code et C:\java_tests et aucune sauvegarde n'est générée pour ces fichiers.Le fichier baseLine est stocké dansC:\llc\coverage_reports, les messages d'informations sont imprimés et les fichiers de sortie sont stockés dans C:\instrumented_files

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

Exemple 2

Dans l'exemple suivant, la couverture de code est activée pour les fichiers se trouvant dans les répertoires Linux C:\java_source et C:\testcase_source et les sauvegardes sont générées pour ces fichiers.Aucun fichier baseLine n'est créé, aucun message d'informations n'est imprimé et les fichiers de sortie sont stockés dans C:/instrumented_files

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

Génération de rapports de couverture de code en dehors du plan de travail

Voir Génération de rapports de couverture de code

Désactivation de la couverture de code à partir d'une ligne de commande

Pour désactiver les classes créées à l'aide de la ligne de commande, recompilez le projet ou remplacez les fichiers .class par les fichiers .class.bak si l'option saveBackup a été activée.

(C) Copyright IBM Corporation 2007, 2008. All Rights Reserved.