Советы и приемы (JDT)

Приведенные далее советы помогут повысить эффективность работы. Общие рекомендации Eclipse также приведены в разделе Рекомендации и приемы для платформы и описание функций в этом выпуске - в Новое в 3.6 (JDT).


Редактирование   |   Рефакторинг   |   Поиск   |   Навигация   |   Панели   |   Разное   |   Отладка


Редактирование исходного кода

Помощник по работе с содержимым Помощник по работе с содержимым предоставляет варианты завершения частично введенных строк. В редакторе Java нажмите клавиши Ctrl+Пробел или вызовите Правка > Помощник по работе с содержимым.

Окно выбора помощника по работе с содержимым

Помощник по работе с содержимым в комментариях Javadoc Помощник по работе с содержимым доступен также и в комментариях Javadoc.

Помощник по работе с содержимым для комментариев Javadoc

Помощник по работе с содержимым для импорта статических элементов Для того чтобы открыть список вариантов помощника по работе с содержимым для статических элементов, настройте список избранных статических элементов на странице параметры Избранного Java > Редактор > Помощник по работе с содержимым > Избранное.

Например, если в этот список добавлен java.util.Arrays.*, то все статические методы этого типа, совпадающие с приставкой, будут добавлены в список вариантов:

варианты помощника по работе с содержимым

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

Страница параметров фильтрации типов

Применение помощника по работе с содержимым для завершения переменных, параметров методов и имен полей Помощник по работе с содержимым можно использовать для ускоренного создания полей, параметров методов и локальных переменных. Установив курсор после имени типа объявления, нажмите клавиши Ctrl+Пробел или выберите Правка > Помощник по работе с содержимым.

Варианты завершения имени полей

Если для полей, локальных переменных или параметров методов используются имена с префиксами и суффиксами, убедитесь, что эти префиксы и суффиксы заданы на странице параметров Стиль кода Java > Стиль кода.

Помощник по работе с содержимым для переменных с неизвестным типом Помощник по коду также работает при обращении к еще не импортированным типам. В зависимости от параметра параметры помощника по работе с содержимым Java > Редактор > Помощник по работе с содержимым > Добавить import вместо полного имени редактор будет либо автоматически добавлять объявление import, либо приводить полные типа для таких вариантов.

Нажмите ;, как показано ниже:

помощник по работе с содержимым для переменных неизвестных типов

и результат этого действия:

помощник по работе с содержимым - ';'

Помощник по работе с содержимым после условия instanceof Помощник по работе с содержимым может предлагать элементы, доступные в типах, используемых в условиях instanceof.

Моментальная копия экрана - Помощник по работе с
содержимым после условия
instanceof

Eclipse добавит необходимое завершение при выборе такого предложения.

Подсказки для параметров Если установить курсор в параметр метода, то появится список подсказок для параметра. В Редакторе Java нажмите клавиши Ctrl+Shift+Пробел или вызовите Правка > Помощник по работе с содержимым > Подсказки для параметров.

Всплывающая подсказка для параметра

Помощник по работе с содержимым для анонимных классов Помощник по работе с содержимым полезен и при создании анонимных классов. Установите курсор после "создать " и в начале имени абстрактного класса или интерфейса и нажмите клавиши Ctrl+Пробел или выберите Правка > Помощник по работе с содержимым > По умолчанию.

Помощник по работе с содержимым для анонимного класса

Будет создано тело анонимного класса, включающее все методы, которые требуется реализовать.

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

Помощник по работе с содержимым для анонимного класса

Переключение помощника по работе с содержимым в режим вставки или замены При вызове помощника по работе с содержимым для существующего идентификатора помощник может либо заменить этот идентификатор выбранным вариантом завершения кода, либо вставить этот вариант после идентификатора. Режим (замена или вставка), действующий по умолчанию, указан на странице параметров помощник по работе с содержимым Java > Редактор > Помощник по работе с содержимым.
Можно временно переключиться в другой режим, если внутри окна выбора варианта завершения, предлагаемого помощником по работе с содержимым, при выборе варианта завершения нажать и удерживать клавишу Ctrl.
Дополняющий помощник по работе с содержимым Помощник по работе с содержимым может также Вставлять общие префиксы автоматически, как оболочка Unix. Этот режим можно включить на странице параметров помощник по работе с содержимым Java > Редактор > Помощник по работе с содержимым.
Поддержка смешанного регистра в дополнениях кода Дополнение кода поддерживает смешанный регистр в шаблонах. Например, в качестве дополнения для NPE или NuPoiE будет предложено NullPointerException. Эта поддержка может быть выключена опцией Показать совпадения со смешанным регистром на странице помощник по работе с содержимым Java > Редактор > Помощник по работе с содержимым.

редактор Java - дополнение NPE

Настройка категорий помощника по работе с содержимым Горячая клавиша помощника по работе с содержимым (Ctrl+Space) позволяет по циклу переходить по вариантам дополнений.

помощник по работе с содержимым

Для того чтобы настроить показываемые категории, откройте страницу параметров помощник по работе с содержимым Java > Редактор > Помощник по работе с содержимым > Дополнительно.

Можно также назначить разные клавиши разным категориям дополнений.

Создание методов get и set Для того чтобы создать методы get и set для поля, выберите объявление поля и вызовите Исходный код > Генерировать методы get и set.

Окно Создать методы  get и set

При использовании имен с префиксами и суффиксами убедитесь, что эти префиксы и суффиксы заданы на странице параметров Стиль кода Java > Стиль кода.
Быстрая помощь при создании методов get и set Для полей создания методов get и set доступна быстрая помощь (Ctrl+1).

Моментальная копия экрана, иллюстрирующая быструю помощь при создании методов get и set

Используйте помощник по работе с содержимым для создания методов get и set Другой способ создания методов get и set заключается в использовании помощника по работе с содержимым. Установите курсор между элементами в теле типа и нажмите клавиши Ctrl+Space для получения вариантов заготовок для методов get и set.
помощник по работе с содержимым
Удаляйте методы get и set вместе с полем Когда поле удаляется из панели, Eclipse может предложить удалить его методы get и set. При использовании имен с префиксами и суффиксами для полей убедитесь, что эти префиксы и суффиксы заданы на странице параметров Стиль кода Java > Стиль кода.
Создавайте методы делегата Для того чтобы создать для поля метод делегата, выберите объявление этого поля и вызовите Исходный код > Генерировать методы делегата. Выбранные методы будут добавлены в тип, содержащий прямой вызов делегируемых методов. Вот пример метода делегата:
Пример метода делегата
Создание hashCode() и equals() Для того чтобы создать методы hashCode() и equals(), выберите Исходный текст > Сгенерировать hashCode() и equals().

Окно hashCode() и equals()

Для создания метода используйте шаблоны Шаблоны будут показаны вместе с вариантами, предлагаемыми Помощником по работе с содержимым (Ctrl+Space).
Некоторые шаблоны уже существуют, например, 'private_method', 'public_method', 'protected_method' и другие, но можно создавать и собственные шаблоны.

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

Для создания виджетов SWT используйте шаблоны В проектах, в пути к классам которых имеется библиотека SWT, можно создавать виджеты SWT с помощью Помощника по работе с содержимым (Ctrl+Пробел)

Например, для того чтобы добавить кнопку SWT, введите Кнопка и нажмите Ctrl+Пробел, выберите шаблон SWT Кнопка и нажмите Enter.

Создание кнопки с помощью шаблона Кнопка

Для просмотра списка всех доступных шаблонов перейдите на страницу параметров Открывает страницу параметров Шаблоны Java > Редактор > Шаблоны или откройте панель Шаблоны, выбрав Окно > Показать панель > Другая....

Создавайте свои собственные шаблоны Для создания собственного шаблона перейдите на страницу параметров Шаблоны Java > Редактор > Шаблоны и нажмите кнопку Создать. Например, шаблон цикла, в котором переменная цикла пробегается в обратном направлении, может выглядеть следующим образом:

шаблон итератора

Для создания нового метода используйте функцию быстрого исправления Для того чтобы создать новый метод, начните с его вызова и используйте Быстрое исправление (Ctrl+1).

Быстрое исправление 'Создать метод'

Используйте функцию быстрого исправления для изменения сигнатуры метода Добавьте параметр в вызов метода в месте вызова. Затем с помощью быстрого исправления (Ctrl+1) добавьте требуемый параметр в объявление метода.

Быстрое исправление 'Изменить сигнатуру'

Для создания заготовки конструктора используйте помощник по работе с содержимым В том месте, где требуется добавить новый конструктор, введите первые буквы его имени и вызовите помощник по работе с содержимым.
Создание конструктора в помощнике по работе с содержимым
Создавайте новые поля из параметров Вам нужно создать новое поле для хранения параметров, передаваемых в конструктор? Применение быстрой помощи (Ctrl+1) для параметра позволяет создать присваивание и объявление поля и получить от Eclipse вариант имени, соответствующий параметрам Стиля кода.
Быстрая помощь 'Присвоить параметр новому полю'
Для переопределения метода используйте помощник по работе с содержимым Вызовите Помощник по работе с содержимым (Ctrl+Space) в том месте тела типа, где необходимо добавить метод. Помощник предложит все методы, которые могут быть переопределены. Для выбранного метода будет создано тело.

Помощник по работе с содержимым 'Переопределить метод'

Используйте быстрое исправление для добавления нереализованных методов Для реализации нового интерфейса сначала добавьте в тип объявление 'implements'. Даже если не выполнять сохранение или компоновку, редактор Java подчеркнет этот тип, предупреждая об отсутствии методов, и покажет значок Быстрого исправления в виде электролампы. Щелкните на этом значке или нажмите клавиши Ctrl+1 (Правка > Быстрое исправление), чтобы выбрать один из следующих вариантов: добавить нереализованные методы или сделать класс абстрактным.

Быстрое исправление, предлагающее вариант 'Добавить нереализованные методы'

Используйте очистку для добавления нереализованных методов При добавлении нового метода к интерфейсу или абстрактного метода к абстрактному классу, Eclipse может создавать заготовки методов во всех конкретных классах одновременно. Вызовите Исходный код > Очистить... для набора элементов Java, используйте пользовательский профайл и выберите окно Настроить..., для того чтобы Добавить нереализованные методы на вкладке Отсутствующий код.
Переопределяйте метод из базового класса Для того чтобы создать метод, который переопределяет метод базового класса:
Выберите тип, в который должны добавляться методы, и вызовите Исходный код > Переопределить / Реализовать методы. Откроется окно, позволяющее выбрать методы для переопределения.

Окно 'Переопределить / Реализовать метод'

Переименование в файлеДля того чтобы быстро выполнить переименование, не требующее полного анализа зависимостей в других файлах, используйте быструю помощь 'Переименовать в файле'. В Редакторе Java установите курсор на идентификатор переменной, метод или тип и нажмите клавиши Ctrl+1 (Правка > Быстрое исправление)
Редактор переключится в режим связанного редактирования (как в случае шаблонов), и изменение идентификатора приведет к одновременному изменению всех других ссылок на эту переменную, метод или тип.

Изменение нескольких идентификаторов с использованием функции быстрой помощи 'Локальное переименование'

Это же достигается клавишей Ctrl+2 R. Настроить комбинации клавиш можно на странице клавиши Общие > Клавиши.
Используйте Быстрое исправление для обработки исключительных ситуаций Работать с возбуждаемыми ситуациями достаточно легко. Необработанные ситуации обнаруживаются при вводе в редакторе и маркируются строкой красного цвета.
  • Щелкните на значке лампы или нажмите клавиши Ctrl+1, чтобы окружить вызов блоком try catch. Если в блок try необходимо включить несколько операторов, выберите эти операторы и вызовите Исходный код > Окружить > блоком try/блоком catch. Можно также выбрать отдельные операторы; для этого выберите опцию Правка > Распространить на , а затем пункт Окружающий, Следующий или Предыдущий.
  • Если вызов уже окружен блоком try, Быстрое исправление предложит добавить в него блок catch.
  • Если вы не хотите обрабатывать ситуацию, пусть Быстрое исправление добавит новую возбуждаемую ситуацию в объявление окружающего метода

Варианты Быстрого исправления 'Неперехватываемая ситуация'

Блок catch в любой момент можно заменить операцией генерирования ситуации (throw). Используйте для блока catch клавиши Ctrl+1 (Правка > Быстрое исправление).

Быстрая помощь 'Заменить предложение catch операциями throw'

Полуавтоматический ввод операторов присваивания Начинайте ввод не с присваивания, а с присваиваемого выражения.

Быстрая помощью 'Присвоить оператор локальной переменной'

Теперь нажмите клавиши Ctrl+1 (Правка > Быстрое исправление) и выберите 'присвоить оператор новой локальной переменной'; Быстрая помощь покажет предполагаемое имя переменной.
Быстрая помощь при присваивании
Полуавтоматическая обработка выражений с приведением типов Не тратьте слишком много времени на приведение типов. При вводе оператора их можно игнорировать, а затем после завершения оператора вызвать Быструю помощью для добавления операции приведения типов.

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

Присвоить выражение с преобразованием типов
После проверки 'instanceof' часто выполняется приведение типа, и значение выражения присваивается локальной переменной. Быстрая помощь (Ctrl+1) на слове 'instanceof' или в начале блока избавит вас от лишних нажатий на клавиши:
Быстрое исправление- 'Создать локальную переменную после приведения типа'
Окружайте строки Для того чтобы поместить операторы в оператор или блок if / while / for, выберите нужные строки и нажмите Исходный код > Окружить или Alt+Shift+Z.

Быстрая помощь 'Окружить шаблонами'

Пункты в меню получаются из шаблонов редактора, все шаблоны, содержащие переменную ${line_selection}, будут показаны в меню.

Шаблоны можно изменять на странице параметров Шаблоны Java > Редактор > Шаблоны. Для получения нужного окончательного кода измените существующие шаблоны или определите свои собственные.
Дополнительные быстрые помощь и исправления
Прочитайте раздел Быстрая помощь, чтобы ознакомиться с полным списком доступных преобразований кода. Список быстрых исправлений приведен здесь.
Горячие клавиши для быстрых исправлений и помощи
Некоторые из часто применяемых вариантов быстрой помощи, такие как Переименовать в файле и Присвоить локальной переменной вызываются с помощью Ctrl+2 R и Ctrl+2 L. Список горячих клавиш для других вариантов доступен на странице параметров Клавиши Общие > Клавиши.

Введите "Быстрая помощь" или "Быстрое исправление" в поле фильтра:

Страница параметров с клавишами для быстрой помощи

Помощник по работе с содержимым может автоматически вставлять имена параметров Можно заставить помощник по работе с содержимым автоматически вставлять имена параметров в завершение метода. Эту опцию можно настроить на странице параметров помощник по работе с содержимым Java > Редактор > Помощник по работе с содержимым (см. переключатель Заполнять аргументы метода и отображать предполагаемые аргументы). Например, если выбрать в показанном ниже окне вторую запись,

помощник по работе с содержимым

помощник по работе с содержимым автоматически вставит имена параметров:

помощник по работе с содержимым

Для перехода по вставленным именам используйте клавишу табуляции.

При выборе опции Вставить наиболее подходящие аргументы по умолчанию будут вставлены наиболее подходящие из предполагаемых элементов. Альтернативные предложения при этом остаются доступными.

Автоматическая вставка аргументов типа
При работе с параметризованными типами в J2SE 5.0 также полезно включить опцию Подставлять аргументы методов и показывать предполагаемые аргументы на странице параметров помощник по работе с содержимым Java > Редактор > Помощник по работе с содержимым.
помощник по работе с содержимым
и результат этого действия:
помощник по работе с содержимым
Удаление окружающего оператора Для того чтобы удалить окружающий оператор или блок, поместите курсор на открывающую или закрывающую скобку и нажмите клавиши Ctrl+1 (Правка > Быстрое исправление).

Быстрая помощь 'Удалить окружающий оператор'

Повторная проверка слова Поддержку проверки орфографии в редакторе Java можно включить на странице параметров Орфография Общие > Редактор > Текстовые редакторы > Орфография. Орфографические ошибки отображаются в редакторе Java; для них доступны соответствующие Быстрые исправления:

Пример варианта исправления орфографических ошибок.

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

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

Выделите текст и нажмите клавиши Alt+Shift+Стрелка вверх или выберите в меню пункт Правка > Распространить выбор на > Окружающий элемент; выбор будет распространен на наименьший элемент синтаксиса Java, содержащий выделенный текст. Выбор можно распространять и далее, повторно вызывая указанное действие (или другие действия из меню Распространить выбор на).

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

Поиск парной скобки Для того чтобы найти парную скобку, выберите открывающую или закрывающую скобку и нажмите клавиши Ctrl+Shift+P (Навигация> Перейти > Парная скобка). Можно также дважды щелкнуть кнопкой мыши рядом со скобкой: при этом будет выбран текст, заключенный в скобки.

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

Редактор Java также поддерживает выделение парных квадратных скобок.

Парные квадратные скобки

Эту опцию можно настроить на странице параметров Открывается страница
параметров редактора Java Java > Редактор.

Интеллектуальный Javadoc Введите '/**' и нажмите Enter. Автоматически будет добавлена заглушка комментария Javadoc, содержащая стандартные теги @param, @return и @exception.

Результат 'Интеллектуального Javadoc'

Шаблоны для нового комментария можно настроить на странице параметров шаблоны кода Java > Стиль кода > Шаблоны кода.
Используйте локальную хронологию для возврата к предшествующему варианту метода При редактировании файла содержимое его предыдущих версий сохраняется в локальной хронологии. Инструментарий Java делает локальную хронологию доступной элементам Java, поэтому пользователь может вернуться к предыдущему варианту отдельного метода, не открывая весь файл целиком.

Для возврата предыдущему варианту элемента выберите этот элемент (например, в панели Схема) и воспользуйтесь опцией Заменить на > Локальная хронология.

Окно диалога Заменить из локальной хронологии

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

Для восстановления каких-либо удаленных элементов выберите контейнер (например, в панели Схема) и вызовите команду Восстановить из локальной хронологии.

Окно диалога Восстановить из локальной хронологии

Настраиваемая генерация кода На странице параметров Шаблоны кода Java > Стиль кода > Шаблоны кода можно настроить пользовательские шаблоны для генерации кода и комментариев, как обычные шаблоны. Эти шаблоны кода будут всегда применяться при генерации кода.

Шаблоны кода

