Java中@SuppressWarnings（”unchecked”）的作用

一、简介：

java.lang.SuppressWarnings是J2SE5.0中标准的Annotation之一。可以标注在类、字段、方法、参数、构造方法，以及局部变量上。

作用：

告诉编译器忽略指定的警告，不用在编译完成后出现警告信息。

使用：

@SuppressWarnings(“”)

@SuppressWarnings({})

@SuppressWarnings(value={})

根据sun的官方文档描述：

value -将由编译器在注释的元素中取消显示的警告集。允许使用重复的名称。忽略第二个和后面出现的名称。出现未被识别的警告名不是错误：编译器必须忽略无法识别的所有警告名。但如果某个注释包含未被识别的警告名，那么编译器可以随意发出一个警告。

各编译器供应商应该将它们所支持的警告名连同注释类型一起记录。鼓励各供应商之间相互合作，确保在多个编译器中使用相同的名称。

示例：

@SuppressWarnings(“unchecked”)

告诉编译器忽略 unchecked 警告信息，如使用List，ArrayList等未进行参数化产生的警告信息。

@SuppressWarnings(“serial”)

如果编译器出现这样的警告信息：The serializable class WmailCalendar does notdeclare a static final serialVersionUID field of type long 使用这个注释将警告信息去掉。

@SuppressWarnings(“deprecation”)

如果使用了使用@Deprecated注释的方法，编译器将出现警告信息。使用这个注释将警告信息去掉。

@SuppressWarnings(“unchecked”, “deprecation”)

告诉编译器同时忽略unchecked和deprecation的警告信息。

@SuppressWarnings(value={“unchecked”, “deprecation”})

等同于@SuppressWarnings(“unchecked”,”deprecation”)

编码时我们总会发现如下变量未被使用的警告提示：

🗿Java中@SuppressWarnings（"unchecked"）的作用 - 图1

上述代码编译通过且可以运行，但每行前面的“感叹号”就严重阻碍了我们判断该行是否设置的断点了。这时我们可以在方法前添加 @SuppressWarnings(“unused”) 去除这些“感叹号”。

二、@SuppressWarings注解

作用：用于抑制编译器产生警告信息。

示例1——抑制单类型的警告：

@SuppressWarnings("unchecked")
public void addItems(String item){
    @SuppressWarnings("rawtypes")
    List items = new ArrayList();
    items.add(item);
}

示例2——抑制多类型的警告：

@SuppressWarnings(value={"unchecked", "rawtypes"})
public void addItems(String item){
    List items = new ArrayList();
    items.add(item);
}

示例3——抑制所有类型的警告：

@SuppressWarnings("all")
    public void addItems(String item){
    List items = new ArrayList();
    items.add(item);
}

三、注解目标

通过 @SuppressWarnings 的源码可知，其注解目标为类、字段、函数、函数入参、构造函数和函数的局部变量。

而家建议注解应声明在最接近警告发生的位置。

四、抑制警告的关键字

关键字	用途
all	to suppress all warnings（抑制所有警告）
boxing	to suppress warnings relative to boxing/unboxing operations（要抑制与箱/非装箱操作相关的警告）
cast	to suppress warnings relative to cast operations（为了抑制与强制转换操作相关的警告）
dep-ann	to suppress warnings relative to deprecated annotation（要抑制相对于弃用注释的警告）
deprecation	to suppress warnings relative to deprecation（要抑制相对于弃用的警告）
fallthrough	to suppress warnings relative to missing breaks in switch statements（在switch语句中，抑制与缺失中断相关的警告）
finally	to suppress warnings relative to finally block that don’t return（为了抑制警告，相对于最终阻止不返回的警告）
hiding	to suppress warnings relative to locals that hide variable（为了抑制本地隐藏变量的警告）
incomplete-switch	to suppress warnings relative to missing entries in a switch statement (enum case)（为了在switch语句（enum案例）中抑制相对于缺失条目的警告）
nls	to suppress warnings relative to non-nls string literals（要抑制相对于非nls字符串字面量的警告）
null	to suppress warnings relative to null analysis（为了抑制与null分析相关的警告）
rawtypes	to suppress warnings relative to un-specific types when using generics on class params（在类params上使用泛型时，要抑制相对于非特异性类型的警告）
restriction	to suppress warnings relative to usage of discouraged or forbidden references（禁止使用警告或禁止引用的警告）
serial	to suppress warnings relative to missing serialVersionUID field for a serializable class（为了一个可串行化的类，为了抑制相对于缺失的serialVersionUID字段的警告）
static-access	o suppress warnings relative to incorrect static access（o抑制与不正确的静态访问相关的警告）
synthetic-access	to suppress warnings relative to unoptimized access from inner classes（相对于内部类的未优化访问，来抑制警告）
unchecked	to suppress warnings relative to unchecked operations（相对于不受约束的操作，抑制警告）
unqualified-field-access	to suppress warnings relative to field access unqualified（为了抑制与现场访问相关的警告）
unused	to suppress warnings relative to unused code（抑制没有使用过代码的警告）

五、Java Lint选项

1.lint的含义

用于在编译程序的过程中，进行更细节的额外检查。

1.javac的标准选项和非标准选项

标准选项：
是指当前版本和未来版本中都支持的选项，如 -cp 和 -d 等。

非标准选项：
是指当前版本支持，但未来不一定支持的选项。通过 javac -X 查看当前版本支持的非标准选项。

🗿Java中@SuppressWarnings（"unchecked"）的作用 - 图2

3.查看警告信息

默认情况下执行 javac 仅仅显示警告的扼要信息，也不过阻止编译过程。若想查看警告的详细信息，则需要执行 javac -Xlint:keyword 来编译源码了。

六、总结

现在再都不怕不知道设置断点没有咯！