Параметры ошибок/предупреждений компиляции Java

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

Стиль кода

Параметр

Описание

По умолчанию

Нестатический доступ к статическому элементу

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

Предупреждение

Косвенный доступ к статическому элементу

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

Игнорировать

Доступ по неполному пути к полю экземпляра:

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

Игнорировать

Обращение к недоступному элементу вмещающего типа

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

Игнорировать

Присваивание параметра

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

Игнорировать

Не экспортированные строки

Если эта опция включена, то компилятор выдаст ошибку или предупреждение при обнаружении неэкспортированных литеральных строк (т.е. не содержащих тега //$NON-NLS-<n>$) или тегов не экспортированных строк, не относящихся к строке.

Игнорировать

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

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

Игнорировать

Для управления ресурсом не используется try-with-resource (версия 1.7 или выше)

При включении этой опции компилятор будет выдавать сообщение об ошибке или предупреждение, если в локальной переменной содержится значение типа 'java.lang.AutoCloseable' и если метод 'close()' вызван явным образом для данного ресурса, но ресурс не управляется блоком try-with-resources.

Игнорировать

Метод с именем конструктора

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

Предупреждение

Метод может быть статическим

Если эта опция включена, то компилятор выдаст ошибку или предупреждение при обнаружении методов, помеченных как private или final, но ссылающихся только на статические члены.

Игнорировать

Метод потенциально может быть статическим

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

Игнорировать

Потенциальные неполадки в коде

Сравнение одинаковых операндов ('x == x')

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

Предупреждение

Безрезультатное присваивание (например, 'x = x')

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

Предупреждение

Возможная ошибка булевского присваивания (например, 'if (a = b)')

Если эта опция включена, то компилятор выдаст сообщение об ошибке или предупреждение о возможной ошибке булевского присваивания (например, 'if (a = b)').

Игнорировать

Приведение типов

Если эта опция включена, то компилятор будет выдавать ошибку или предупреждение при каждом выполнении преобразования приведения типов. Автоматическое приведение типов снижает быстродействие.

Игнорировать

Применение символьного массива в конкатенации строк

Если эта опция включена, то компилятор выдаст ошибку или предупреждение при обнаружении выражения char[] в конкатенациях строк, например:

"hello" + new char[]{'w','o','r','l','d'}

Предупреждение

Неточное совпадение типов для аргументов vararg

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

Предупреждение

Пустой оператор

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

Игнорировать

Неиспользуемое выделение объекта

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

if (name == null)
   new IllegalArgumentException();

Игнорировать

Неполный набор ветвей 'switch' для перечисления

При включении этой опции компилятор будет выдавать сообщение об ошибке или предупреждение при каждом обнаружении оператора switch, в котором не содержатся ни операторы case для каждой константы перечисления соответствующего перечисления, ни прецедент по умолчанию. Прецедент по умолчанию заменяет собой все неуказанные операторы выбора для любой константы перечисления, поэтому при наличии прецедента по умолчанию компилятор выдает сообщения, только если включена опция "Извещать даже при наличии прецедента 'default'" (см. ниже).

Предупреждение

Сообщать даже при наличии варианта 'default'

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

Выключена

В 'switch' отсутствует ветвь 'default'

Если эта опция включена, компилятор будет выдавать сообщение об ошибке или предупреждение, если в операторе 'switch' отсутствует прецедент по умолчанию. Следовательно, отсутствующая ветвь 'default' будет помечена, даже если все возможные значения иным образом включены в операторы 'case'. Это предупреждение является рекомендованным согласно Спецификации языка Java в целях обеспечения двоичной совместимости.

Игнорировать

Пропуск прецедента 'switch'

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

Игнорировать

Скрытый блок catch

Локально по отношению к оператору try некоторые блоки catch могут скрывать другие, например:

try { throw new java.io.CharConversionException();
} catch (java.io.CharConversionException e) {
} catch (java.io.IOException e) {}

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

Предупреждение

Ненормальное завершение блока finally

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

Предупреждение

Невыполнимый код (например, 'if (false)')

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

Предупреждение

Утечка ресурсов

При включении этой опции компилятор будет выдавать сообщение об ошибке или предупреждение, если в локальной переменной содержится значение типа 'java.lang.AutoCloseable' (compliance >= 1.7) или значение типа 'java.io.Closeable' (compliance <= 1.6) и если анализ потока показывает, что метод 'close()' не вызван локально для данного значения.

Предупреждение

Возможная утечка ресурсов

При включении этой опции компилятор будет выдавать сообщение об ошибке или предупреждение, если в локальной переменной содержится значение типа 'java.lang.AutoCloseable' (compliance >= 1.7) или значение типа 'java.io.Closeable' (compliance <= 1.6) и если анализ потока показывает, что метод 'close()' не вызван локально для данного значения для всех путей выполнения.

Игнорировать

Сериализуемый класс без serialVersionUID

При включении этой опции компилятор будет выдавать сообщение об ошибке или предупреждение при обнаружении типа, реализующего 'java.io.Serializable', но не имеющего поля serialVersionUID.

Предупреждение

Отсутствует синхронизированный модификатор в наследуемом методе

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

Игнорировать

Класс переопределяет 'equals()', но не 'hashCode()'

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

Игнорировать

Конфликты и наложение имен

Объявление поля, скрывающее другое поле или переменную:

Если эта опция включена, то компилятор выдаст ошибку или предупреждение, если объявление поля скрывает другое унаследованное поле.

Игнорировать

Объявление локальной переменной, скрывающее другое поле или переменную:

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

Игнорировать

Добавить параметры конструктора или метода set

Если эта опция включена, то компилятор также выдаст ошибку или предупреждение, если параметр конструктора или метода set скрывает другое поле или переменную.

Выключена

Тип параметра скрывает другой тип

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

Предупреждение

Метод не переопределяет метод, видимый в пакете

Метод default для пакета невидим в другом пакете и, следовательно, его нельзя переопределить. Если эта опция включена, то компилятор будет сообщать об этом как об ошибке или о предупреждении.

Предупреждение

Конфликт метода интерфейса с защищенным методом 'Object'

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

interface I {
   int clone();
}

Предупреждение

Устаревший и запрещенный API

Устаревший API

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

Предупреждение

Извещать об использовании устаревших API в устаревшем коде

Если эта опция включена, то компилятор сообщит об обнаружении устаревших API в устаревшем коде. Серьезность неполадки определяется опцией "Устаревшие API".

Выключена

Извещать о переопределении или реализации устаревшего метода

Если эта опция включена, то компилятор сообщит об обнаружении переопределения или реализации устаревшего метода. Серьезность неполадки определяется опцией "Устаревшие API".

Выключена

Запрещенная ссылка (правила доступа)

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

Ошибка

Нежелательная ссылка (правила доступа)

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

Предупреждение

Ненужный код

Значение локальной переменной не используется

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

Предупреждение

Значение параметра не используется

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

Игнорировать

Игнорировать в переопределяющих и реализующих методах

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

Включен

Игнорировать параметры с тегом '@param'

Если эта опция включена, компилятор выдаст сообщение об ошибке или предупреждение о том, что непрочитанный параметр документирован с тегом '@param'.

Включен

Неиспользуемое объявление импорта

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

Предупреждение

Неиспользуемый элемент с модификатором private

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

Предупреждение

Ненужный оператор 'else'

Если эта опция включена, компилятор выдаст сообщение об ошибке или предупреждение при обнаружении ненужного оператора else (например, if (condition) return; else doSomething();).

Игнорировать

Ненужная операция преобразования типов или 'instanceof':

Если эта опция включена, компилятор выдаст сообщение об ошибке или предупреждение при обнаружении лишнего приведения типов или оператора 'instanceof' (например, if (object instanceof Object) return;).

Игнорировать

Ненужное объявление генерируемой исключительной ситуации

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

Игнорировать

Игнорировать в переопределяющих и реализующих методах

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

Включен

Игнорировать исключительные ситуации, задокументированные в тегах '@throws' или '@exception'

Если эта опция включена, компилятор не будет выдавать сообщение об ошибке или предупреждение о том, что тег '@throws' или '@exception' содержит ненужное объявление сгенерированной исключительной ситуации.

Включен

Игнорировать 'Exception' и 'Throwable'

При включении этой опции компилятор не будет выдавать сообщение об ошибке или предупреждение при обнаружении лишних объявлений исключительных ситуаций как 'Exception' и 'Throwable'.

Включен

Ненужная метка 'break' или 'continue'

Если эта опция включена, компилятор выдаст сообщение об ошибке или предупреждение при обнаружении неиспользуемой метки 'break' или 'continue'.

Предупреждение

Лишний базовый интерфейс

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

Игнорировать

Параметризуемые типы

Операция с непроверенным параметризуемым типом

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

Предупреждение

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

Если эта опция включена, компилятор будет выдавать сообщение об ошибке или предупреждение в случае обнаружения применения непараметризованного типа (например, List вместо List<String>).

Предупреждение

Параметр шаблонного типа, объявленный в связывании типа final

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

Предупреждение

Игнорировать неустранимые ошибки параметризуемых типов

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

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

Выключена

Аннотации

Отсутствует аннотация '@Override'

При включении этой опции компилятор будет сообщать об ошибке или предупреждении, если в объявлении метода, переопределяющего другой метод, нет аннотации @Override.

Игнорировать

Включить реализации методов интерфейсов (начиная с 1.6)

При включении этой опции компилятор будет выдавать сообщение об ошибке или предупреждение в случае обнаружения метода, переопределяющего или реализующего метод, объявленный в интерфейсе, если отсутствует аннотация '@Override'.
Обратите внимание, что аннотация '@Override' разрешена только начиная с уровня соответствия компилятора 1.6. Это предупреждение никогда не выдается в коде версии 1.5.

Включен

Отсутствует аннотация '@Deprecated'

При включении этой опции компилятор будет сообщать об ошибке или предупреждении, если в объявлении устаревшего типа нет аннотации '@Deprecated'.

Игнорировать

Аннотация используется как базовый интерфейс

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

Предупреждение

Необработанный маркер в '@SuppressWarnings'

При включении этой опции компилятор будет сообщать об ошибке или предупреждении, если он встречает неизвестные маркеры в аннотации '@SuppressWarnings'.

Предупреждение

Включить аннотации '@SuppressWarnings'

При включении этой опции компилятор будет обрабатывать аннотации '@SuppressWarnings'. Если эта опция отключена, компилятор будет действовать так, как если бы аннотации '@SuppressWarnings' были удалены.

Включен

Неиспользуемый маркер '@SuppressWarnings'

При включении этой опции компилятор будет сообщать об ошибке или предупреждении, если он встречает неиспользуемые маркеры в аннотации '@SuppressWarnings'.

Предупреждение

Подавлять необязательные ошибки посредством '@SuppressWarnings'

Если эта опция включена, аннотация '@SuppressWarnings' будет также подавлять необязательные ошибки компилятора, т.е. опции, для которых установлено значение "Ошибка". Обязательные ошибки компиляции не могут быть подавлены.

Выключена

Анализ Null

Обращение к пустому указателю

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

Предупреждение

Потенциальное обращение к пустому указателю

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

Качество анализа можно повысить с помощью аннотаций null, которые можно активировать, используя опцию Включить анализ null на основе аннотаций

Игнорировать

Избыточная проверка нулевых значений

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

Игнорировать

Включить 'assert' в анализ null

При включении этой опции компилятор будет учитывать оператор 'assert' при проведении анализа null.

Выключена

Включить анализ null на основе аннотаций

Если эта опция включена, компилятор будет интерпретировать аннотации @Nullable, @NonNull и @NonNullByDefault как указывающие на то, включено ли в данный тип значение 'null'.

Результатами такого анализа в дальнейшем управляют описанные ниже дополнительные опции.

См. также Использование аннотаций null.

Выключена

Нарушение спецификации null

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

  1. Метод, объявленный с аннотацией, отличной от null, возвращает выражение nullable.
  2. Выражение nullable передается в качестве аргумента в вызов метода, если соответствующий параметр вызываемого метода объявлен с аннотацией, отличной от null.
  3. Выражение nullable присвоено локальной переменной, которая объявлена с аннотацией, отличной от null.
  4. Метод, переопределяющий унаследованный метод, объявленный с аннотацией, отличной от null, пытается ослабить эту связь путем указания обнуляемой переменной (запрет контравариантного возврата).
  5. Метод, переопределяющий унаследованный метод с объявлением nullable как минимум для одного из параметров, пытается ослабить эту связь null путем указания аннотации, отличной от null, для соответствующего параметра (запрет ковариантных параметров).

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

Ошибка

Конфликт аннотаций null и выводимых значений null

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

  1. Метод, объявленный с аннотацией, отличной от null, возвращает выражение, которое статически определено как получающее значение null в результате вычисления в определенном потоке.
  2. Выражение, которое статически определено как получающее значение null в результате вычисления в определенном потоке, передается в качестве аргумента в вызов метода, в котором соответствующий параметр вызываемого метода объявлен с аннотацией, отличной от null.
  3. Выражение, которое статически определено как получающее значение null в результате вычисления в определенном потоке, присваивается локальной переменной, которая объявлена с аннотацией, отличной от null.

Ошибка

Непроверяемое преобразование типа без аннотации в тип @NonNull

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

  1. Метод, объявленный с аннотацией, отличной от null, возвращает выражение, для которого имеется недостаточно информации о значениях null, позволяющей статически доказать, что в среде выполнения ни одним потоком не будет передано значение null.
  2. Выражение, для которого имеется недостаточно информации о значениях null, позволяющей статически доказать, что в среде выполнения оно никогда не будет равным null в результате вычисления, передается в качестве аргумента в вызов метода, в котором соответствующий параметр вызываемого метода объявлен с аннотацией, отличной от null.
  3. Выражение, для которого имеется недостаточно информации о значениях null, позволяющей статически доказать, что в среде выполнения оно никогда не будет равным null в результате вычисления, присваивается локальной переменной, объявленной с аннотацией, отличной от null.

Непроверяемое преобразование обычно является следствием использования других неаннотированных переменных или методов.

Предупреждение

Избыточная пустая аннотация

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

Предупреждение

В пакете отсутствует аннотация '@NonNullByDefault'

Если эта опция включена, то компилятор выдаст ошибку или предупреждение в следующих случаях:

  1. Если в пакете нет аннотации по умолчанию с информацией о нулевых значениях, в результате отсутствия package-info.java или отсутствия аннотации по умолчанию с информацией о нулевых значениях в package-info.java.
  2. Если в типе внутри пакета по умолчанию не содержится аннотация по умолчанию с информацией о нулевых значениях.

Игнорировать

Использовать аннотации по умолчанию для спецификаций null

При включении этой опции компилятор будет использовать набор аннотаций по умолчанию для спецификаций null. Эти аннотации находятся в Eclipse SDK в комплекте org.eclipse.jdt.annotation.

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

  • org.eclipse.jdt.annotation.Nullable: Полное имя типа аннотации Java, которое при применении к типу в сигнатуре метода или в объявлении переменной, будет интерпретировано как спецификация о том, что null является допустимым значением в данной позиции.
    В настоящее время поддерживаются следующие позиции: параметры метода, тип возврата метода и локальные переменные.
  • org.eclipse.jdt.annotation.NonNull: Полное имя типа аннотации Java, которое при применении к типу в сигнатуре метода или в объявлении переменной, будет интерпретировано как спецификация о том, что null не является допустимым значением в данной позиции.
    В настоящее время поддерживаются следующие позиции: параметры метода, тип возврата метода и локальные переменные.
  • org.eclipse.jdt.annotation.NonNullByDefault: Полное имя типа аннотации Java. При применении к элементу без аргумента аннотации, все неаннотированные типы в сигнатурах метода в аннотированном элементе будут рассматриваться так, как если бы они были указаны с аннотацией, отличной от null.
    И наоборот, если аннотация применяется с константной 'false' в качестве аргумента, все соответствующие значения по умолчанию во внешних областях будут отменены для аннотированного элемента.

Включен

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

Связанные концепции

Панель Неполадки
Быстрое исправление
Компоновщик Java