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

@Retention(SOURCE) public @interface SuppressWarnings

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

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

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

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

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

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