@Retention(SOURCE) public @interface SuppressWarnings
The SuppressWarnings
annotation interface is applicable in all declaration contexts, so an @SuppressWarnings
annotation can be used on any element. As a matter of style, programmers should always use this annotation on the most deeply nested element where it is effective. For example, if you want to suppress a warning in a particular method, you should annotate that method rather than its class.
The set of warnings suppressed in a given element is a union of the warnings suppressed in all containing elements. For example, if you annotate a class to suppress one warning and annotate a method in the class to suppress another, both warnings will be suppressed in the method. However, note that if a warning is suppressed in a module-info
file, the suppression applies to elements within the file and not to types contained within the module. Likewise, if a warning is suppressed in a package-info
file, the suppression applies to elements within the file and not to types contained within the package.
Java compilers must recognize all the kinds of warnings defined in the Java Language Specification (JLS section 9.6.4.5) which include:
"unchecked"
. "deprecation"
. "removal"
. "preview"
. javac
reference implementation recognizes compilation-related warning names documented in its --help-lint
output.Modifier and Type | Required Element | Description |
---|---|---|
String[] |
value |
The set of warnings that are to be suppressed by the compiler in the annotated element. |
String[] value
© 1993, 2023, 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/21/docs/api/java.base/java/lang/SuppressWarnings.html