Module  java.base
软件包  java.lang

Annotation Type SuppressWarnings


  • @Target({TYPE,字段,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE,MODULE})
@Retention(SOURCE)
public @interface SuppressWarnings
    表示在注释元素（以及注释元素中包含的所有程序元素）中应该抑制命名的编译器警告。 请注意，给定元素中抑制的一组警告是所有包含元素中抑制的警告的超集。 例如，如果您注释一个类来抑制一个警告并注释方法来抑制另一个警告，则两个警告将在该方法中被抑制。 但是，请注意，如果在module-info文件中抑制了警告，则抑制应用于文件中的元素， 而不适用于模块中包含的类型。

    作为一种风格，程序员应该始终将这个注释用于最有效的嵌套元素。 如果要在特定方法中抑制警告，则应该注释该方法而不是其类。

    从以下版本开始：
    1.5
    See The Java™ Language Specification:
    4.8原始类型，4.12.2参考类型的变量，5.1.9未经检查的转换，5.5.2检查的角色和未被检查的角色，9.6.4.5 @SuppressWarnings

    • Required Element Summary

      Required Elements  
      Modifier and Type Required Element 描述
      String[] value
      在注释元素中由编译器抑制的一组警告。

    • Element Detail

      • value

        String[] value
        在注释元素中由编译器抑制的一组警告。 允许重复的名称。 忽略名称的第二次和连续出现。 无法识别的警告名称的存在不是错误：编译器必须忽略他们无法识别的任何警告名称。 但是，如果注释包含无法识别的警告名称，则它们可以自由发出警告。

        字符串"unchecked"用于抑制未经检查的警告。 编译器供应商应该记录它们与此注释类型一起支持的附加警告名称。 我们鼓励他们合作，确保同一个名字在多个编译器上工作。

        结果
        一组警告被压制