Статический анализ кода в редакторе Java IDE NetBeans

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

В данном учебном курсе описано выполнение статического анализа кода Java с помощью FindBugs и подсказок Java NetBeans без непосредственного запуска приложений.

Содержание

Содержимое на этой странице применимо к IDE NetBeans 8.0

Требования

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

Программное обеспечение или материал Требуемая версия
IDE NetBeans Версия 8.0
Комплект для разработки приложений на языке Java (JDK) Версия 7 и более поздние версии
library.zip проект NetBeans
jsr305-2.0.0.jar Запрос спецификации Java предназначен для улучшения эффективности инструментов статического анализа

Примечание. Файл jsr305-2.0.0.jar включен в архив library.zip только для выполнения заданий данного практического руководства.

При работе с другими проектами NetBeans файл jsr305-2.0.0.jar необходимо загрузить отдельно и добавить в папку 'Библиотеки' проекта в IDE следующим образом:

  1. Щелкните правой кнопкой мыши папку 'Библиотеки' и выберите 'Добавить файл JAR/папку' во всплывающем меню.
  2. В диалоговом окне 'Добавить файл JAR/папку' укажите путь к загруженному файлу jsr305-2.0.0.jar и щелкните 'Открыть'.

    добавлен файл jsr305-2.0.0.jar

Установка среды учебного курса

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

  • Файл library.zip необходимо разархивировать в папку проекта NetBeans и открыт в IDE NetBeans.
  • Подключаемый модуль FindBugs необходимо загрузить и установить в IDE NetBeans следующим образом:
    1. Выберите 'Источник' > 'Проверка' в главном меню IDE.
    2. В диалоговом окне "Проверка" щелкните "Установить".

      Диалоговое окно 'Проверка'

    3. В диалоговом окне 'Программа установки' щелкните 'Далее', чтобы продолжить установку.

      Установка подключаемого модуля

    4. Прочтите лицензионное соглашение, выберите положение лицензионного соглашения и щелкните 'Установить'.
    5. По завершении установки нажмите кнопку "Готово".

Использование заранее определенных настроек

При проверке кода в IDE NetBeans можно использовать заранее определенные конфигурации:

Выполнение всех средств анализа

Конфигурация Все средства анализа развертывает все инструменты статического анализа кода, доступные в IDE.

Для запуска конфигурации Все анализаторы выполните следующие шаги:

  1. Выберите 'Источник' > 'Проверка' на главной панели инструментов IDE.
  2. В раскрывающемся списке 'Область' диалогового окна 'Проверка' выберите Текущий проект (библиотека).
  3. В раскрывающемся списке 'Конфигурация' выберите конфигурацию Все средства анализа.

    Выбрана конфигурация 'Все средства анализа'

    Примечание. Необходимо установить подключаемый модуль FindBugs для запуска этой конфигурации в первый раз.

  4. Нажмите кнопку "Проверить".
    Результаты анализа отображаются в окне 'Инспектор' в представлении дерева слева.

    Запущена конфигурация 'Все средства анализа'

    Описание текущего выбранного результата в представлении дерева отображается справа.

    Описание

    Примечание. Если вы хотите оставить некоторую часть кода, которая описана в отчете как содержащая ошибки без изменений, IDE позволяет подавить предупреждения для этого кода, чтобы оставить его без изменений. Можно дважды щелкнуть предупреждение в представлении дереве в окне 'Инспектор', чтобы перейти в редактор исходного кода. Нажмите Alt-Enter, нажмите на черную стрелку, указывающую вправо в конце отображаемой подсказки и выберите SuppressWarning - (имя предупреждения).

    Подавление предупреждения

Проверка кода Java по подсказкам Java NetBeans

Конфигурация Подсказки Java NetBeans, доступная в IDE, позволяет проверить, удовлетворены ли заранее определенные правила стандартов написания кода рассматриваемым исходным кодом. Другими словами, он применяет набор подсказок Java NetBeans (также называется проверками кода) к исходным файлам Java.

