Java_開發中:@SuppressWarnings("unchecked")的意思

J2SE 提供的最後一個批註是 @SuppressWarnings。該批註的做用是給編譯器一條指令，告訴它對被批註的代碼元素內部的某些警告保持靜默。

一點背景：J2SE 5.0 爲 Java 語言增長了幾個新的特性，而且和它們一塊兒增長了許多新的警告並承諾在未來增長更多的警告。您能夠爲 "javac" 增長 -Xlint 參數來控制是否報告這些警告（如上面的 @Deprecated 部分所示）。

默認狀況下，Sun 編譯器以簡單的兩行的形式輸出警告。經過添加 -Xlint:keyword 標記（例如 -Xlint:finally），您能夠得到關鍵字類型錯誤的完整說明。經過在關鍵字前面添加一個破折號，寫爲 -Xlint:-keyword，您能夠取消警告。（-Xlint 支持的關鍵字的完整列表能夠在 javac 文檔頁面上找到。）下面是一個清單：

關鍵字	用途
deprecation	使用了不同意使用的類或方法時的警告
unchecked	執行了未檢查的轉換時的警告，例如當使用集合時沒有用泛型 (Generics) 來指定集合保存的類型。
fallthrough	當 Switch 程序塊直接通往下一種狀況而沒有 Break 時的警告。
path	在類路徑、源文件路徑等中有不存在的路徑時的警告。
serial	當在可序列化的類上缺乏 serialVersionUID 定義時的警告。
finally	任何 finally 子句不能正常完成時的警告。
all	關於以上全部狀況的警告。

@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 後面。  注意到了附加在 SuppressWarnings 批註後面的陌生的批註 @Target 和 @Retention 了嗎？這些稱爲元數據批註，它們描述了該批註在哪裏適用。我將在本系列的第二篇文章中介紹它們，以及介紹如何將元數據批註應用到您本身的批註中。