Spec-Zone.ru › OpenJDK 17

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

@Target({TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE,MODULE}) @Retention(SOURCE) public @interface SuppressWarnings
Указывает, что указанные предупреждения компилятора должны быть подавлены в аннотированном элементе (и во всех программистских элементах, содержащихся в аннотированном элементе). Обратите внимание, что набор подавленных предупреждений в данном элементе является супермножеством предупреждений, подавленных во всех содержащих элементах. Например, если вы аннотируете класс для подавления одного предупреждения и аннотируете метод для подавления другого, оба предупреждения будут подавлены в методе. Однако обратите внимание, что если предупреждение подавлено в module-info файле, подавление применяется к элементам внутри файла, а не к типам, содержащимся в модуле.

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

См. Спецификацию языка Java:
4.8 Примитивные типы
4.12.2 Переменные ссылочного типа
5.1.9 Непроверяемое преобразование
5.5 Контексты приведения типов
@SuppressWarnings
С:
1.5

Краткое описание требуемых элементов

Модификатор и тип Требуемый элемент Описание
String[] value
Набор предупреждений, которые должны быть подавлены компилятором в аннотированном элементе.

Подробное описание элементов

value

String[] value
Набор предупреждений, которые должны быть подавлены компилятором в аннотированном элементе. Повторяющиеся имена допускаются. Второе и последующие вхождения имени игнорируются. Наличие нераспознанных имён предупреждений не является ошибкой: компиляторы должны игнорировать любые имена предупреждений, которые они не распознают. Однако они могут выдать предупреждение, если аннотация содержит нераспознанное имя предупреждения.

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

Возвращает:
набор предупреждений, которые нужно подавить

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/SuppressWarnings.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API