1. 程式人生 > >@SuppressWarnings註解

@SuppressWarnings註解

簡介:java.lang.SuppressWarnings是J2SE5.0中標準的Annotation之一。可以標註在類、欄位、方法、引數、構造方法,以及區域性變數上。作用:告訴編譯器忽略指定的警告,不用在編譯完成後出現警告資訊。使用: @SuppressWarnings(“”) @SuppressWarnings({}) @SuppressWarnings(value={})

根據sun的官方文件描述: value -將由編譯器在註釋的元素中取消顯示的警告集。允許使用重複的名稱。忽略第二個和後面出現的名稱。出現未被識別的警告名不是錯誤:編譯器必須忽略無法識別的所有警告名。但如果某個註釋包含未被識別的警告名,那麼編譯器可以隨意發出一個警告。

各編譯器供應商應該將它們所支援的警告名連同註釋型別一起記錄。鼓勵各供應商之間相互合作,確保在多個編譯器中使用相同的名稱。

示例:

 @SuppressWarnings("unchecked")

告訴編譯器忽略 unchecked 警告資訊,如使用List,ArrayList等未進行引數化產生的警告資訊。

@SuppressWarnings("serial")

如果編譯器出現這樣的警告資訊:The serializable class WmailCalendar does notdeclare a static final serialVersionUID field of type long       使用這個註釋將警告資訊去掉。

@SuppressWarnings("deprecation")

如果使用了使用@Deprecated註釋的方法,編譯器將出現警告資訊。       使用這個註釋將警告資訊去掉。

@SuppressWarnings("unchecked", "deprecation")

告訴編譯器同時忽略unchecked和deprecation的警告資訊。

@SuppressWarnings(value={"unchecked", "deprecation"})

等同於@SuppressWarnings("unchecked", "deprecation")

轉自http://blog.sina.com.cn/s/blog_ad8b5870010166vt.html

編碼時我們總會發現如下變數未被使用的警告提示:

上述程式碼編譯通過且可以執行,但每行前面的“感嘆號”就嚴重阻礙了我們判斷該行是否設定的斷點了。這時我們可以在方法前新增 @SuppressWarnings("unused") 去除這些“感嘆號”。

二、 @SuppressWarings註解                            

  作用:用於抑制編譯器產生警告資訊。

  示例1——抑制單型別的警告:

@SuppressWarnings("unchecked")
public void addItems(String item){
  @SuppressWarnings("rawtypes")
   List items = new ArrayList();
   items.add(item);
}

  示例2——抑制多型別的警告:

@SuppressWarnings(value={"unchecked", "rawtypes"})
public void addItems(String item){
   List items = new ArrayList();
   items.add(item);
}

  示例3——抑制所有型別的警告:

@SuppressWarnings("all")
public void addItems(String item){
   List items = new ArrayList();
   items.add(item);
}

三、註解目標                                

 通過 @SuppressWarnings 的原始碼可知,其註解目標為類、欄位、函式、函式入參、建構函式和函式的區域性變數。

 而家建議註解應宣告在最接近警告發生的位置。

四、抑制警告的關鍵字                                

關鍵字 用途
all to suppress all warnings
boxing  to suppress warnings relative to boxing/unboxing operations
cast to suppress warnings relative to cast operations
dep-ann to suppress warnings relative to deprecated annotation
deprecation to suppress warnings relative to deprecation
fallthrough  to suppress warnings relative to missing breaks in switch statements
finally  to suppress warnings relative to finally block that don’t return
hiding to suppress warnings relative to locals that hide variable
incomplete-switch  to suppress warnings relative to missing entries in a switch statement (enum case)
nls  to suppress warnings relative to non-nls string literals
null to suppress warnings relative to null analysis
rawtypes to suppress warnings relative to un-specific types when using generics on class params
restriction to suppress warnings relative to usage of discouraged or forbidden references
serial to suppress warnings relative to missing serialVersionUID field for a serializable class
static-access o suppress warnings relative to incorrect static access
synthetic-access   to suppress warnings relative to unoptimized access from inner classes
unchecked  to suppress warnings relative to unchecked operations
unqualified-field-access to suppress warnings relative to field access unqualified
unused to suppress warnings relative to unused code

五、Java Lint選項                            

  1. lint的含義

  用於在編譯程式的過程中,進行更細節的額外檢查。

  2.  javac 的標準選項和非標準選項

     標準選項:是指當前版本和未來版本中都支援的選項,如 -cp 和 -d 等。

     非標準選項:是指當前版本支援,但未來不一定支援的選項。通過 javac -X 檢視當前版本支援的非標準選項。

  3. 檢視警告資訊

   預設情況下執行 javac 僅僅顯示警告的扼要資訊,也不過阻止編譯過程。若想檢視警告的詳細資訊,則需要執行 javac -Xlint:keyword 來編譯原始碼了。

六、總結                                  

  現在再都不怕不知道設定斷點沒有咯!