@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 來編譯原始碼了。
六、總結
現在再都不怕不知道設定斷點沒有咯!