@SuppressWarnings 详解

た入场券 2022-07-15 16:44 172阅读 0赞

[http://www.iteye.com/topic/231224][http_www.iteye.com_topic_231224]

@SuppressWarnings

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

一点背景：J2SE 5.0 为 Java 语言增加了几个新的特性，并且和它们一起增加了许多新的警告并承诺在将来增加更多的警告。您可以为 "javac" 增加 \-Xlint 参数来控制是否报告这些警告（如上面的 @Deprecated 部分所示）。

默认情况下，Sun 编译器以简单的两行的形式输出警告。通过添加 \-Xlint:*keyword* 标记（例如 \-Xlint:finally），您可以获得关键字类型错误的完整说明。通过在关键字前面添加一个破折号，写为 \-Xlint:*-keyword*，您可以取消警告。（\-Xlint 支持的关键字的完整列表可以在 [javac 文档页面][javac]上找到。）下面是一个清单：

<table style="color:rgb(0,0,0); font-family:Helvetica,Tahoma,Arial,sans-serif; font-size:14px; background-color:rgb(239,239,239)"> 
 <tbody> 
 <tr> 
 <td style="font-size:1em; padding:5px">关键字</td> 
 <td style="font-size:1em; padding:5px">用途</td> 
 </tr> 
 <tr> 
 <td style="font-size:1em; padding:5px">deprecation</td> 
 <td style="font-size:1em; padding:5px">使用了不赞成使用的类或方法时的警告</td> 
 </tr> 
 <tr> 
 <td style="font-size:1em; padding:5px">unchecked</td> 
 <td style="font-size:1em; padding:5px">执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型。</td> 
 </tr> 
 <tr> 
 <td style="font-size:1em; padding:5px">fallthrough</td> 
 <td style="font-size:1em; padding:5px">当 Switch 程序块直接通往下一种情况而没有 Break 时的警告。</td> 
 </tr> 
 <tr> 
 <td style="font-size:1em; padding:5px">path</td> 
 <td style="font-size:1em; padding:5px">在类路径、源文件路径等中有不存在的路径时的警告。</td> 
 </tr> 
 <tr> 
 <td style="font-size:1em; padding:5px">serial</td> 
 <td style="font-size:1em; padding:5px">当在可序列化的类上缺少 serialVersionUID 定义时的警告。</td> 
 </tr> 
 <tr> 
 <td style="font-size:1em; padding:5px">finally</td> 
 <td style="font-size:1em; padding:5px">任何 finally 子句不能正常完成时的警告。</td> 
 </tr> 
 <tr> 
 <td style="font-size:1em; padding:5px">all</td> 
 <td style="font-size:1em; padding:5px">关于以上所有情况的警告。</td> 
 </tr> 
 </tbody> 
</table>

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

下面是使用 @SuppressWarnings 来取消 deprecation 警告的一个例子：

public class DeprecatedExample2 {
      @Deprecated
      public static void foo() {
      }
    }
    
    public class DeprecatedUser2 {
      @SuppressWarnings(value={"deprecation"})
    public static void main(String[] args) {
        DeprecatedExample2.foo();
      }
    }

@SuppressWarnings 批注接收一个 "value" 变量，该变量是一个字符串数组，它指示将取消的警告。合法字符串的集合随编译器而变化，但在 JDK 上，可以传递给 \-Xlint 的是相同的关键字集合（非常方便）。并且要求编译器忽略任何它们不能识别的关键字，这在您使用一些不同的编译器时非常方便。

因为 @SuppressWarnings 批注仅接收一个参数，并为该参数使用了特殊的名称 "value"，所以您可以选择省略 value=，作为一种方便的缩写：

public class DeprecatedUser2 {
      @SuppressWarnings({"deprecation"})
    public static void main(String[] args) {
        DeprecatedExample2.foo();
      }
    }

您可以将单个数组参数中的任意数量的字符串值传递给批注，并在任何级别上放置批注。例如，以下示例代码指示将取消整个类的 deprecation 警告，而仅在 main() 方法代码内取消 unchecked 和 fallthrough 警告：

import java.util.*;
    
    @SuppressWarnings({"deprecation"})
    public class NonGenerics {
    
      @SuppressWarnings({"unchecked","fallthrough"})
    public static void main(String[] args) {
        Runtime.runFinalizersOnExit();
    
        List list = new ArrayList();
        list.add("foo");
      }
    
      public static void foo() {
        List list = new ArrayList();
        list.add("foo");
      }
    }

@SuppressWarnings 是否比前两个批注更有用？绝对是这样。不过，在 JDK 1.5.0 版本中还没有完全支持该批注，如果您用 1.5.0 来尝试它，那么它将类似无操作指令。调用 -Xlint:-deprecation 也没有任何效果。Sun 没有声明什么时候将增加支持，但它暗示这将在即将推出的一个 dot 版本中实现。

更进一步

如果您试图在 Javadocs 页面中查看这些属性，那么您可能很难找到它们。它们位于核心的 java.lang 包中，但有点隐蔽，它们出现在 Javadoc 类的最底端，列在 Exceptions 和 Errors 后面。

[http_www.iteye.com_topic_231224]: http://www.iteye.com/topic/231224
[javac]: http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javac.html