Для запуска конфигурации Подсказки Java NetBeans выполните следующие шаги:

  1. Выберите 'Источник' > 'Проверка' на главной панели инструментов IDE.
  2. В раскрывающемся списке 'Область' диалогового окна 'Проверка' выберите Открыть проект (если имеется только одна библиотека проект будет открыт в среде IDE) or Текущий проект (библиотека).

    Примечание. Можно определить область (файлы. пакеты или проекты) для конфигурации Подсказки Java NetBeans.

  3. Выберите переключатель 'Конфигурация' и выберите Подсказки Java NetBeans в раскрывающемся списке.

    Выбор подсказок Java NetBeans

  4. Нажмите кнопку "Проверить".
    В среде IDE отображается представление дерева с результатами анализа с конфигурацией Подсказки Java NetBeans в окне 'Инспектор'.

    Запущена конфигурация 'Подсказки Java NetBeans'

  5. В окне 'Инспектор' нажмите кнопку Категоризировать на панели инструментов слева для просмотра проблем, сгруппированных в категории.

    Найденные проблемы, сгруппированные в категории

    В следующей таблице перечислены команды, доступные в окне 'Инспектор'.
    Значок Имя Функция
    Значок 'Обновить' Обновить Отображается обновленный список результатов статического анализа.
    Значок 'Предыдущий' Предыдущая проблема Отображается предыдущая проблема в списке результатов статического анализа.
    Значок 'Далее' Следующая проблема Отображается следующая проблема в списке результатов статического анализа.
    Значок 'Категоризировать' Категоризировать Переключение свернутого представления проблем, обнаруженных в файле, проекте или пакета или категоризированного представления всех обнаруженных проблем.

Поиск возможных проблем в коде Java с помощью Findbugs

Конфигурация FindBugs, доступная в IDE, позволяет найти широкий диапазон возможных проблем в коде. Он вызывает популярный инструмент FindBugs для работы с открытым исходным кодом для анализа кода Java. Создается отчет об ошибках, и он отображается в окне реорганизации в IDE NetBeans, в котором разделяются по категориям все обнаруженные проблемы, и обеспечивается возможность навигации напрямую от ошибок в отчете к подозрительному коду. Также можно прочитать описание ошибок в смежном окне или просмотреть его на странице Описание ошибок FindBugs спомощью указателя в верхней части левого фрейма.

Примечание. Необходимо установить подключаемый модуль FindBugs для запуска этой конфигурации в первый раз.

Для определения возможных ошибок в коде Java с помощью конфигурации FindBugs выполните следующие шаги:

  1. Откройте проект library в IDE NetBeans и выберите 'Исходный код' > 'Проверка' в главном меню.
  2. В раскрывающемся списке 'Область' диалогового окна 'Проверка' выберите Текущий проект (библиотека).

    Примечание. Можно проверить файлы, пакеты или проекты с помощью конфигурации FindBugs.

  3. В диалоговом окне 'Проверка' выберите конфигурацию FindBugs.

    Выбрана конфигурация 'FindBugs'

  4. Щелкните кнопку 'Инспектор' для запуска статического анализа кода.
    Результат статического анализа кода отображается в окне 'Инспектор' ниже редактора исходного кода.
    Описание выбранной проблемы отображается в фрейме справа.

    Окно реорганизации

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

    Найденные проблемы, сгруппированные в категории

Примечания

  • Если дважды щелкнуть проблему в развернутом списке, в IDE отображается указанная в отчете проблема в редакторе исходного кода.
    Нажмите Alt-Enter для просмотра описания проблемы в исходном коде.

    Описанная в отчете проблема в редакторе исходного кода

  • Возможные проблемы выделены в коде значком восклицательного знака (значок восклицательного знака) на левой границе редактора исходного кода.

Для включения FindBugs в редакторе Java выполните следующие шаги:

  1. Выберите 'Сервис' > 'Параметры' на главной панели инструментов IDE.
  2. Перейдите на вкладку 'Редактор' и выберите 'Подсказки'.
  3. Выберите FindBugs в раскрывающемся списке 'Язык'.

    Включение FindBugs в редакторе исходного кода

  4. Выберите 'Выполнить FindBugs' в параметре 'Редактор'.
  5. Нажмите кнопку "ОК".
    Если сейчас нажать Alt-Enter в исходном коде, где сообщается о проблеме, и щелкнуть черную стрелку в конце отображаемой подсказки, в IDE показываются некоторые варианты исправления возможных проблем.

    FindBugs включен в редакторе исходного кода

Настройка конфигурации по умолчанию

Во время работы над кодом может потребоваться настроить заранее определенную конфигурацию, которая включает в себя собственные подсказки Java NetBeans или ошибки FindBugs.

Для персонализации заранее настроенной конфигурации По умолчанию в соответствии с требованиями, выполните следующие шаги:

  1. Выберите 'Источник' > 'Проверка' на главной панели инструментов IDE.
  2. В диалоговом окне 'Проверка' выберите переключатель 'Конфигурация' и выберите конфигурация по умолчанию.
  3. Нажмите Управлять.
    IDE отображает диалоговое окно 'Конфигурации'.

    Диалоговое окно 'Конфигурация'

  4. Убедитесь, что в раскрывающемся списке 'Конфигурация' выбрано По умолчанию .
  5. В раскрывающемся списке 'Средство анализа' выберите средство анализа Соответствие профилей JRE 8, Подсказки Netbeans Java или FindBugs.
  6. В зависимости от выбранного средства анализа в предыдущем шаге выберите профиль, проверки или ошибки, которые необходимо включить в конфигурацию по умолчанию.

    Выбор проверок

  7. Нажмите ОК, чтобы сохранить конфигурацию По умолчанию.

