注解用法详解——@SuppressWarnings

短命女 2022-04-08 08:01 229阅读 0赞

**一、前言　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　**

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

![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> 
 <tbody> 
  <tr> 
   <td><strong>关键字</strong></td> 
   <td><strong>用途</strong></td> 
  </tr> 
  <tr> 
   <td>all</td> 
   <td>to suppress all warnings</td> 
  </tr> 
  <tr> 
   <td>boxing&nbsp;</td> 
   <td>to suppress warnings relative to boxing/unboxing operations</td> 
  </tr> 
  <tr> 
   <td>cast</td> 
   <td>to suppress warnings relative to cast operations</td> 
  </tr> 
  <tr> 
   <td>dep-ann</td> 
   <td>to suppress warnings relative to deprecated annotation</td> 
  </tr> 
  <tr> 
   <td>deprecation</td> 
   <td>to suppress warnings relative to deprecation</td> 
  </tr> 
  <tr> 
   <td>fallthrough</td> 
   <td>&nbsp;to suppress warnings relative to missing breaks in switch statements</td> 
  </tr> 
  <tr> 
   <td>finally&nbsp;</td> 
   <td>to suppress warnings relative to finally block that don’t return</td> 
  </tr> 
  <tr> 
   <td>hiding</td> 
   <td>to suppress warnings relative to locals that hide variable</td> 
  </tr> 
  <tr> 
   <td>incomplete-switch</td> 
   <td>&nbsp;to suppress warnings relative to missing entries in a switch statement (enum case)</td> 
  </tr> 
  <tr> 
   <td>nls</td> 
   <td>&nbsp;to suppress warnings relative to non-nls string literals</td> 
  </tr> 
  <tr> 
   <td>null</td> 
   <td>to suppress warnings relative to null analysis</td> 
  </tr> 
  <tr> 
   <td>rawtypes</td> 
   <td>to suppress warnings relative to un-specific types when using generics on class params</td> 
  </tr> 
  <tr> 
   <td>restriction</td> 
   <td>to suppress warnings relative to usage of discouraged or forbidden references</td> 
  </tr> 
  <tr> 
   <td>serial</td> 
   <td>to suppress warnings relative to missing serialVersionUID field for a serializable class</td> 
  </tr> 
  <tr> 
   <td>static-access</td> 
   <td>o suppress warnings relative to incorrect static access</td> 
  </tr> 
  <tr> 
   <td>synthetic-access&nbsp;</td> 
   <td>&nbsp;to suppress warnings relative to unoptimized access from inner classes</td> 
  </tr> 
  <tr> 
   <td>unchecked</td> 
   <td>&nbsp;to suppress warnings relative to unchecked operations</td> 
  </tr> 
  <tr> 
   <td>unqualified-field-access</td> 
   <td>to suppress warnings relative to field access unqualified</td> 
  </tr> 
  <tr> 
   <td>unused</td> 
   <td>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/20220407/99a8a936252f4456ba4cd7ea4fa0acd8.png
[211648020124434.png]: /images/20220407/1417ead26ae4459e9559aaf5df22ecdd.png