Создание JavaTesK проекта

Легенда: не расписано, не реализовано
Управление JavaTESK проектом
Создание JavaTESK проекта
1. Для создания нового JavaTESK проекта пользователь выбирает действие
File>New>Project…
2. Eclipse предлагает пользователю стандартный диалог для выбора типа создаваемого
проекта.
3. Пользователь выбирает JavaTESK project.
4. Eclipse предлагает пользователю диалог с настройками создаваемого проекта.
5. Eclipse создает Java проект с заданным именем и настройками.
6. Eclipse конвертирует Java проект в JavaTESK проект.
Конвертирование Java проекта в JavaTESK проект
Пользователь выбирает один или несколько Java проектов.
Пользователь выбирает из контекстного меню действие Enable JavaTESK Nature.
Eclipse добавляет к иконке конвертированного проекта декоратор.
В build path проекта добавляется JavaTESK System Library контейнер, указывающий на
одноименную User Library переменную, значение которой можно настраивать
воспользовавшись следующим пунктом меню Window>Preferences -> Java>Build
Path>User Libraries.
5. В проекте создается и добавляется в build path проекта каталог для сгенерированных
Java файлов.
6. Для предотвращения копирования JavaTESK файлов в output каталог, в настройку Java
компилятора для проекта, отвечающую за фильтрацию ресурсов, добавляется фильтр
для JavaTESK файлов.
7. В проект добавляется JavaTESK builder и происходит полная сборка JavaTESK
проекта.
1.
2.
3.
4.
4а. В случае, если в проекте уже есть библиотека, содержащаяся в JavaTESK System Library контейнер, она должна быть предварительно удалена.
5a. Каталог для сгенерированных Java файлов не удовлетворяет одному из следующим
требований:
 имя каталога должно быть корректным с точки зрения Eclipse
 каталог, будучи добавленным в build path проекта, не должен создавать
конфликтов, как то быть включенным в один из output каталогов и т.д.
5a.1 Пользователю предлагается уточнить имя каталога.
Конвертирование JavaTESK проекта в Java проект
Пользователь выбирает один или несколько JavaTESK проектов.
Пользователь выбирает из контекстного меню действие Disable JavaTESK Nature.
Eclipse удаляет из проекта JavaTESK builder и все problem маркеры, им созданные.
Eclipse удаляет из настроек Java компилятора в проекте фильтр ресурсов для JavaTESK
файлов.
5. Eclipse предлагает пользователю решить, что делать со сгенерированными Java
файлами (исключить из build path, удалить) и производит выбранные действия.
6. Eclipse удаляет из build path проекта JavaTESK System Library контейнер.
7. Eclipse удаляет из иконки проекта декоратор.
1.
2.
3.
4.
Настройка JavaTESK System Library контейнера
1. В случае если пользователь удалил JavaTESK System Library контейнер и желает его
восстановить, необходимо для проекта выбрать команду Build Path>Add Libraries… и
выбрать в появившемся диалоге JavaTESK System Library
2. В случае если в проекте необходимо использовать экземпляр библиотеки tsbasis.jar
отличный от предлагаемого по умолчанию, пользователь может выбрать для JavaTESK
System Library контейнера команду Configure…
3. В результате пользователю предлагается диалог, в котором он может согласится
использовать в JavaTESK System Library контейнере предлагаемый по умолчанию tsbasis.jar или выбрать в файловой системе свою версию этой библиотеки или каталог,
содержащий class файлы с ее реализацией.
Задание каталога по умолчанию для сгенерированных Java файлов
1. Пользователь выбирает действие Window>Preferences…
2. В открывшемся диалоге пользователь выбирает категорию JavaTESK.
3. На странице категории JavaTESK пользователь задает имя каталога, используемого по
умолчанию для сгенерированных Java файлов в JavaTESK проекте.
3a. В случае если имя каталога не удовлетворяет следующим требованиям:
 имя каталога должно быть корректным с точки зрения Eclipse
 каталог, будучи добавленным в build path проекта, не должен создавать
конфликтов, как то быть включенным в один из output каталогов и т.д.
3a.1 Eclipse запрещает использовать выбранное имя каталога и оповещает
пользователя о причине запрета.
3b. Пользователь выбирает значение по умолчанию.
3b. Eclipse устанавливает значение имени каталога в javatesk-generated.
Уточнение каталога, содержащего сгенерированные Java файлы, для
конкретного JavaTESK проекта
Пользователь выбирает JavaTESK проект.
Пользователь выбирает действие контекстного меню Properties.
В открывшемся диалоге пользователь выбирает категорию JavaTESK.
На странице категории JavaTESK пользователь задает имя каталога, используемого по
умолчанию для сгенерированных Java файлов в JavaTESK проекте.
5. Eclipse предлагает пользователю решить, что делать со сгенерированными Java
файлами в старом каталоге (исключить из build path, удалить) и производит выбранные
действия.
6. В проекте создается и добавляется в build path новый каталог для сгенерированных Java файлов.
1.
2.
3.
4.
4a. В случае если имя каталога не удовлетворяет следующим требованиям:
 имя каталога должно быть корректным с точки зрения Eclipse
 каталог, будучи добавленным в build path проекта, не должен создавать