Создание и удаление конфигурации

Пользователи могут создавать и удалять свои собственные конфигурации, которые будут использоваться в статическом анализе кода Java.

Для создания конфигурации выполните следующие шаги:

  1. Выберите 'Источник' > 'Проверка' на главной панели инструментов IDE.
  2. В диалоговом окне 'Проверка' выберите переключатель 'Конфигурация' и выберите конфигурация по умолчанию.
  3. Нажмите Управлять.
  4. В диалоговом окне 'Конфигурация' щелкните черную стрелку в конце раскрывающегося списка 'Конфигурация' и выберите 'Создать'.

    Создание конфигурации

    Создается конфигурация newConfig и добавляется в раскрывающийся список 'Конфигурации'.

    newConfig в списке 'Конфигурация'

  5. В раскрывающемся списке 'Средство анализа' выберите Соответствие профилей JRE 8, Подсказки Netbeans Java или FindBugs.
  6. Укажите профиль, проверки или ошибки для включения в вашу конфигурацию.
  7. Нажмите ОК, чтобы сохранить правки и закрыть диалоговое окно 'Конфигурацию'.
    Созданная конфигурация newConfig доступна в раскрывающемся списке 'Конфигурация' в диалоговом окне 'Инспектор'.

    Создана новая конфигурация

Примечание. Чтобы переименовать конфигурацию, выберите конфигурацию newConfig в раскрывающемся списке 'Конфигурация', щелкните черную стрелку в конце раскрывающегося списка 'Конфигурация' и выберите 'Переименовать'. Введите новое имя (например, renamedConfig) и нажмите клавишу Enter, чтобы сохранить правки.

newConfig переименован

Для удаления конфигурации выполните следующие шаги:

  1. Выберите 'Источник' > 'Проверка' на главной панели инструментов IDE.
  2. В диалоговом окне 'Проверка' нажмите переключатель 'Конфигурация' и выберите конфигурацию для удаления (в этом примере renamedConfig).
  3. Нажмите Управлять.
  4. В диалоговом окне 'Конфигурации' щелкните черную стрелку в конце раскрывающегося списка 'Конфигурация' и выберите 'Удалить'.

    Удаление renamedConfig

  5. В диалоговом окне 'Удалить конфигурацию' щелкните 'Да', чтобы подствердить удаление конфигурации.

    Подтверждение удаления renamedConfig

    Конфигурация renamedConfig удалена из списка 'Конфигурации'.

Примечание. Lля получения информации о том, как создать модуль NetBeans, который предоставляет одну или несколько подсказок Java NetBeans см. Учебный курс по модулю подсказок Java NetBeans.

Выполнение отдельных проверок

Исходный код можно проверить на наличие определенной проблемы в с помощью функции статического анализа в IDE NetBeans.

Для выявления конкретного несоответствия или проблемы в исходном коде Java при выполнении одной проверки, выполните следующие шаги:

  1. Выберите 'Источник' > 'Проверка' в главном меню IDE.
  2. В раскрывающемся списке 'Область' диалогового окна 'Проверка' укажите файл, пакет или проект(-ы), которые требуется проверить.
  3. Выберите 'Отдельная проверка' и выполните одно из следующих действий:
    • В раскрывающемся списке 'Отдельная проверка' с помощью прокрутки перейдите и выделите одну подсказку Java NetBeans или проблему FindBugs, которые будут использоваться при анализе исходного кода.

      Раскрывающийся список 'Отдельная проверка'

    • Щелкните 'Обзор', чтобы открыть диалоговое окно 'Конфигурации', и в раскрывающемся списке 'Средство анализа' укажите средство анализа, выберите профиль (для средства анализа Соответствие профиля JRE 8), одну проверку (для средства анализа NetBeans Java Hints) и одну ошибку (для средства анализа NetBeans Java Hints), которая будет использоваться в анализе исходного кода. Нажмите кнопку 'ОК', чтобы закрыть диалоговое окно 'Конфигурации'.

      Диалоговое окно 'Обзор проверок'

  4. В диалоговом окне 'Проверка' щелкните 'Проверка', чтобы выполнить анализ исходного кода.
    После завершения операции 'Проверка', подсказки, которые могут быть применены к коду или проблемам, которые были найдены, отображаются в окне 'Инспектор' ниже редактора исходного кода.

Заключение

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

В начало


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

Связанные материалы можно найти в следующих документах:

В начало

get support for the NetBeans

Support


By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo