@suppressWarnings("unchecked")在java中的作用


 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 了嗎?這些稱為元數據批注,它們描述了該批注在哪里適用。我將在本系列的第二篇文章中介紹它們,以及介紹如何將元數據批注應用到您自己的批注中。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM