Работа с отслеживанием ошибок в IDE NetBeans

В IDE NetBeans можно работать со средствами отслеживания ошибок и выполнять стандартные задачи, такие как поиск и обновление ошибок и создание отчетов о новых ошибках. Если для проекта необходим контроль версий, то обновлять ошибки можно в процессе фиксации. В этом учебном курсе среда IDE будет использоваться для открытия примера проекта из репозитория с контролем версий. После открытия проекта вы увидите, как просматривать ошибки проекта, сообщать о новых ошибках, применять файл с исправлением, вложенный в ошибку, и разрешать проблему при фиксации изменений. В этом учебном курсе также демонстрируется регистрация и использование внешней системы отслеживания ошибок в среде IDE.

Просмотрите Видео по использованию интегрированной функции отслеживания ошибок в IDE NetBeans.

Содержание

• Открытие примера проекта
• Регистрация системы отслеживания ошибок
• Поиск и просмотр ошибок
• Сообщение о новой ошибке
• Работа с трассами стеков
• Открытие и применение файла исправления
• Интеграция с контролем версий

Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.

Программное обеспечение или материал	Требуемая версия
IDE NetBeans	6.9, 7.0, 7.1
Комплект для разработчика на языке Java (JDK)	версия 6
Пример проекта "Anagram Game"

Примечание.В настоящем учебном курсе описана система контроля версий Subversion. Для получения дополнительных сведений об использовании Subversion в среде IDE см. раздел, посвященный настройке Subversion, в описании Обзор Subversion.

Открытие примера проекта

Для целей демонстрации в этом учебном курсе используется пример проекта игры Anagram для демонстрации работы с системой отслеживания ошибок в среде IDE. Исходные коды для примера проекта Anagram Game доступны как проект NetBeans в репозитории Subversion, также для проекта доступна система отслеживания ошибок Bugzilla. Задачи, демонстрируемые в этом учебном курсе, могут использоваться со всеми поддерживаемыми системами отслеживания ошибок (Bugzilla, JIRA) и системами контроля версий (Subversion, Mercurial).

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

1. Выберите "Группа > Subversion > Извлечение", чтобы открыть мастер взятия для изменения.
2. Введите https://svn.kenai.com/svn/anagram-game~subversion в качестве URL-адреса репозитория. Нажмите кнопку "Далее".
3. В мастере нажмите кнопку "Обзор", чтобы указать папку репозитория, затем выберите AnagramGame. Нажмите кнопку "ОК".
4. Укажите расположение локальной папки для локального репозитория.
5. Нажмите кнопку "Завершить".

   После нажатия кнопки "Готово" среда IDE инициализирует локальную папку в качестве репозитория Subversion и выполняет проверку исходных файлов проекта на выходе.

6. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.

После щелчка команды "Открыть проект" в окне "Проекты" откроется новый проект как проект NetBeans.

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

Регистрация системы отслеживания ошибок

В среде IDE можно зарегистрировать любое количество поддерживаемых систем отслеживания ошибок. После регистрации системы отслеживания ее название добавляется в раскрывающийся список "Система отслеживания ошибок" в формы ошибок и диалоговые окна фиксации, позволяя просматривать, обновлять и создавать ошибки в среде IDE. Можно зарегистрировать существующую систему отслеживания ошибок Bugzilla или JIRA в среде IDE в окне "Службы".

Примечание. Чтобы использовать средство отслеживания проблем JIRA, необходимо загрузить подключаемый модуль поддержки JIRA из центра обновлений. Дополнительные сведения см. в разделе часто задаваемых вопросов по NetBeans Как получить и установить подключаемый модель JIRA NetBeans?

Выполните следующие действия для регистрации системы отслеживания ошибок для проектов Anagram Game.

1. Щелкните узел правой кнопкой мыши "Системы отслеживания проблем" в окне "Службы" и выберите "Создать систему отслеживания проблем".
2. Выберите соединитель для системы отслеживания проблем.
   (Anagram Game использует систему Bugzilla.)
3. Введите AnagramGame для системы отслеживания ошибок.

   Это имя используется для идентификации системы отслеживания ошибок в окнах и диалоговых окнах среды IDE.