Начиная с версии 3.1 возможно применять шаблоны кода для отдельных проектов, которые также будут использоваться совместно, если проект является общим. Откройте Свойства проекта, чтобы задать особые параметры для проекта.
Создавайте комментарии в коде Комментарии можно добавлять явно с помощью команды Исходный код > Добавить элемент комментария (Alt+Shift+J) или автоматически с помощью различных мастеров, действий рефакторинга или быстрых исправлений.
Шаблоны комментариев можно настраивать на странице параметров Шаблоны кода Java > Стиль кода > Шаблоны кода.
Включить или отключить автоматическое создание комментариев можно либо прямо в мастере (например, с помощью переключателя Генерировать комментарии мастера создания типов Java, либо с помощью переключателя Автоматически добавлять комментарии для новых методов и типов на странице параметров Открывает страницу параметров шаблонов кода Java > Стиль кода > Шаблоны кода.
Все эти параметры можно настроить для отдельных проектов. Откройте Свойства проекта, чтобы задать особые параметры для проекта.
Сортировать элементы Можно сортировать элементы единицы компиляции Java или набора таких единиц в соответствии с порядком категорий, определенным на странице параметров Порядок сортировки элементов Java > Вид > Порядок сортировки элементов.
Это действие располагается на вкладке Исходный код > Сортировать элементы.
Перенос строк При редактировании строковых констант их можно переносить. Например, если есть следующий код:
String message= "Это очень длинное сообщение.";

установите курсор после слова "очень" и нажмите клавишу Enter. Код автоматически изменится и приобретет следующий вид:

String message= "Это очень" + 
           " длинное сообщение.";

Эту опцию можно изменить на странице параметров Ввод текста Java > Редактор > Ввод текста.

Интеллектуальный ввод с клавиатуры и управление им Опции интеллектуального ввода с клавиатуры редактора Java сильно облегчают повседневную работу. Эти опции можно изменить на странице параметров Ввод текста Java > Редактор > Ввод текста.

Страница параметров ввода с клавиатуры Редактора Java

Опция Автоматически вставлять точку с запятой в правильной позиции позволяет помещать курсор в конце оператора при вводе точки с запятой. Это избавляет от необходимости перемещать курсор вручную.
Для удаления автоматически вставленной точки с запятой следует сразу нажать клавишу backspace.

Исправление отступов в коде одним нажатием клавиши Воспользуйтесь опцией Исходный код > Корректировать отступы или Ctrl+I.
Выберите код, содержащий неправильные отступы, и вызовите указанное действие.

Если ничего не выбрано, отступ будет увеличен для текущей строки.

Исправление отступов в коде при сохранении Eclipse может корректировать отступы в коде при сохранении редактора. Перейдите на страницу параметров Открывает страницу параметров Действия при сохранении Java > Редактор > Действия при сохранении, выберите Настроить... Дополнительные действия, затем выберите Исправить отступы на вкладке Структура кода.
Меню быстрого доступа для действий над исходным кодом и операций рефакторинга К операциям рефакторинга и действиям над исходным кодом можно обращаться с помощью меню быстрого доступа. Выберите нужный элемент в редакторе Java или панели Java и нажмите клавиши Alt+Shift+S для вызова меню быстрого доступа для исходного кода, клавиши Alt+Shift+T - для рефакторинга или Alt+Shift+Z - для операции включения фрагмента.

Меню быстрого доступа к операциям рефакторинга

Поиск неиспользуемого кода Компилятор Java обнаруживает недостижимый код, неиспользуемые переменные, параметры и директивы импорта, а также неиспользуемые закрытые типы, методы и поля. Измените параметры обнаружения на странице Ошибки/предупреждения Java > Компилятор > Ошибки/предупреждения. Эти параметры также можно указать для проекта: Проект > Свойства > Компилятор Java > Ошибки/предупреждения.

Страница параметров компилятора

Все эти элементы обнаруживаются при вводе, и функция быстрого исправления предлагает удалить неиспользуемый код. Удалить ненужный код можно также с помощью действия Исходный код > Очистить....
Поиск ошибок в применении null Компилятор позволяет найти ошибки с null в коде. На странице параметров Ошибки/предупреждения Java > Компилятор > Ошибки/Предупреждения есть три опции для поиска неполадок.
  • Обращение указателя к Null ('Потенциальные ошибки программирования')
    Если эта опция включена, то компилятор будет сообщать об ошибке или предупреждении при любой попытке использования переменной, которая статически ссылается на null, для получения доступа к полю или методу, см.

    Пример обращения указателя к Null


  • Возможное обращение указателя к null ('Потенциальные ошибки программирования')
    Если эта опция включена, то компилятор будет сообщать об ошибке или предупреждении при любой попытке использования переменной, которая может статически ссылаться на null.

    Пример возможного обращения указателя к null


  • Лишняя проверка на null ('Ненужный код')
    Если эта опция включена, то компилятор будет сообщать об ошибке или предупреждении при любой попытке сравнения с null переменной, которая статически равна или не равна null, см.

    Лишняя проверка на null


    Лишняя проверка на null

Поиск ошибок в экспортированных строках Действие Исходный код > Найти неработающие экспортированные строки позволяет найти неопределенные, неиспользуемые и повторяющиеся ключи:

Пример результата поиска экспортированной строки

Изменение серьезности неполадки в подсказке для неполадки При отображении подсказки для неполадки (путем нажатия клавиши F2 или наведении курсора мыши на подсказку) становится доступным действие изменения серьезности текущей неполадки.

Расширенная подсказка для неполадки

Нажмите кнопку в панели инструментов для перехода к странице параметров Открывает страницу параметров Ошибки/Предупреждения Java > Компилятор > Ошибки/Предупреждения.

Обработка комментариев Javadoc Компилятор Java Eclipse может обрабатывать комментарии Javadoc. Средство поиска находит ссылки в комментариях doc, которые обновляются с помощью рефакторинга. Эта функция включается на странице неполадки Javadoc Java > Компилятор > Javadoc (или устанавливается для отдельного проекта с помощью опций Проект > Свойства > Компилятор Java > Javadoc).

Страница параметров Javadoc

Если указанная функция включена, то неправильные комментарии Javadoc маркируются в редакторе Java, и их можно исправить с помощью Быстрого исправления Правка > Быстрое исправление (Ctrl+1):

Ошибки в Javadoc

выключить предупреждения В J2SE 5.0 и выше все необязательные предупреждения компилятора можно выключить аннотацией SuppressWarnings.
В этом примере метод addAll() помечен как неиспользуемый. Для добавления аннотации SuppressWarnings используется Быстрое исправление (Ctrl+1). После этого для этого метода предупреждение показываться не будет.
Быстрое исправление - добавить аннотацию SuppressWarning
Очистка Действие Исходный код > Очистить... устраняет группы неполадок и позволяет унифицировать стиль кода. Например, можно выполнить следующее:
  • преобразовать все циклы for в расширенные циклы for.
  • пометить все переопределяющие методы в проекте аннотацией @Override.
  • реорганизовать объявления импорта
  • отформатировать код
  • удалить неиспользуемый код

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

Очистка

Операции очистки могут выполняться в качестве действий при сохранении. Для того чтобы настроить операции очистки, вызываемые при сохранении, перейдите на страницу параметров Открывает страницу параметров Действия при сохранении Java > Редактор > Действия при сохранении.

Рефакторинг

Сценарии рефакторинга Большая часть операций рефакторинга в JDT может выполняться как интерактивно, так и посредством сценариев.

Создайте сценарий рефакторинга из хронологии рефакторинга, вызвав Рефакторинг > Создать сценарий....

Сценарий рефакторинга можно впоследствии выполнить в рабочей области, вызвав Рефакторинг > Выполнить сценарий....

Сценарии рефакторинга позволяют автоматизировать задачи исправления измененных API или применения сложных исправлений.
Безопасный перенос файлов JAR При экспорте файла JAR из рабочей области мастер экспорта JAR предлагает включить информацию о рефакторинге в файл JAR.

Выберите Файл > Экспорт... и далее Файл JAR. На первой странице мастера экспорта JAR выберите Экспортировать операции рефакторинга для выбранных проектов. Щелкните на ссылке, чтобы указать операции рефакторинга.

После этого клиенты смогут перенести старую версию файла JAR с помощью рефакторинга Рефакторинг> Перенести файл JAR.... Этот рефакторинг автоматически обновляет код, применяющий старую версию файла JAR.

Поиск

Поиск переменных и обращений к ним для чтения/записи Для того чтобы найти переменную и просмотреть ее состояние чтения/записи, следует выбрать идентификатор (переменную, ссылку на тип или метод или объявление) и вызвать Поиск > Вхождения в файл > Идентификатор. Будут помечены все ссылки на этот идентификатор в файле. Результаты будут также показаны в панели Поиск (причем обращения для чтения и записи - разным цветом), вместе со значками, отображающими обращение к этой переменной для чтения или записи.

Обращение к полю для чтения или записи

Опция Маркировать вхождения позволяет выполнять динамическое выделение вхождений. Можно выполнять поиск в нескольких файлах с помощью общих средств поиска (Поиск > Ссылки).

Поиск методов, возвращающих указанный тип Для поиска методов, возвращающих указанный тип, используйте шаблон "* <return type>":
  • Откройте окно поиска и выберите вкладку Поиск Java.
  • В поле Искать строку введите символ '*' и возвращаемый тип, разделенные пробелом.
  • Отметьте переключатель С учетом регистра.
  • Выберите Метод и Объявления и нажмите кнопку Найти.

Поиск метода, возвращающего заданный тип

Фильтрация результатов поиска в Javadoc По умолчанию функция Поиск Java ищет ссылки внутри кода Java и Javadoc. Если не требуется искать ссылки внутри Javadoc, то эти совпадения можно отфильтровать, включив опцию 'Отфильтровать Javadoc' в меню панели (символ треугольника) или панели Поиск.
Отфильтровать потенциальные совпадения Потенциальные совпадения возникают тогда, когда во время компиляции возникает неполадка, и служба поиска не может найти точное совпадение. Такие совпадения можно отфильтровать опцией Отфильтровать потенциальные совпадения в меню панели Поиск (треугольник).
Трассировка цепочек вызовов метода с помощью иерархии вызовов Новая функция Иерархия вызовов позволяет прослеживать длинные или сложные цепочки вызовов без потери первоначального контекста: достаточно выбрать нужный метод и вызвать опцию Перейти > Открыть иерархию вызовов (Ctrl+Alt+H).

Панель иерархии вызовов

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

По умолчанию для методов из анонимных классов и методов специальных типов (например, Runnable) показаны конструкторы, поскольку в некоторых случаях более важное значение имеет место создания объекта, а не место вызова метода. При необходимости режим отображения можно изменить с помощью переключателя Развернуть с конструкторами. Значения по умолчанию можно настроить в меню панели.

Навигация по коду и чтение

Откройте окно Выбор в редакторе Java Открыть элемент по ссылке в редакторе Java можно двумя способами.
  • Выберите ссылку в коде и нажмите клавишу F3 (Перейти > Открыть объявление)
  • Удерживая нажатой клавишу Ctrl , переместите указатель мыши и щелкните на гиперссылке
Навигация в стиле гиперссылок

При удержании нажатой клавиши Ctrl на переопределяемом методе появляется окно с записью Открыть реализацию, которая непосредственно открывает реализацию, если она одна, или показывает все конкретные реализации для данного метода в иерархии объявляющего ее типа с использованием быстрой иерархии типов.

Навигацию в стиле гиперссылок можно настроить на Открывает страницу Параметры гиперссылок странице параметров, выбрав Общие > Редакторы > Текстовые редакторы > Гиперссылки.
Схемы 'по месту' Для того чтобы получить всплывающую схему элемента в текущей позиции курсора в редакторе Java, нажмите клавиши Ctrl+F3. Для того чтобы получить всплывающую схему текущего файла исходного кода, нажмите Ctrl+O (Перейти > Быстрая схема).

Схема 'По месту'

В схемах 'по месту' отображаются наследуемые элементы Для того чтобы добавить наследуемые элементы в схему, открытую 'на месте', нажмите Ctrl+O или Ctrl+F3. Наследуемые элементы будут помечены синим. Для фильтрации и сортировки схемы применяется меню, расположенное в верхнем правом углу.

Быстрый просмотр схемы

Быстрая схема (Ctrl+O) также показывает наследуемые элементы типа для текущего выбранного элемента в редакторе. Активные типы, которые могут отображать наследуемые элементы, помечены треугольником ( фокус ).
Иерархия 'по месту' С помощью быстрой иерархии типов найдите возможных получателей виртуального вызова. Поместите курсор внутрь вызова метода и нажмите Ctrl+T (Перейти > Быстрая иерархия типов). В панели будут показаны все типы, реализующие этот метод, вместе со значком.

Окно диалога Быстрая иерархия типов

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

Путь в редакторе Java Редактор Java содержит строку навигации Путь, в которой указывается путь к элементу в позиции курсора. Для включения отображения пути нажмите кнопку Переключить показ пути в панели инструментов или нажмите клавиши Alt+Shift+B.

Путь к редактору Java

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

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

Пример расширенного выделения.

Первоначально свернутые области Можно задавать, какие области показываются как свернутые при открытии редактора. Для этого откройте страницу параметров Свертывание Java > Редактор > Свертывание.

Страница параметров свертывания

Маркировка вхождений Работая в редакторе, включите Маркировку вхождений в строке инструментов (Изображение кнопки панели инструментов Маркировать вхождения) или нажмите Alt+Shift+O. В файле будет показана переменная, метод или тип.

Редактор с маркированными вхождениями 'info'

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

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

Параметры маркировки можно изменить на странице параметров Маркировка вхождений Java > Редактор > Маркировка вхождений.
Цвет маркировки можно изменить на странице параметров Аннотации Общие > Редактор > Текстовые редакторы > Аннотации.

Для показа вариантов в панели Поиск используйте действие Поиск > Вхождения.

Переход к следующему / предыдущему методу Для быстрого перехода к следующему или предыдущему методу или полю нажмите клавиши
Ctrl+Shift+Стрелка вверх (или выберите опции Перейти > Перейти к > Предыдущему элементу) или Ctrl+Shift+Стрелка вниз (Перейти > Перейти к > Следующему элементу)
Управление перемещением по аннотациям Кнопки панели инструментов Следующая / Предыдущая аннотация и опции Перейти > Следующая аннотация (Ctrl+.) и Перейти > Предыдущая аннотация (Ctrl+,) позволяют перемещаться по аннотациям в файле исходного кода Java. Аннотации, на которых следует остановиться, можно задать в выпадающем меню кнопки:

Выпадающее меню Следующая/Предыдущая аннотация.

Напоминания в коде Java Если пометить комментарий в исходном коде Java тегом "TODO", то компилятор Java автоматически создаст соответствующую задачу в качестве напоминания. При открытии этой задачи вы вернетесь обратно в этот код к метке "TODO". Другие специальные теги, которые вы хотели бы отслеживать в списке задач (например, "FIXME"), можно задать на странице параметров Задачи Java > Компилятор > Теги задач.

Теги задач в редакторе и панель Задачи

Приемы работы с окном Открыть тип
Окно Открыть тип (Навигация> Открыть тип или кнопка панели инструментов) позволяет найти тип по его имени.
  • Для того чтобы быстро найти тип, введите только заглавные буквы его имени:
    IOOBE для поиска IndexOutOfBoundsException.
    Или введите несколько первых букв каждой части имени:
    NuPoiE для поиска NullPointerException.
  • Для того чтобы просмотреть все типы с заданным суффиксом, например, Tests, применяйте *Test<; чтобы скрыть все типы с Test введите это где-то еще в имени типа.
  • Для того чтобы открыть несколько типов, выберите их и нажмите OK.
Открыть тип - совпадение по заглавным буквам
Сделать всплывающие подсказки закрепленными Текст всплывающей подсказки можно открыть в окне с прокруткой, нажав F2 (Правка > Показать описание подсказки) или наведя на подсказку указатель мыши. В этом окне можно выбирать и копировать содержимое, а также вызывать действия и просматривать ссылки.

Окно, показывающее содержимое всплывающей подсказки

Для того чтобы указать, каким образом должна быть расширена подсказка, перейдите на страницу параметров Открывает страницу параметров Текстовые редакторы Общие > Редакторы > Текстовые редакторы.

Всплывающие подсказки в редакторе Java Для просмотра различных всплывающих подсказок в редакторе Java используйте клавиши-модификаторы (Shift, Ctrl, Alt).
Если в редакторе Java поместить указатель мыши на идентификатор без предупреждения или указания неполадки, то по умолчанию будет показана всплывающая подсказка с Javadoc, извлеченным из соответствующего исходного кода этого элемента. При наличии указания неполадки на идентификаторе подсказка будет содержать соответствующее сообщение. При нажатии клавиши Shift можно увидеть исходный код:

Всплывающая подсказка, содержащая код элемента

Изменить этот режим и определить всплывающие подсказки для других модифицирующих клавиш можно на странице параметров Всплывающие подсказки Java > Редактор > Всплывающие подсказки.
Вычисление сигнатуры параметризуемого метода
Вариант сигнатуры параметризуемого метода показывается при наведении мыши.

Вариант сигнатуры параметризуемого метода показывается при наведении мыши

Открытие и настройка внешней документации по Java Если требуется открыть документацию Javadoc для типа, метода или поля с помощью Shift+F2 (Перейти > Открыть внешнюю документацию Javadoc), то сначала необходимо задать ее расположение для библиотеки (JAR, папка классов) или проекта (папка исходного кода) предка этих элементов.
Откройте для библиотек страницу путей компоновки (Проект > Свойства > Путь к классам Java для компоновки), перейдите на вкладку Библиотеки, разверните узел библиотеки, в котором можно редактировать узел 'Расположение Javadoc'. Документация может быть локальной и находиться в вашей файловой системе в папке или архиве, или она может находиться на веб-сервере.

Настройка расположения Javadoc в окне диалога Путь компоновки Java

Для типов, методов и полей в папках исходного кода перейдите в Проект > Свойств > Расположение Javadoc).

Панели Java

Структуризация рабочей области с многими проектам В меню панели Структура пакетов входит пункт Элементы верхнего уровня > Рабочие наборы. В этом режиме рабочие наборы показываются как элементы верхнего уровня. Этот режим удобен при работе с рабочей областью, содержащей много проектов.

Структура пакетов - режим Рабочие наборы

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

Присвоить рабочие наборы Для того чтобы присвоить элемент другому рабочему набору, выберите элемент в панели Структур а пакетов и выберите в контекстном меню Присвоить рабочие наборы....

Присвоить рабочие наборы

Панель Объявление Панель Объявление ( объявления Java Окно > Показать панель > Прочие > Java > Объявление) отображает исходный код элемента, выбранного в редакторе Java или в панели Java.

Панель Объявление

Панель Javadoc Новая панель Javadoc ( панель Javadoc Окно > Показать панель > Прочие > Java > Javadoc) отображает документацию Javadoc по элементу, выбранному в редакторе Java или панели Java.

Панель Javadoc

Панель Иерархия типов и определения / реализации методов Для того чтобы найти в иерархии типы, переопределяющие методы, воспользуйтесь функцией "Показать элементы в иерархии":
  1. Выберите нужный метод и нажмите F4 (Перейти > Открыть иерархию типов). Панель Иерархия типов откроется на типе, объявляющем данный метод.
  2. Выбрав метод в панели Иерархия типов, нажмите кнопку панели инструментов 'Заблокировать панель и показать элементы в иерархии'.
На панели Иерархия типов будут показаны только типы, которые реализуют или определяют 'блокированный' метод. Например, можно увидеть, что isEmpty() определен в List и реализован в ArrayList и Vector, но не в AbstractList.

Блокировать панель и показать элементы в иерархии

Панель Иерархия типов поддерживает группировку по определяющему типу Панель Метод иерархии типов позволяет сортировать методы выбранного типа по определяющим его типам. Например, тип AbstractList содержит методы, которые были определены в типах Object, Collection и List:

Сортировка элементов в иерархии типов по определению типа

Приемы работы с иерархией типов
  • Активируйте Иерархию типов для нового типа, нажав F4 (Перейти > Открыть иерархию типов) на элементе или выбранном имени.
  • Панель Иерархия типов можно открыть не только для типов, но и для пакетов, папок исходного кода, архивов JAR и проектов Java. Можно выбрать несколько пакетов, исходных папок или проектов и затем открыть иерархию, содержащую все типы в выбранных контейнерах.
  • Для того чтобы активировать иерархию типов для элемента, этот элемент можно с помощью мыши перенести в панель Иерархия типов.
  • С помощью панели инструментов можно изменить ориентацию панели Иерархия типов (с вертикальной, действующей по умолчанию, на горизонтальную).
Структурное сравнение исходного кода Java Структурное сравнение исходного кода Java игнорирует порядок элементов Java (методов и полей) в тексте, и показывает, какие элементы были изменены, добавлены или удалены.
Структурное сравнение файлов Java можно выполнять двумя способами:
  • Выберите две единицы компиляции Java и в контекстном меню панели выберите пункт Сравнить с > Друг с другом. Если в файлах есть различия, то они будут открыты в Редакторе сравнения. Различающиеся элементы Java отображаются в верхней панели; если дважды щелкнуть на одном из этих элементов, то в нижней панели будет показан его исходный код.
  • В любом контексте, допускающем сравнение файлов (например, в панели Синхронизация CVS) дважды щелкните на файле Java. При этом в средстве отображения текстового сравнения будет показано содержимое этого файла, и, кроме того, будет выполнено еще и структурное сравнение с выводом результатов в отдельную панель.

Структурное сравнение исходного кода Java

При выполнении структурного сравнения можно игнорировать изменения в формате; для этого включите опцию Игнорировать пробелы, символы табуляции и пустой строки с помощью кнопки панели инструментов Редактора сравнения или с помощью контекстного меню панели сравнения.
Структурное сравнение файлов свойств При структурном сравнении файлов свойств Java (то есть файлов с расширением .properties) игнорируется порядок свойств в тексте и показывается, какие свойства были изменены, добавлены или удалены.
Структурное сравнение файлов свойств можно выполнять двумя способами:
  • В панели Структура пакета или Навигатор выберите два файла и в контекстном меню панели выберите пункт Сравнить с > Друг с другом.
  • В любом контексте, допускающем сравнение файлов (например, в панели Синхронизация CVS) дважды щелкните на файле свойств. При этом в средстве отображения текстового сравнения будет показано содержимое этого файла, и, кроме того, будет выполнено еще и структурное сравнение с выводом результатов в отдельную панель.

