Kódlefedettség engedélyezése a parancssorból

Ha ellenőrizni kívánja, hogy az éppen összeépített kód a megadott kódlefedettségi elfogadhatósági feltételeknek megfelel-e, akkor engedélyezheti a kódlefedettséget parancssorból. Ehhez a következőket kell tennie:

• CLASSPATH beállítása a kódlefedettség engedélyezéshez
• A kódlefedettség felkészítési parancsfájl futtatása

Kódlefedettség jelentéseket a kezelőfelületen kívülről is előállíthat és a kódlefedettséget letilthatja a parancssorból.

CLASSPATH beállítása a kódlefedettség engedélyezéshez

Ha a kódlefedettség engedélyezés érdekében be kívánja állítani a CLASSPATH változót, akkor állítsa be a következő CLASSPATH környezeti változókat:

• ECLIPSE_HOME - Az Eclipse telepítési könyvtára. Ha nincs meghatározva, akkor ennek a környezeti változónak az alapértelmezése az alapértelmezett Rational telepítési könyvtár.
• JAVA_HOME - A Java telepítési könyvtára. A <JAVA_HOME>/bin könyvtárnak tartalmaznia kell a java.exe fájlt. Ha nincs meghatározva, akkor ennek a környezeti változónak az alapértelmezése az alapértelmezett RAD JRE könyvtár.

A kódlefedettség felkészítési parancsfájl futtatása

Windows platformon a felkészítési parancsfájl neve instrument.bat; Linux platformon instrument.sh.

A felkészítési parancsfájl formátuma a következő:

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

ahol:

in:

A felkészítendő osztályfájlokat tartalmazó könyvtárak "útvonallal elválasztott" listáját adja meg. Az útvonal elválasztó operációs rendszer függő (pontosvessző ";" Windows rendszeren és kettőspont ":" Linux rendszeren).

baseline:

Az alapsor fájl tárolási útvonalát adja meg. Csak akkor használja, ha a kezelőfelületen kívülről kíván létrehozni kódlefedettségi jelentéseket. Az alapsor fájl az a fájl, amellyel a felkészített kód összehasonlításra kerül és kódlefedettségi statisztika előállításra kerül. A kódlefedettségi jelentéselőállító bemenetéül is szolgál.

saveBackup:

Megadja, hogy az eredeti osztály és jar fájlokat át kell-e *.bak kiterjesztésűvé nevezni. A saveBackup paraméter használata előállítja a biztonsági mentési fájlokat; a kihagyása eredetei fájlok felülírását (és ezért elveszését) eredményezi.

verbose:

Megadja, hogy az információs üzeneteket ki kell nyomtatni.

output:

A kimeneti könyvtárat adja meg, ahol a felkészített fájlok tárolásra kerülnek; egyébként a felkészített fájlok a bemeneti könyvtárban kerülnek tárolásra.

1. példa

A következő példában a kódlefedettség a C:\java_code és a C:\java_tests Windows könyvtárakban található fájlok esetében engedélyezett, és ezekről a fájlokról biztonsági mentés nem készül. Az alapsor fájl a C:\llc\coverage_reports helyen kerül tárolásra, az információs üzenetek kinyomtatásra kerülnek, és a kimeneti fájlok a C:\instrumented_files helyen kerülnek tárolásra

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

2. példa

A következő példában a kódlefedettség a C:/java_source és a C:/testcase_source Linux könyvtárakban található fájlok esetében engedélyezett, és a fájlokról biztonsági mentés készül. Alapsor fájl nem készül, információs üzenetek nem kerülnek nyomtatásra, és a kimeneti fájlok a C:/instrumented_files helyen kerülnek tárolásra

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

Kódlefedettség jelentések előállítása a kezelőfelületen kívülről

Lásd a Kódlefedettség jelentések előállítása témakört

Kódlefedettség letiltása a parancssorból

A parancssorból felkészített osztályok letiltásához fordítsa újra a projektet vagy helyettesítse a .class fájlokat a .class.bak fájlokkal, amennyiben a saveBackup beállítás engedélyezett volt.

(C) Copyright IBM Corporation 2007, 2008. Minden jog fenntartva.