模块  java.base
软件包  java.lang

Annotation Type SuppressWarnings


  • @Target({TYPE,字段,METHOD,PARAMETER,构造器,LOCAL_VARIABLE,模块})
    @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  
      变量和类型 Required Element 描述
      String[] value
      要在注释元素中由编译器抑制的警告集。
    • Element Detail

      • value

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

        字符串"unchecked"用于禁止未检查的警告。 编译器供应商应记录它们支持的其他警告名称以及此注释类型。 鼓励他们合作以确保相同的名称在多个编译器中工作。

        结果
        要抑制的警告集