Структурное сравнение файлов свойств

Иерархическая и простая схема пакетов В меню панели Пакеты Java (и панели Структура пакетов) предусмотрена опция, позволяющая изменять способ отображения пакетов. Опция Схема пакета > Иерархическая отображает пакеты в виде дерева, когда подпакеты располагаются ниже пакетов; при выборе опции Схема пакета > Простая выводится простой список, в котором все пакеты и подпакеты располагаются на одном уровне.
Простая схема пакетов Иерархическая схема пакетов
Логические пакеты Панель Пакеты Java (проекция Просмотр Java) объединяет пакеты с одинаковым именем из папок исходного кода одного проекта. Ниже показана панель Пакеты, содержащая логический пакет.

Проекция Просмотр Java, содержащая логический пакет

Сжатие имен пакетов Если имена пакетов очень длинные, можно настроить сжатые имена, которые будут выводиться в средствах отображения. Настройка шаблона сжатия выполняется в окне Вид Java > Вид.

Настройка шаблона сжатия на странице параметров Вид Java

В данном примере пакеты выводятся следующим образом:

Сжатые имена пакетов

Сокращенные имена пакетов Имена пакетов в панелях Java могут сокращаться по настраиваемым правилам. Например, следующие правила дают показанный ниже вывод:
org.eclipse.ui={UI}
org.eclipse.ui.texteditor={T}
org.eclipse.ui.internal.texteditor=[iT]
Без сокращений: С сокращениями:
Структура пакетов с отключенными сокращениями Структура пакетов с включенными сокращениями

Правила сокращения можно настроить на странице параметров Открывает страницу параметров
Внешний вид Java > Внешний вид.

Работа с путем компоновки Java в панели Структура пакетов Вместо изменения пути компоновки Java на странице Проект > Свойства > Путь компоновки Java используйте действия контекстного меню панели Структура пакетов.
Можно добавить новые исходные папки, архивы и библиотеки в путь компоновки, или исключить файл или папку из числа исходных.

контекстное меню

Вставить фрагменты кода для создания типа Фрагмент кода с типом Java можно вставить в пакет или исходную папку, чтобы создать новую единицу компиляции. Например, выберите и скопируйте следующий фрагмент:
package pack;
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World");
    }
}
Затем выберите исходную папку в панели Структура пакетов и нажмите клавиши Ctrl+V (Правка > Вставить). При этом автоматически будет создан пакет 'pack' и файл 'HelloWorld.java' с этим текстом.

Также можно вставить из буфера метод или набор операторов; Eclipse создает необходимые вмещающие элементы автоматически.

Если в панели Структура пакетов ничего не выбрано, то при вставке будет создан новый проект Java, а в нем будут созданы файлы *.java. Буфер обмена может содержать несколько пакетов и объявлений типов, и в этом случае все необходимые пакеты и файлы *.java будут созданы при вставке.

Вставка исправлений на панели Структура пакетов Каким образом, быстрее всего применить исправление из Bugzilla? Откройте вложение, скопируйте исправление в буфер обмена и вставьте его в панель Структура пакетов.
Группировка неполадок Java В меню Вид панели Неполадки включен пункт Сгруппировать по > Типу неполадки Java.

панель Неполадки

На странице параметров Ошибки/предупреждения Java > Компилятор > Ошибки/предупреждения можно указать, будут ли настраиваемые ошибки считаться фатальными.
Индикатор типа Java Индикатор типов Java можно включить на странице параметров оформление меток Общие > Вид > Оформление меток, чтобы найти первый тип в единице компиляции или файле класса. Интерфейсы, аннотации и перечисления выделяются метками, а обычные классы не выделяются.

метки типов Java

Прочее

Особые параметры проекта Стиль кода и опции компилятора можно задавать для каждого проекта в отдельности.
Для того чтобы задать особые параметры проекта, откройте страницу Проект > Свойства или щелкните на ссылке в параметрах рабочей области (например, Стиль кода Java > Стиль кода).

Особые параметры проекта

Особые параметры проекта хранятся в файле конфигурации в проекте (в папке '.settings'). При работе с общим проектом эти особые параметры будут доступны всем участникам.
Правила доступа
Правила доступа задают правила API для типов из связанных библиотек. На странице Проект > Свойства > Путь компоновки Java) измените узел 'Правила доступа' проекта, архива, папки классов или библиотеки.
Пакеты или типы этих ссылок классифицируются как:
  • Доступный
  • Нежелательные
  • Запрещенный
Компилятор выдает сообщения об ошибках или предупреждения о наличии нежелательных и запрещенных ссылок в соответствии с параметрами, указанными в окне Ошибки/предупреждения Java > Компилятор > Ошибки/предупреждения.

окно конфигурации - Правила доступа

JUnit Выберите метод тестирования JUnit в панели и выберите Выполнить > Тест JUnit в контекстном меню или Выполнить > Выполнить как > Тест JUnit в главном меню. Будет создана конфигурация запуска для выполнения выбранного теста.
Как скрыть панель JUnit до появления ошибок или сбоев Можно сделать так, чтобы панель JUnit открывалась только при возникновении ошибок или сбоев. Для этого включите опцию Открывать только при возникновении ошибок или сбоев в меню панели JUnit. Таким образом, набор панелей может существовать как быстрая панель, которая никогда не открывается, если тесты выполняются без ошибок. Если в тестах нет ошибок, то во время их выполнения будет показан значок Выполняется успешно (число зеленых квадратиков будет расти, свидетельствуя о выполнении теста), а по завершении - значок Завершен успешно. Однако при возникновении ошибки или сбоя этот значок изменится на Возникли сбои или ошибки (или Завершен из-за сбоя или ошибки, если тест завершается), и появится панель JUnit.
Помощник по работе с содержимым в полях окон Помощник по работе с содержимым также доступен (клавиши Ctrl+Пробел) в полях ввода различных окон диалога Java. Поищите небольшой значок в виде лампочки рядом с полем, которое активно.

Окно диалога Создание класса

Интеллектуальное размещение курсора в окнах с именами Java В полях для редактирования имен Java поддерживается интеллектуальное размещение курсора. Нажатием Ctrl+Влево и Ctrl+Вправо можно перемещать курсор по словам внутри имени. Ctrl+Shift+Left и Ctrl+Shift+Right позволяют выделять фрагменты имени. Используйте Ctrl+Delete и Ctrl+Backspace для удаления части имени до и после курсора.

Интеллектуальное размещение курсора
Ctrl+Right:
Интеллектуальное размещение курсора
Ctrl+Shift+Right:
Интеллектуальное размещение курсора
write "Equal":
Интеллектуальное размещение курсора
Ctrl+Delete:
Интеллектуальное размещение курсора
write "To":
Интеллектуальное размещение курсора
Определение префиксов или суффиксов для полей, параметров и локальных переменных Префикс и суффикс можно задавать для полей, для статических полей, параметров и локальных переменных. Эти параметры задаются на странице Стиль кода Java > Стиль кода и используется в помощнике по работе с содержимым, быстрых исправлениях и рефакторинге.

страница Стиль кода - соглашения об именах

Опция Упорядочить директивы импорта работает для нескольких файлов Опцию Исходный текст > Упорядочить директивы импорта можно вызывать для набора единиц компиляции, пакетов, папок исходного кода или проектов Java.
Реорганизовать импорты при сохранении Импорты можно реорганизовать автоматически при сохранении редактора. Эту опцию можно включить глобально на странице Действия при сохранении Java > Редактор > Действия при сохранении. Действия при сохранении можно также настроить для проекта, что позволяет применять общие параметры для проекта в группе:

Действия при сохранении

Помимо импорта действия при сохранении могут относиться к форматированию кода, очистке и т.д.

Отформатировать выбранное Выберите для форматирования файлы Java и выберите Исходный код > Форматировать. Это действие по форматированию доступно также для пакетов, папок исходного кода и проектов Java.

