Включение охвата кода из командной строки

Для того чтобы проверить, отвечает ли код принятым критериям качества кода, можно включить охват кода в командной строке. Для этого необходимо выполнить следующие задачи:

• Настройка CLASSPATH для охвата кода
• Запуск сценария встраивания кода для охвата

Также можно создать отчеты охвата кода вне рабочей среды и выключить охват кода из командной строки.

Настройка CLASSPATH для охвата кода

Для включения охвата кода установите следующие переменные среды CLASSPATH:

• ECLIPSE_HOME - каталог установки Eclipse. Если он не определен, эта переменная среды принимает значение каталога установки Rational по умолчанию.
• JAVA_HOME - каталог установки Java. Каталог <JAVA_HOME>/bin должен содержать java.exe. Если он не определен, эта переменная среды принимает значение каталога RAD JRE по умолчанию.

Запуск сценария встраивания кода для охвата

В Windows это сценарий instrument.bat; в Linux - instrument.sh.

Формат вызова сценария встраивания следующий:

instrument.bat/sh -in <входной-каталог> [-baseline <файл-контрольной-версии>] [-saveBackup] [-verbose] [-output <выходной-каталог>]

где:

in:

Список каталогов, в файлы классов которых будет встроен код. Разделитель путей зависит от операционной системы (точка с запятой ";" в Windows и двоеточие ":" в Linux).

baseline:

Путь к расположению файла контрольной версии. Используется только в случае, когда данные охвата кода генерируются за пределами рабочей среды. Файл контрольной версии - это файл, с которым сравнивается анализируемый код, и для которого создается статистика охвата кода. Он будет входным файлом для задачи создания отчета.

saveBackup:

Указывает, следует ли переименовывать исходные файлы *.class и *.jar в *.bak. Если saveBackup указан, то резервные файлы будут создаваться, если не указан, то исходные файлы будут перезаписываться.

verbose:

Включает вывод информационных сообщений.

output:

Определяет каталог, куда будут сохраняться файлы с встроенным кодом. Если он не указан, то файлы будут сохраняться в исходном каталоге.

Пример 1

В следующем примере данные охвата кода собираются для всех файлов в каталогах Windows C:\java_code и C:\java_tests, резервные копии файлов не создаются. Файл контрольной версии - это C:\llc\coverage_reports, информационные сообщения выводятся, а выходные файлы сохраняются в каталоге C:\instrumented_files

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

Пример 2

В следующем примере данные охвата кода собираются для всех файлов в каталогах Linux /java_source и /java_source, резервные копии файлов создаются. Файл контрольной версии не создается, информационные сообщения не выводятся, а выходные файлы сохраняются в каталоге /instrumented_files

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

Создание отчетов охвата кода вне рабочей среды

См. раздел Создание отчетов охвата кода

Выключение охвата кода из командной строки

Для того чтобы выключить встраивание кода в классы из командной строки, повторно скомпилируйте проект или замените файлы .class файлами .class.bak, если была включена опция saveBackup.

(C) Copyright IBM Corporation 2007, 2008. Все права защищены.