java最后一个注解@SuppressWarnings

偏执的太偏执、 2022-06-07 08:27 79阅读 0赞

@SuppressWarnings注解

**简介：** 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")

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

![211544285432472.png][]

上述代码编译通过且可以运行，但每行前面的“感叹号”就严重阻碍了我们判断该行是否设置的断点了。这时我们可以在方法前添加 @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 的源码可知，其注解目标为类、字段、函数、函数入参、构造函数和函数的局部变量。

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

三、抑制警告的关键字

<table style="border-collapse:collapse; border-spacing:0px; max-width:100%; color:rgb(69,69,69); font-family:&quot;PingFang SC&quot;,&quot;Microsoft YaHei&quot;,SimHei,Arial,SimSun; font-size:16px; height:547px; width:657px"> 
 <tbody style=""> 
 <tr style=""> 
 <td style="text-align:center">关键字</td> 
 <td style="text-align:center">用途</td> 
 </tr> 
 <tr style=""> 
 <td style="">all</td> 
 <td style="">to suppress all warnings</td> 
 </tr> 
 <tr style=""> 
 <td style="">boxing&nbsp;</td> 
 <td style="">to suppress warnings relative to boxing/unboxing operations</td> 
 </tr> 
 <tr style=""> 
 <td style="">cast</td> 
 <td style="">to suppress warnings relative to cast operations</td> 
 </tr> 
 <tr style=""> 
 <td style="">dep-ann</td> 
 <td style="">to suppress warnings relative to deprecated annotation</td> 
 </tr> 
 <tr style=""> 
 <td style="">deprecation</td> 
 <td style="">to suppress warnings relative to deprecation</td> 
 </tr> 
 <tr style=""> 
 <td style="">fallthrough</td> 
 <td style="">&nbsp;to suppress warnings relative to missing breaks in switch statements</td> 
 </tr> 
 <tr style=""> 
 <td style="">finally&nbsp;</td> 
 <td style="">to suppress warnings relative to finally block that don’t return</td> 
 </tr> 
 <tr style=""> 
 <td style="">hiding</td> 
 <td style="">to suppress warnings relative to locals that hide variable</td> 
 </tr> 
 <tr style=""> 
 <td style="">incomplete-switch</td> 
 <td style="">&nbsp;to suppress warnings relative to missing entries in a switch statement (enum case)</td> 
 </tr> 
 <tr style=""> 
 <td style="">nls</td> 
 <td style="">&nbsp;to suppress warnings relative to non-nls string literals</td> 
 </tr> 
 <tr style=""> 
 <td style="">null</td> 
 <td style="">to suppress warnings relative to null analysis</td> 
 </tr> 
 <tr style=""> 
 <td style="">rawtypes</td> 
 <td style="">to suppress warnings relative to un-specific types when using generics on class params</td> 
 </tr> 
 <tr style=""> 
 <td style="">restriction</td> 
 <td style="">to suppress warnings relative to usage of discouraged or forbidden references</td> 
 </tr> 
 <tr style=""> 
 <td style="">serial</td> 
 <td style="">to suppress warnings relative to missing serialVersionUID field for a serializable class</td> 
 </tr> 
 <tr style=""> 
 <td style="">static-access</td> 
 <td style="">o suppress warnings relative to incorrect static access</td> 
 </tr> 
 <tr style=""> 
 <td style="">synthetic-access&nbsp;</td> 
 <td style="">&nbsp;to suppress warnings relative to unoptimized access from inner classes</td> 
 </tr> 
 <tr style=""> 
 <td style="">unchecked</td> 
 <td style="">&nbsp;to suppress warnings relative to unchecked operations</td> 
 </tr> 
 <tr style=""> 
 <td style="">unqualified-field-access</td> 
 <td style="">to suppress warnings relative to field access unqualified</td> 
 </tr> 
 <tr style=""> 
 <td style="">unused</td> 
 <td style="">to suppress warnings relative to unused code</td> 
 </tr> 
 </tbody> 
</table>

四、Java Lint选项

1. lint的含义

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

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

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

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

![211648020124434.png][]

3. 查看警告信息

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

五、总结

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

[211544285432472.png]: /images/20220607/18b5270dc8954254b70c795e810344f3.png
[211648020124434.png]: /images/20220607/cd361ca2b4eb4bbe91a1b4cac374a1cb.png