Создание пользовательского кода Java

Пользовательский код берет ссылки из теста в качестве входных значений и возвращает измененные значения в тест. Для создания пользовательского кода применяется интерфейс ICustomCode2, а для расширения выполнения тестов - интерфейс ITestExecutionServices. Эти интерфейсы входят в пакет com.ibm.rational.test.lt.kernel.services.

Об этой задаче

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

Входные параметры пользовательского кода могут быть ссылками или ссылками на поля. Кроме того, аргументом пользовательского кода может быть текстовая строка. Ссылки, используемые в качестве входных параметров пользовательского кода, должны быть включены в тот же тест, что и пользовательский код. В тесте ссылка должна находиться перед кодом, на который она влияет. Убедитесь в том, что в тесте есть ссылки, необходимые для пользовательских входных параметров кода. Подробные сведения о создании ссылок и ссылок на поля приведены в разделе Создание ссылки или ссылки на поле.

Если в пользовательском коде используются внешние файлы JAR, может потребоваться изменение пути компоновки Java™. В некоторых случаях можно избежать необходимости изменять путь компоновки вручную, выполнив тест перед добавлением в него пользовательского кода. При первом выполнении теста классы и библиотеки, необходимые для компиляции, добавляются в путь компоновки. Например, можно импортировать классы Test and Performance Tools Platform (TPTP), необходимые для создания пользовательских событий в протоколе тестирования, если тест, в который был добавлен пользовательский код, уже выполнялся раньше. Но если тест ранее не выполнялся, при импорте возникнут ошибки, потому что классы не будут включены в путь компоновки проекта до тех пор, пока не будет выполнен тест.

Если в коде используются внешние ресурсы, например база данных SQL или продукт, отвечающий за взаимодействие с клиентами, пользовательский код необходимо настроить таким образом, чтобы он выполнялся на всех компьютерах, на которых выполняется тест.

Пользовательский код сохраняется в папке src проекта с тестом, вызывающим код. По умолчанию пользовательский код находится в пакете с названием test в папке src.

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

На следующем примере показано стандартное окно Навигатора для двух классов пользовательского кода. (В Навигаторе тестов не показаны исходные файлы Java.)

Окно Навигатора с классами ReplaceCC.java и VerifyUserID.java

Когда вы добавите классы пользовательского кода ReplaceCC.java и VerifyYUserID.java в тест и вернете значение в тест, эти два класса будут показаны в поле Подстановка.

В пакет тестов также будет входить созданный код Java для тестов в этом проекте.

Пользовательский код можно поместить в другой пакет (например, custom). Разделяйте пользовательский и сгенерированный код, особенно если в вашей среде применяется система контроля исходного кода.

Процедура

Для добавления пользовательского кода:

  1. Откройте тест и выберите элемент теста.
  2. Нажмите кнопку Добавить или Вставить, и выберите значение Пользовательский код. Кнопка Добавить добавляет пользовательский код в конец выбранного элемента теста. Кнопка Вставить добавляет пользовательский код над выбранным элементом теста.
    Прим.: После добавления или вставки пользовательского кода в окне Проблемы будет показано сообщение об ошибке, в котором будет сказано, что у нового элемента пользовательского кода нет файла Java. Это сообщение об ошибке будет показано до тех пор, пока вы не нажмете кнопку Просмотреть код или Создать код, в качестве напоминания о том, что элемент пользовательского кода в тесте еще не связан с кодом Java.
  3. Проинспектируйте поле Имя класса и выполните один из следующих шагов:
    • Если вызываемый код уже существует, приведите имя класса в соответствие с именем кода. Нажмите кнопку Просмотреть код для того, чтобы открыть код в редакторе Java.
    • Если код не существует, измените имя класса таким образом, чтобы оно описывало предназначение кода. Нажмите кнопку Создать код, чтобы создать класс шаблона для внесения результатов в протокол и открыть его в редакторе Java. Если класс с таким именем существует, будет показано предупреждение о том, что он будет заменен.
  4. В поле Аргументы нажмите кнопку Добавить.
  5. в окне Пользовательский код выберите все входные параметры кода. В окне Пользовательский код будут показаны все значения в тесте, которые могут применяться в качестве входных параметров кода (ссылки и ссылки на поля в тесте, указанные перед кодом).
  6. Нажмите кнопку OK. Окно будет закрыто, и выбранные ссылки будут добавлены в поле Аргументы.
  7. Необязательно: Для добавления текстовых строк в качестве входных параметров пользовательского кода щелкните в поле Текст и введите нужную текстовую строку.
  8. В тесте после вашего пользовательского кода найдите значение, которое ваш код возвращает в тест.
  9. Выделите это значение.
  10. Щелкните правой кнопкой на выделенном значении, выберите Подставить, а затем выберите имя класса вашего пользовательского кода. Будет показан список добавленных классов пользовательского кода. После того как вы сделаете свой выбор, возвращаемое в тест значение будет выделено оранжевым цветом и эта информация будет добавлена в таблицу Где используется.

Дальнейшие действия

Пользовательский код не будет показан в окне Навигатор тестов. Для просмотра пользовательского кода откройте окно Структура пакетов и воспользуйтесь инструментами Java для поиска добавленного пользовательского кода.

Комментарии