Java—@SuppressWarnings注解

朱雀 2022-05-14 00:37 158阅读 0赞

## @SuppressWarnings注解用法详解 ##

J2SE提供的最后一个批注是**@SuppressWarnings**。该批注的作用是给编译器一条指令，告诉它对被批注的代码元素内部的某些警告保持静默。

**@SuppressWarnings**批注允许您选择性地取消特定代码段（即，类或方法）中的警告。其中的想法是当您看到警告时，您将调查它，如果您确定它不是问题，您就可以添加一个**@SuppressWarnings**批注，以使你不会再看到警告虽然它听起来似乎会屏蔽潜在的错误，但实际上它将提高代码安全性，因为它将防止。  **您对警告无动于衷** \-您**看到**的每一个警告都将值得注意。

使用：  
@SuppressWarnings（“”）  
@ SuppressWarnings（\{\}）@SuppressWarnings   
（value = \{\}）

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

![70][]

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

## **@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> 
 <tbody> 
 <tr> 
 <td style="width:167px;">关键字</td> 
 <td style="width:398px;">用途</td> 
 <td style="width:285px;">作用</td> 
 </tr> 
 <tr> 
 <td>all</td> 
 <td>to suppress all warnings</td> 
 <td style="width:285px;">抑制所有警告</td> 
 </tr> 
 <tr> 
 <td>boxing&nbsp;</td> 
 <td>to suppress warnings relative to boxing/unboxing operations</td> 
 <td style="width:285px;">抑制装箱，拆箱操作时候的警告</td> 
 </tr> 
 <tr> 
 <td>cast</td> 
 <td>to suppress warnings relative to cast operations</td> 
 <td style="width:285px;">抑制映射相关的警告</td> 
 </tr> 
 <tr> 
 <td>dep-ann</td> 
 <td>to suppress warnings relative to deprecated annotation</td> 
 <td style="width:285px;">抑制启用注释的警告</td> 
 </tr> 
 <tr> 
 <td>deprecation</td> 
 <td>to suppress warnings relative to deprecation</td> 
 <td style="width:285px;">抑制过期方法警告</td> 
 </tr> 
 <tr> 
 <td>fallthrough</td> 
 <td>to suppress warnings relative to missing breaks in switch statements</td> 
 <td style="width:285px;">抑制确在开关中缺失破坏的警告</td> 
 </tr> 
 <tr> 
 <td>finally&nbsp;</td> 
 <td>to suppress warnings relative to finally block that don’t return</td> 
 <td style="width:285px;">抑制终于模块没有返回的警告</td> 
 </tr> 
 <tr> 
 <td>hiding</td> 
 <td>to suppress warnings relative to locals that hide variable</td> 
 <td style="width:285px;">&nbsp;</td> 
 </tr> 
 <tr> 
 <td>incomplete-switch</td> 
 <td>to suppress warnings relative to missing entries in a switch statement (enum case)</td> 
 <td style="width:285px;">忽略没有完整的开关语句</td> 
 </tr> 
 <tr> 
 <td>nls</td> 
 <td>to suppress warnings relative to non-nls string literals</td> 
 <td style="width:285px;">忽略非NLS格式的字符</td> 
 </tr> 
 <tr> 
 <td>null</td> 
 <td>to suppress warnings relative to null analysis</td> 
 <td style="width:285px;">忽略对空的操作</td> 
 </tr> 
 <tr> 
 <td>rawtypes</td> 
 <td>to suppress warnings relative to un-specific types when using generics on class params</td> 
 <td style="width:285px;">使用仿制药时忽略没有指定相应的类型</td> 
 </tr> 
 <tr> 
 <td>restriction</td> 
 <td>to suppress warnings relative to usage of discouraged or forbidden references</td> 
 <td style="width:285px;">&nbsp;</td> 
 </tr> 
 <tr> 
 <td>serial</td> 
 <td>to suppress warnings relative to missing serialVersionUID field for a serializable class</td> 
 <td style="width:285px;">忽略在序列化类中没有声明的serialVersionUID变量</td> 
 </tr> 
 <tr> 
 <td>static-access</td> 
 <td>to suppress warnings relative to incorrect static access</td> 
 <td style="width:285px;">抑制不正确的静态访问方式警告</td> 
 </tr> 
 <tr> 
 <td>synthetic-access&nbsp;</td> 
 <td>to suppress warnings relative to unoptimized access from inner classes</td> 
 <td style="width:285px;">抑制子类没有按最优方法访问内部类的警告</td> 
 </tr> 
 <tr> 
 <td>unchecked</td> 
 <td>to suppress warnings relative to unchecked operations</td> 
 <td style="width:285px;">抑制没有进行类型检查操作的警告</td> 
 </tr> 
 <tr> 
 <td>unqualified-field-access</td> 
 <td>to suppress warnings relative to field access unqualified</td> 
 <td style="width:285px;">抑制没有权限访问的域的警告</td> 
 </tr> 
 <tr> 
 <td>unused</td> 
 <td>to suppress warnings relative to unused code</td> 
 <td style="width:285px;">抑制没被使用过的代码的警告</td> 
 </tr> 
 </tbody> 
</table>

[70]: /images/20220514/b430fc021f524474bd1921d30ac234c4.png