天天看點

@SuppressWarnings(unchecked)作用解釋文檔

解釋一:  

       屏蔽某些編譯時的警告資訊

        在強制類型轉換的時候編譯器會給出警告

       加上

       程式代碼

       @suppresswarnings("unchecked")

       就不會警告了

解釋二:

注釋類型

當你的編碼可能存在警告時,比如安全警告,可以用它來消除

api中是這樣描述的

訓示應該在注釋元素(以及包含在該注釋元素中的所有程式元素)中取消顯示指定的編譯器警告。注意,在給定元素中取消顯示的警告集是所有包含元素中取消顯示的警告的超集。例如,如果注釋一個類來取消顯示某個警告,同時注釋一個方法來取消顯示另一個警告,那麼将在此方法中同時取消顯示這兩個警告。

根據風格不同,程式員應該始終在最裡層的嵌套元素上使用此注釋,在那裡使用才有效。如果要在特定的方法中取消顯示某個警告,則應該注釋該方法而不是注釋它的類。

解釋三:

@suppresswarnings

j2se 提供的最後一個批注是 @suppresswarnings。該批注的作用是給編譯器一條指令,告訴它對被批注的代碼元素内部的某些警告保持靜默。

一點背景:j2se 5.0 為 java 語言增加了幾個新的特性,并且和它們一起增加了許多新的警告并承諾在将來增加更多的警告。您可以為"javac" 增加 -xlint 參數來控制是否報告這些警告(如上面的 @deprecated 部分所示)。

預設情況下,sun 編譯器以簡單的兩行的形式輸出警告。通過添加 -xlint:keyword 标記(例如 -xlint:finally),您可以獲得關鍵字類型錯誤的完整說明。通過在關鍵字前面添加一個破折号,寫為 -xlint:-keyword,您可以取消警告。(-xlint 支援的關鍵字的完整清單可以在 上找到。)下面是一個清單:

關鍵字

用途

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

----------------------------------------------------------------------------------------------------------------------------

about @suppresswarnings.

        項目組來了個很picky的頭,看到eclipse裡有大量的warning小發了下脾氣後,讓用@suppresswarnings這個标注來把warning去掉.

        為了去掉由于泛型的warning,我們用了@suppresswarnings("unchecked"),為了去掉那些由于deprecation而 引起的warning,用了@suppresswarnings("deprecation").但一個類中既有unchecked又有 deprecation時,怎麼辦?于是用了一個很權宜之計:在類聲明那用@suppresswarnings("deprecation"),而在相應 的方法聲明裡用@suppresswarnings("unchecked").

       用了效果當然也達到了,可就想問在一個單獨的@suppresswarnings裡既去掉deprecation又去掉unchecked呢?覺得應該可以達到的.于是就用下面的方式來試.

        1,@suppresswarnings("deprecation","unchecked"),不行,eclipse報錯.

         2,@suppresswarnings("deprecation,unchecked"),不行,還是報錯.

         3,看@suppresswarnings的源碼,隻有一個string[]類型的value.就想用@suppresswarnings(new string[]{"deprecation","unchecked"}),還是不行,報錯.

         4, google了下後,發現了這個@suppresswarnings(value={"deprecation"}),于是就想起來了 @suppresswarnings(value={"deprecation","unchecked"}).呵呵,成了.

        好久沒用接觸過标注了,快忘了. 現在記下來

繼續閱讀