конфликтов, как то быть включенным в один из output каталогов и т.д.
4a.1 Eclipse запрещает использовать выбранное имя каталога и оповещает
пользователя о причине запрета.
4b. Пользователь выбирает значение по умолчанию.
4b.1 Eclipse устанавливает значение имени каталога согласно имени, заданному
глобально.
Сборка JavaTESK проекта
Полная сборка JavaTESK проекта
1. Eclipse активирует полную сборку проекта (автоматически или в результате запроса
пользователя, например, при помощи действия Clean с включенной опцией
последующей пересборки проекта)
2. Eclipse Java Builder компилирует Java файлы
3. Eclipse JavaTESK Builder удаляет ранее установленные problem маркеры.
4. Eclipse JavaTESK Builder удаляет сгенерированные Java файлы.
5. Eclipse JavaTESK Builder транслирует JavaTESK файлы входящие в build path проекта
в Java файлы и помещает их в каталог для сгенерированных Java файлов.
6. Eclipse Java Builder компилирует сгенерированные Java файлы
4a. Каталог для сгенерированных Java файлов отсутствует в проекте
4a.1 JavaTESK builder добавляет в проект соответствующий
прекращает работу
5a В проекте нет runtime библиотеки поддержки выполнения
<version>.jar
5a.1 JavaTESK builder добавляет в проект соответствующий
прекращает работу
5b В проекте нет фильтра ресурсов для JavaTESK файлов.
5b.1 JavaTESK builder добавляет в проект соответствующий
прекращает работу
5с В проекте имеются problem маркеры уровня error.
5с.1 JavaTESK builder прекращает работу
problem маркер и
тестов jatt-tsbasisproblem маркер и
problem маркер и
Инкрементальная сборка JavaTESK проекта
Очистка JavaTESK проекта
1. Пользователь выделяет один или несколько JavaTESK проектов
2. Пользователь активирует очистку выделенных проектов (например, при помощи
действия Project>Clean…)
3. Eclipse Java builder выполняет очистку проекта
4. Eclipse JavaTESK builder стирает сгенерированные Java файлы и соответствующие им
скомпилированные class файлы.
Запуск исполнимых артефактов проекта
Создание конфигурации запуска JavaTESK теста
1. Опционально. Пользователь выбирает JavaTESK файл или отрывает JavaTESK файл на
редактирование.
2. Пользователь выбирает действие Run>Run…
3. Eclipse предлагает пользователю диалог управления конфигурациями запуска.
4. Пользователь создает в категории JavaTESK новую конфигурацию запуска
5. Eclipse создает новую конфигурацию
6. Если выбран JavaTESK файл, Eclipse заполняет значение Project закладки Test именем
проекта, которому принадлежит выбранный JavaTESK файл.
7. Если выбран JavaTESK файл, Eclipse заполняет значение Main Class закладки Test
именем public класса, содержащегося в выбранном JavaTESK файле.
8. Eclipse устанавливает отсутствие вывода трассы на консоль.
9. Если выбран JavaTESK файл, Eclipse назначает вывод трассы в файл лежащий рядом с
выделенным JavaTESK файлом, формируя имя файла по следующему шаблону
<main_class_name>.<number>.utt
10. Eclipse заполняет стандартные для Java приложения закладки (Arguments, JRE,
Classpath, Environment, Common) принятыми для Java приложений значениями по
умолчанию.
11. Пользователь редактирует созданную конфигурацию.
Редактирование существующей конфигурации запуска JavaTESK теста
1.
2.
3.
4.
5.
Пользователь выбирает действие Run>Run…
Eclipse предлагает пользователю диалог управления конфигурациями запуска.
Пользователь выбирает существующую конфигурацию запуска JavaTESK теста
Пользователь изменяет значения конфигурации
Пользователь выбирает действие Apply для применения новых настроек или Revert для
возврата к старым настройкам.
4a. Пользователь меняет значение Project или Main Class
1. Если пользователь не менял имени файла, в который тест будет вести трассировку,
Eclipse формирует новое имя файла, так чтобы файл с трассой помещался рядом с
запускаемым тестом и имел уникальное имя, сформированное по следующему
шаблону <main_class_name>.<number>.utt.
Запуск конфигурации JavaTESK теста
1.
2.
3.
4.
5.
Пользователь выбирает действие Run>Run…
Eclipse предлагает пользователю диалог управления конфигурациями запуска.
Пользователь выбирает существующую конфигурацию запуска JavaTESK теста
Пользователь выбирает действие Run
Eclipse запускает тест с указанными настройками
5a. Eclipse не может запустить тест с указанными настройками
1. Eclipse сообщает о причинах, по которым не может запустить тест
Быстрый запуск JavaTESK теста
1.
2.
3.
4.
Пользователь выбирает JavaTESK файл
Пользователь выбирает действие контекстного меню Run As>JavaTESK Test
Eclipse ищет существующую конфигурацию запуска для выбранного JavaTESK файла
Eclipse запускает найденную конфигурацию или без открытия диалога создает новую и
запускает ее.
4a. Eclipse не может запустить конфигурацию по некоторым причинам
1. Eclipse сообщает о причинах, по которым не может запустить тест
Создание JavaTESK файлов
Редактирование JavaTESK файлов