В редакторе Java действие Исходный код > Отформатировать (Ctrl+Shift+F) позволяет отформатировать только выбранный фрагмент. Если ничего не выбрано, будет отформатирован весь файл.

Выбор среды выполнения для проекта Java При создании общего проекта Java рекомендуется использовать среду выполнения, а не конкретную JRE.

Среда выполнения - это символическое представление JRE в стандартном виде, например, 'J2SE-1.4', 'J2SE-1.5'. Это означает, что пути файловой системы не будут применяться в общем пути компоновки.

JRE можно связать с средами на странице Среды выполнения Java > Установленные JRE > Среды выполнения.

мастер Создать проект Java

Для того чтобы установить среду выполнения Java существующего проекта, откройте страницу свойств путей к классам Java для компоновки (Проект > Свойства > Путь к классам Java для компоновки), затем страницу Библиотеки, выберите 'Системная библиотека JRE' и нажмите кнопку Изменить. В окне 'Изменить библиотеку' можно выбрать среду выполнения, JRE проекта или JRE рабочей среды по умолчанию.

Перетаскивание мышью Перенос с помощью указателя мыши часто удобнее функций Правка > Вырезать и Правка > Вставить и Правка > Скопировать и Правка > Вставить. Клавиша Ctrl позволяет переключиться между режимами копирования и перемещения.

Учтите следующее:

  • Перетаскивание мышью единиц компиляции Java между пакетами действует как рефакторинг - будут добавлены отсутствующие объявления импорта и обновлены ссылки.
  • Перетаскивание мышью таких элементов кода, как типы и методы, не приведет к обновлению ссылок.
Распространение тега deprecation Компилятор Java может выполнять диагностику устаревшего кода. Параметры диагностики задаются в окне Ошибки/предупреждения Java > Компилятор > Ошибки/предупреждения.

Страница параметров компилятора

Результат использования этой конфигурации будет следующим:

I.java

X.java

Y.java

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

X.java

Y.java

Восстановление согласованности после аварии В редких случаях неправильной работы инструменты разработки JDT может обнаруживать определенную несогласованность, например:
  • отсутствие результатов в панели Поиск Java или Открыть тип
  • недопустимые элементы на панели Структура пакетов

Для восстановления согласованности JDT необходимо выполнить следующие действия (точно в указанной последовательности):
  1. Закройте все проекты с помощью действия меню навигатора Закрыть проект
  2. Перезапустите Eclipse
  3. Откройте все проекты с помощью действия меню навигатора Открыть проект
  4. Вручную запустите процесс компоновки всей рабочей области с очисткой (Проект > Очистить...)
Значок оформления ошибок пути компоновки В Структуре пакетов и Структуре проектов этот значок оформления ошибки Значок оформления ошибки
пути компоновки отображается в проектах Java и рабочих наборах, если они содержат ошибки пути компоновки:

Значок оформления ошибки пути компоновки

Если в панели Неполадки отсутствуют ошибки пути компоновки, то сначала обратитесь к Структуре пакетов для этого значка, поскольку в ней точнее указано местонахождение неполадки.
Тип файла '*.class without source' Тип файла *.class without source позволяет связывать внутренний или внешний редактор с файлами классов, к которым не присоединен исходный код. Таким образом, например, можно открыть файл класса в декомпиляторе:

Снимок экрана: Страница параметров 'Связи с файлами'

Выборочно игнорировать ошибки/предупреждения из исходных папок JDT можно настроить таким образом, чтобы некоторые ошибки/предупреждения из определенных исходных папок игнорировались. См. Свойства проекта > Путь компоновки Java > Компилятор > Исходный код.

Страница пути компоновки Java с выделенной опцией 'Игнорировать некоторые неполадки компилятора'

Если для этой опции установлено значение Да, JDT будет отключать ошибки/предупреждения согласно параметрам на странице Открывается страница
параметров Ошибки/Предупреждения Java > Компилятор > Ошибки/Предупреждения. Такая установка может быть желательной для исходных папок, в которых содержатся автоматически сгенерированные классы или тесты.

Отладка

Запуск из контекстного меню

Выполнить и отладить приложение на Java можно с помощью контекстного меню файла исходного кода, пакета, метода, типа и т.д. Для запуска выберите в контекстном меню пункт Выполнить как(или Отладить как) > Приложение Java. Можно также воспользоваться комбинацией для запуска приложения на Java (Alt+Shift+D, J). Действия Выполнить как (или Отладить как) также зависят от выбранного элемента или активного редактора.

Контекстное меню с опцией запуска

Вычисления в отладчике

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

Результат проверки во всплывающем окне

Управление панелями не на проекциях Отладка

Панель Отладка автоматически управляет панелями, связанными с отладкой для выбранной панели (например, отображением панелей Java для фреймов стека Java и панелей C для фреймов стека C). По умолчанию, функция автоматического управления панелями работает только в проекции Отладка, однако ее можно включить и для других проекций; это можно сделать на странице параметров Управление панелями, доступной в выпадающем меню панели инструментов панели Отладка.

Переменные среды

Среду для запуска приложений Java можно задавать на вкладке Среда.

Вкладка Среда в окне конфигурации запуска

Подстановка строк

Для многих параметров конфигураций запуска приложений на Java поддерживаются переменные. Рядом с большинством полей, поддерживающих переменные, например, программы или виртуальной машины, расположена кнопка Переменные.... Поле Тип main также поддерживает переменные; переменная ${java_type_name} позволяет создавать конфигурацию, которая будет запускать выбранный тип.

конфигурация запуска - вкладка аргументов

Логические структуры

Переключатель Логические структуры в панели инструментов панели Переменные представляет альтернативные структуры для общих типов. JDT предоставляет логические панели для схем, наборов и комплектов SWT. Логические структуры для других типов задаются на странице Логические структуры.

Вектор, показанный в виде логической структуры в панели Переменная

Переменные в столбцах

Настроить столбцы в панели Переменные можно, выбрав Макет > Выбрать столбцы... в меню просмотра. Появится окно, в котором можно будет выбрать столбцы для отображения. Например, можно добавить столбец с информацией о количестве экземпляров классов (при отладке с помощью JavaSE-1.6). Для переключения столбцов служит действие Макет > Показать столбцы.

Окно выбора настройки
столбцов в панели переменных

Показ столбцов в
панели переменных

Показать ссылки

При отладке с помощью JavaSE-1.6 ссылки на объекты можно отобразить в панели Переменные, выбрав Java > Показать ссылки в меню просмотра. Запись "откуда ссылка" появится под каждым объектом, который можно развернуть для просмотра всех ссылок на него.

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

Все экземпляры

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

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

Аргументы по умолчанию виртуальной машины

Если для определенной виртуальной машины приходится часто задавать одни и те же параметры, то на странице параметров Установленные среды выполнения Java можно настроить Параметры по умолчанию для виртуальной машины. Это гораздо удобнее, чем задавать их для каждой конфигурации запуска.

Страница параметров среды выполнения Java с заданным параметром по умолчанию

Остановка в main Опция Остановить в main в конфигурации запуска приложения на Java позволяет остановить отлаживаемую программу на первой исполняемой строке метода main.

Вкладка Главные с выбранной опцией Остановить в main

Условные точки прерывания С помощью выражений можно определять условные точки прерывания, воспользовавшись окном Свойства точек прерывания... или панелью сведений в меню точек прерывания. Условие определяет, когда точка прерывания фактически останавливает выполнение. Можно указать, в каком случае точка прерывания должна приостанавливать выполнение: только когда условие истинно, или когда значение условия изменяется. Редактор условий для точек прерывания поддерживает Помощник по работе с содержимым.

Редактор
условий точек прерывания в окне свойств точек прерывания или
панели сведений о точках прерывания

Отладка путем записи на консоль Вставки операторов System.out.println() в код в целях отладки можно избежать, если воспользоваться условными точками прерывания для вывода на Консоль. Для этого задайте условную точку прерывания с опцией Приостанавливать в случае 'true' и условием, всегда равным false, например

