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

@Retention(SOURCE) public @interface SuppressWarnings

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

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

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

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

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

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