JJava中@SuppressWarnings（"unchecked")
阿新 • • 發佈：2018-11-21
原文地址：http://blog.csdn.net/rznice/article/details/7105848
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 了嗎？這些稱為元資料批註，它們描述了該批註在哪裡適用。我將在本系列的第二篇文章中介紹它們，以及介紹如何將元資料批註應用到您自己的批註中。
原文地址：http://blog.csdn.net/rznice/article/details/7105848
J2SE 提供的最後一個批註是 @SuppressWarnings。該批註的作用是給編譯器一條指令，告訴它對被批註的程式碼元素內部的某些警告保持靜默。
一點背景：J2SE 5.0 為 Java 語言增加了幾個新的特性，並且和它們一起增加了許多新的警告並承諾在將來增加更多的警告。您可以為 "javac" 增加 -Xlint 引數來控制是否報告這些警告（如@Deprecated）。
預設情況下，Sun 編譯器以簡單的兩行的形式輸出警告。通過新增 -Xlint:keyword 標記（例如 -Xlint:finally），您可以獲得關鍵字型別錯誤的完整說明。通過在關鍵字前面新增一個破折號，寫為 -Xlint:-keyword，您可以取消警告。（-Xlint 支援的關鍵字的完整列表可以在 javac 文件頁面上找到。）下面是一個清單：
@SuppressWarnings 批註允許您選擇性地取消特定程式碼段（即，類或方法）中的警告。其中的想法是當您看到警告時，您將調查它，如果您確定它不是問題，您就可以新增一個 @SuppressWarnings 批註，以使您不會再看到警告。雖然它聽起來似乎會遮蔽潛在的錯誤，但實際上它將提高程式碼安全性，因為它將防止您對警告無動於衷 — 您看到的每一個警告都將值得注意。
下面是使用 @SuppressWarnings 來取消 deprecation 警告的一個例子：
@SuppressWarnings 批註接收一個 "value" 變數，該變數是一個字串陣列，它指示將取消的警告。合法字串的集合隨編譯器而變化，但在 JDK 上，可以傳遞給 -Xlint 的是相同的關鍵字集合（非常方便）。並且要求編譯器忽略任何它們不能識別的關鍵字，這在您使用一些不同的編譯器時非常方便。
因為 @SuppressWarnings 批註僅接收一個引數，併為該引數使用了特殊的名稱 "value"，所以您可以選擇省略 value=，作為一種方便的縮寫：
您可以將單個數組引數中的任意數量的字串值傳遞給批註，並在任何級別上放置批註。例如，以下示例程式碼指示將取消整個類的 deprecation 警告，而僅在 main() 方法程式碼內取消 unchecked 和 fallthrough 警告：
@SuppressWarnings 是否比前兩個批註更有用？絕對是這樣。不過，在 JDK 1.5.0 版本中還沒有完全支援該批註，如果您用 1.5.0 來嘗試它，那麼它將類似無操作指令。呼叫 -Xlint:-deprecation 也沒有任何效果。Sun 沒有宣告什麼時候將增加支援，但它暗示這將在即將推出的一個 dot 版本中實現。
更進一步
如果您試圖在 Javadocs 頁面中檢視這些屬性，那麼您可能很難找到它們。它們位於核心的 java.lang 包中，但有點隱蔽，它們出現在 Javadoc 類的最底端，列在 Exceptions 和 Errors 後面。
注意到了附加在 SuppressWarnings 批註後面的陌生的批註 @Target 和 @Retention 了嗎？這些稱為元資料批註，它們描述了該批註在哪裡適用。