Интерфейс аннотаций SuppressWarnings

@Retention(SOURCE) public @interface SuppressWarnings

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

Интерфейс аннотации SuppressWarnings применим ко всем контекстам объявления, поэтому аннотация @SuppressWarnings может быть применена к любому элементу. В целях стиля программисты должны всегда использовать эту аннотацию на самом вложенном элементе, где она эффективна. Например, если вы хотите подавить предупреждение в определенном методе, вы должны аннотировать этот метод, а не его класс.

Набор предупреждений, подавляемых в данном элементе, представляет собой объединение предупреждений, подавляемых во всех содержащих его элементах. Например, если вы аннотируете класс для подавления одного предупреждения, а метод в этом классе — для подавления другого, оба предупреждения будут подавлены в методе. Однако обратите внимание, что если предупреждение подавлено в module-info файле, то подавление применяется к элементам внутри файла, а не к типам, содержащимся в модуле. Аналогично, если предупреждение подавлено в package-info файле, то подавление применяется к элементам внутри файла, а не к типам, содержащимся в пакете.

Компиляторы Java должны распознавать все виды предупреждений, определенные в Спецификации языка Java (раздел JLS 9.6.4.5), которые включают:

• Предупреждения типа unchecked, заданные строкой "unchecked".
• Предупреждения о устаревании, заданные строкой "deprecation".
• Предупреждения об удалении, заданные строкой "removal".
• Предупреждения предварительного просмотра, заданные строкой "preview".

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