System.out.println("Оператор
отладки!"); return false;

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

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

Действие Отключить точку прерывания в контекстном меню линейки

Изменение значений переменных При приостановке нити в отладчике в панели Переменные можно изменить значения примитивов Java и объектов String. В контекстном меню переменной выберите Изменить значение переменной. Изменить значение можно и другими способами: можно или ввести новое значение в панели Сведения, или выполнить действие Присвоить значение в контекстном меню (соответствующая комбинация клавиш - CTRL+S).

Окно Изменить значение переменных

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

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

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

Обратите внимание, что команда Сбросить во фрейм доступна только при отладке на виртуальной машине версии 1.4 и выше, или на виртуальной машине J9. В некоторых случаях JVM не в состоянии извлечь нужные фреймы из стека. Например, вообще невозможно выполнить сброс в нижний фрейм стека или в любой фрейм ниже собственного метода платформы (метода native).

Оперативная замена кода Для виртуальных машин версии 1.4 и выше или для виртуальной машины J9 отладчик поддерживает оперативную замену кода, то есть код можно изменять прямо в процессе его отладки. Обратите внимание, что оперативная замена некоторых изменений, например, новых или удаленных методов, переменных классов или внутренних классов, поддерживается не во всех версиях виртуальных машин.
Трассировка выбранного фрагмента с заходом в методы и отладка гиперссылок Отладчик Java позволяет трассировать отдельный метод в цепочке вызовов или в серии вложенных вызовов методов. Просто выберите нужный метод и выберите пункт Трассировка выбранного фрагмента с заходом в методы в контекстном меню редактора Java.

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

зайти в метод

Если знак вставки не указывает на имя метода, то функция перейдет к следующему методу на выбранной строке. Например, когда текстовый курсор находится в начале строки
    assertTrue(fFull.size() == 100),
то команда Трассировать выделение трассирует assertTrue(..) (в отличие от команды Трассировать, которая бы трассировала size()).

Пошагово пройти метод можно также с помощью гиперссылок. Наведите курсор на нужный метод и нажмите Ctrl+Alt+щелчок для входа в метод (Ctrl+щелчок ведет к исходному коду).

Ctrl+Alt+щелчок для входа в метод

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

Окно диалога Свойства точки прерывания

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

Точки прерывания
загрузки классов приостанавливают выполнение при загрузке указанного класса

Точки прерывания методов Точка прерывания метода приостанавливает выполнение при входе или выходе из конкретного метода. Для того чтобы задать точку прерывания метода, выберите метод в панели Схема и в его контекстном меню выберите пункт Переключить точку прерывания метода. Либо, дважды щелкните на строке объявления метода в линейке редактора или с помощью действия меню Выполнить > Переключить точку прерывания метода создайте точку прерывания метода в текущем выбранном методе.

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

Точки прерывания
методов приостанавливают выполнение при входе или выходе из конкретного метода

Нити и мониторы Отладчик Java может показывать информацию мониторинга в панели Отладка. Действие Показать мониторы выпадающего меню панели Отладка покажет нити, владеющие блокировками и ожидающие захвата блокировок. Нити в тупиковых блокировках показаны красным цветом.

панель Отладка - тупиковые блокировки

Пошаговые фильтры (Фильтры трассировки) Пошаговые фильтры предотвращают приостановку отладчика в определенных классах и пакетах при выполнении трассировки кода с заходом в методы. Пошаговые фильтры указываются на странице Пошаговая фильтрация Java > Отладка > Пошаговая фильтрация. Если переключатель Применять пошаговые фильтры (в панели инструментов или меню панели Отладка) включен, то пошаговые фильтры применяются ко всем действиям трассировки. Пункты контекстного меню фрейма стека Фильтровать тип и Фильтровать пакет в панели Отладка позволяют быстро добавить в список фильтров пакет или объявляющий тип выбранного стека фрейма.
Работа со страницей тестирования Если вы хотите поэкспериментировать с API или протестировать новый алгоритм, то для этого проще использовать страницу альбома Java, а не создавать новый класс. Страница тестирования представляет собой контейнер для произвольных фрагментов кода, которые можно в любой момент выполнить вне контекста. Чтобы создать страницу альбома, создайте новый файл с расширением .jpage (или воспользуйтесь мастером Создать страницу альбома Создать страницу альбома). Введите код, который требуется выполнить, затем выберите его. Код можно выполнить тремя способами:
  • Выполнить выбранный код и поместить возвращаемый результат в всплывающее окно
  • Выполнить выбранный код и поместить результат String прямо на страницу тестирования

    Страница тестирования с результатом

  • Выполнить выбранный код (и игнорировать любой возвращаемый результат)

Эти действия содержатся в панели инструментов рабочей среды и в контекстном меню страницы тестирования.

Редактирование
конфигураций
запуска
Для того чтобы открыть для редактирования связанную конфигурацию запуска, нажмите и удерживайте клавишу Ctrl и одновременно выберите пункт выпадающего меню Выполнить или Отладка. Конфигурацию запуска можно также открыть с помощью контекстного меню любого элемента в панели Отладка.
Избранные конфигурации запуска Конфигурации запуска появляются в выпадающем меню Выполнить/Отладка в порядке, противоположном порядку их запуска. Однако можно принудительно выводить в начале выпадающего списка 'избранную' конфигурацию. Для настройки избранных конфигураций запуска используйте действие Упорядочить избранное... из соответствующего выпадающего меню.
Инструменты форматирования сведений Панель сведений в панелях Переменные & Выражения содержит расширенное представление выбранной переменной. По умолчанию это расширенное представление является результатом вызова метода toString() для выбранного объекта, однако пользователь может создать собственный инструмент форматирования сведений, который будет применяться вместо этого метода, выбрав в контекстном меню переменной пункт Новый инструмент форматирования сведений. Этот инструмент форматирования сведений будет применяться для всех объектов одного типа. Для просмотра и изменения параметров форматирования откройте страницу Инструменты форматирования сведений Java > Отладка > Инструменты форматирования сведений.

Окно диалога Инструмент форматирования сведений

Выполнение кода с ошибками компиляции Можно выполнять и отлаживать код, содержащий ошибки компиляции. Единственное различие между выполнением кода с ошибками компиляции и без них состоит в том, что при выполнении строки кода с ошибкой может произойти одно из следующих событий:
  • Если в окне Отладка Java > Отладка отмечено поле 'Приостанавливать выполнение при ошибках компиляции' и при этом выполняется отладка, сеанс отладки будет приостанавливаться в точках прерывания. Обратите внимание, что если виртуальная машина поддерживает оперативную замену кода, то можно исправить ошибку и возобновить отладку
  • В противном случае выполнение будет прекращено с результатом 'неисправимая ошибка компиляции'

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

Перенос слов в панели Переменные Для области сведений панелей отладчика Переменные и Выражения поддерживается перенос слов, который включается в выпадающем меню панели.

Действие Перенос слов в выпадающем меню панели Переменные

Помощник по коду в отладчике Помощник по коду доступен не только при написании кода в редакторе Java, но и во многих других контекстах:
  • При вводе условия прерывания
  • В окне Сведения панелей Переменные и Выражения
  • При вводе фрагмента кода инструмента форматирования сведений
  • При вводе фрагмента кода Логическая структура
  • При вводе кода на странице Альбом
  • В панели Просмотр
Сведения о командной строке Точный вид вид командной строки, предназначенной для запуска программы в режиме выполнения или отладки, всегда можно посмотреть, выбрав пункт Свойства контекстного меню обрабатываемого или отлаживаемого объекта, даже если запуск был прерван.

командная строка

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

Записи трассировки стека в панели Консоль с гиперссылками

Отладка в проекции Java Отладка в проекции Java настраивается параметрами Выполнение/отладка > Управление панелями. Выберите проекции для возможности выполнения отладки.

Страница параметров Управление панелями

Убедитесь, что параметр активации панели отладки при щелчке на точке прерывания включен (с помощью страницы параметров верхнего уровня Выполнение/отладка).

Страница параметров Выполнение/отладка

Подсказку переключения проекции можно выключить на странице параметров Выполнение/отладка > Проекции. При этих настройках панель Отладка на проекции Java откроется автоматически при щелчке на точке прерывания.

Страница параметров Проекции

Если поместить панель Отладка на проекцию и уменьшить ее высоту до размера одного элемента, то панель переключится на показ пути. Это позволяет сэкономить пространство экрана, используемое панелью.

Панель Отладка в режиме показа пути