4. Укажите URL-адрес системы отслеживания ошибок.
   (URL-адрес для системы отслеживания ошибок для Anagram Game — http://kenai.com/bugzilla/)
5. Щелкните "Проверка" для проверки подключения к системе отслеживания ошибок. Нажмите кнопку "ОК".

При нажатии кнопки "OК" среда IDE добавляет узел новой системы отслеживания ошибок в узел "Системы отслеживания ошибок" в окне "Службы".

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

• поиск существующих ошибок;
• создание сообщения о новой ошибке;
• изменение данных системы отслеживания ошибок;
• удаление системы отслеживания ошибок из списка.

Кроме того, поиск и сообщение о ошибках можно выполнять путем выбора задачи в меню "Группа".

Поиск и просмотр ошибок

В этом разделе окно "Найти ошибки" в среде IDE используется для получения списка открытых ошибок для проекта Anagram Game. В системе отслеживания проблем, связанной с проектом Anagram Game, содержится несколько примеров проблем. Окно "Найти задания" можно открыть, выбрав задачу в меню "Группа".

Сообщение о новой проблеме

В этом разделе демонстрируется отправка новой ошибки проекта "Anagram Game" в среде IDE.

Для отправки новой ошибки в зарегистрированную систему отслеживания ошибок в среде IDE используется "Сообщить о новой ошибке". Для открытия этой формы выберите в главном меню "Группа" > "Сообщить об ошибке", затем выберите в раскрывающемся списке в форме систему отслеживания ошибок.

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

Для сообщения о новой ошибке для проекта Anagram Game выполните следующие действия.

1. Выберите "Группа > Сообщить об ошибке" в главном меню, чтобы открыть окно "Сообщить о новой ошибке".
2. Выберите систему отслеживания в раскрывающемся списке "Системы отслеживания ошибок".
3. Выберите проект в раскрывающемся списке "Продукт".
4. Введите информацию о проблеме, общее описание и описание. Нажмите кнопку "Отправить проблему".

При нажатии кнопки "Отправить проблему" среда IDE отправляет проблему в систему отслеживания.

Примечание. В этом примере вы не сможете сообщить о проблеме, потому что вы не являетесь участником проекта.

Работа с трассировками стеков

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

Примечание. Для перехода к строкам в исходном коде из трассировки стека, источники проекта должны быть изъяты и проект должен быть открыт в IDE.

1. Открыть ошибку 1446 Невозможно запустить AnagramGame из-за NullPointerException.

   Ошибка 1446 проекта Anagram Game указывает, что NullPointerException возникает при запуске приложения.

2. В описании ошибки щелкните следующую строку в трассировке стека:

   com.toy.anagrams.ui.Anagrams$2.windowOpened(Anagrams.java:72)

   Описание ошибки содержит копию трассировки стека из окна "Вывод".

   

При щелчке указанной строки в трассировке стека локальный файл будет открыт средой IDE в редакторе, при этом на указанной строке в исходном коде будет установлен курсор в режиме вставки.

Примечание. В IDE можно открыть локальный файл, потому ранее в этом учебном курсе источники были изъяты.

Исключение можно воспроизвести: для этого запустите приложение "Anagram Game" и просмотрите результаты его работы в окне "Вывод". В окне "Вывод" отображаются результаты, аналогичные представленным ниже.

Открытие и применение файла исправления

В данном разделе описывается процедура просмотра вложенного файла исправления и его применения.

Проблема 1446 указывает на возникновение NullPointerException при выполнении приложения Anagram Game. В ошибку вложен файл исправления, содержащий исправление для NullPointerException. Если в ошибку вложен файл исправления, можно открыть и применить исправление непосредственно из окна проблемы.

1. Открыть ошибку 1446 Невозможно запустить AnagramGame из-за NullPointerException.
2. Щелкните имя файла исправления, вложенного в ошибку.
   

   При щелчке имени файла этот файл будет открыт средой IDE в редакторе. Обратите внимание на то, что применение исправления вызвало следующие изменения в классе StaticWordLibrary.java.

   -    static WordLibrary DEFAULT;
   +    final static WordLibrary DEFAULT = new StaticWordLibrary();

   Закройте файл исправления.

3. В окне для ошибки щелкните применить рядом с именем прикрепленного файла исправления, чтобы открыть диалоговое окно "Применить исправление".
4. Разверните проект "Anagram Game" и выберите каталог "Исходные файлы" в диалоговом окне "Применить исправление". Нажмите кнопку "Apply".
   

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

После нажатия кнопки "Применить" исправление применяется средой IDE, и в класс StaticWordLibrary.java вносятся изменения. Можно открыть этот файл в редакторе и просмотреть изменения. В окне "Проекты" можно заметить, что среда IDE пометила этот файл как измененный.

Интеграция с контролем версий

В этом разделе описывается процедура обновления ошибок в процессе фиксации изменений в исходных файлах проекта "Anagram Game".

В среду IDE интегрирована поддержка контроля версий исходного кода (посредством Subversion или Mercurial) и нескольких систем отслеживания ошибок. Интегрированная поддержка позволяет обновлять ошибки в зарегистрированной системе отслеживания ошибок в процессе фиксации.

К числу служб, предоставляемых для размещенных на узле Kenai проектов, относятся также выделенные репозитории контроля версий. После открытия проекта Kenai "Anagram Game" и проверки исходных файлов проекта средой IDE выполняется автоматическая привязка проекта к соответствующей системе отслеживания ошибок.

Дополнительные сведения об использовании Subversion в IDE NetBeans см. Обзое возможностей Subversion.

Для получения дополнительных сведений о поддержке систем контроля версий в Kenai см. документацию по Kenai в разделе Управление исходным кодом.

В этом упражнении демонстрируется обновление проблемы в процессе подтверждения.

1. Разверните пакет com.toy.anagrams.lib в узле "Исходные файлы" в окне "Проекты".
   

   Проект "Anagram Game" уже внесен в репозиторий контроля версий. Имена измененных исходных файлов, которые необходимо фиксировать в репозиторий, обозначены синим. Значки на каталогах указывают, что они содержат файлы, которые следует фиксировать.

2. Щелкните файл StaticWordLibrary.java правой кнопкой мыши и выберите "Subversion" > "Фиксировать" для открытия диалогового окна "Фиксация".
3. Введите сообщение "Сообщение о фиксации" с описанием фиксации.
4. Разверните панель "Обновить проблему" в диалоговом окне "Фиксация".
   
5. Выберите систему отслеживания ошибок для проекта Anagram Game в раскрывающемся списке (если она не выбрана).
6. Введите 1446 в поле "Задание".

   Фиксируемые изменения StaticWordLibrary.java исправят исключение, сообщенное в ошибке 1446.

   Можно ввести идентификатор ошибки (1446) или определенный текст, содержащийся в описании ошибки (NullPointerException) в поле "Ошибка". В среде IDE отображается список ошибок, соответствующих данному тексту.

7. Установите флажок Разрешить как исправленное.

   В результате установки флажка "Разрешить как исправленное" статус проблемы изменится на "Разрешена".

8. (Дополнительно) Выберите Добавить подробности к сообщению о фиксации и ошибке для добавления дополнительных сведений. Можно щелкнуть изменение, чтобы открыть диалоговое окно, в котором можно изменить форматирование дополнительных сведений.
9. Нажмите кнопку "Фиксировать".

При нажатии кнопки "Фиксировать" среда IDE фиксирует изменения в репозитории и обновляет ошибку. Если вход в систему не выполнен, то будет выведен запрос имени пользователя и пароля.

Примечание. В этом примере вы не сможете зафиксировать изменения, потому что вы не являетесь участником проекта.

В этом учебном курсе описано использование IDE при работе с системами отслеживания ошибок. Интегрированная поддержка систем отслеживания ошибок Bugzilla и JIRA позволяет просматривать и обновлять ошибки, а также сообщать о них непосредственно из среды IDE. Для проектов, размещенных на сервере группы и связанных с системой отслеживания ошибок, также размещенной на этом сервере, можно работать с ошибками проектов из инструментальной панели группы.

При работе с другими проектами можно зарегистрировать систему отслеживания ошибок Bugzilla или JIRA в среде IDE и выполнять просмотр и создание сообщений об ошибках с помощью команд меню "Группа".

Дополнительные сведения

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

• Работа с сервером групповой работы в IDE NetBeans
• Обзор Subversion
• Интеграция со внешними средствами и службами