java中@SuppressWarnings注解用法詳解
SuppressWarnings注解是jse提供的注解。作用是屏蔽一些無關(guān)緊要的警告。使開發(fā)者能看到一些他們真正關(guān)心的警告。從而提高開發(fā)者的效率
簡介:java.lang.SuppressWarnings是J2SE 5.0中標準的Annotation之一。可以標注在類、字段、方法、參數(shù)、構(gòu)造方法,以及局部變量上。作用:告訴編譯器忽略指定的警告,不用在編譯完成后出現(xiàn)警告信息。
使用:
@SuppressWarnings(“”) @SuppressWarnings({}) @SuppressWarnings(value={})根據(jù)sun的官方文檔描述:value - 將由編譯器在注釋的元素中取消顯示的警告集。允許使用重復(fù)的名稱。忽略第二個和后面出現(xiàn)的名稱。出現(xiàn)未被識別的警告名不是 錯誤:編譯器必須忽略無法識別的所有警告名。但如果某個注釋包含未被識別的警告名,那么編譯器可以隨意發(fā)出一個警告。
各編譯器供應(yīng)商應(yīng)該將它們所支持的警告名連同注釋類型一起記錄。鼓勵各供應(yīng)商之間相互合作,確保在多個編譯器中使用相同的名稱。
示例:@SuppressWarnings('unchecked')
告訴編譯器忽略 unchecked 警告信息,如使用List,ArrayList等未進行參數(shù)化產(chǎn)生的警告信息。
@SuppressWarnings('serial')
如果編譯器出現(xiàn)這樣的警告信息:The serializable class WmailCalendar does not declare a static final serialVersionUID field of type long,使用這個注釋將警告信息去掉。
@SuppressWarnings('deprecation')
如果使用了使用@Deprecated注釋的方法,編譯器將出現(xiàn)警告信息。使用這個注釋將警告信息去掉。
@SuppressWarnings('unchecked', 'deprecation')
告訴編譯器同時忽略unchecked和deprecation的警告信息。
@SuppressWarnings(value={'unchecked', 'deprecation'})
等同于@SuppressWarnings('unchecked', 'deprecation')
@SuppressWarnings注解的作用J2SE 提供的最后一個批注是 @SuppressWarnings。該批注的作用是給編譯器一條指令,告訴它對被批注的代碼元素內(nèi)部的某些警告保持靜默。@SuppressWarnings 批注允許您選擇性地取消特定代碼段(即,類或方法)中的警告。其中的想法是當(dāng)您看到警告時,您將調(diào)查它,如果您確定它不是問題,您就可以添加一個 @SuppressWarnings 批注,以使您不會再看到警告。雖然它聽起來似乎會屏蔽潛在的錯誤,但實際上它將提高代碼安全性,因為它將防止您對警告無動于衷 — 您看到的每一個警告都將值得注意。
我經(jīng)常遇到的問題是不曉得什么時候用@SupressWarnings的什么批注好,所以做了如下整理
使用:
@SuppressWarnings(“”) @SuppressWarnings({}) @SuppressWarnings(value={}) 一.@SuppressWarings注解作用:用于抑制編譯器產(chǎn)生警告信息。
示例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 的源碼可知,其注解目標為類、字段、函數(shù)、函數(shù)入?yún)ⅰ?gòu)造函數(shù)和函數(shù)的局部變量。而大家建議注解應(yīng)聲明在最接近警告發(fā)生的位置。
三.抑制警告的關(guān)鍵字抑制警告的關(guān)鍵字
all to suppress all warnings (抑制所有警告) boxing to suppress warnings relative to boxing/unboxing operations(抑制裝箱、拆箱操作時候的警告) cast to suppress warnings relative to cast operations (抑制映射相關(guān)的警告) 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(抑制確在switch中缺失breaks的警告) finally to suppress warnings relative to finally block that don’t return (抑制finally模塊沒有返回的警告) 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)(忽略沒有完整的switch語句) nls to suppress warnings relative to non-nls string literals(忽略非nls格式的字符) null to suppress warnings relative to null analysis(忽略對null的操作) rawtypes to suppress warnings relative to un-specific types when using generics on class params(使用generics時忽略沒有指定相應(yīng)的類型) 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(忽略在- - - -- - serializable類中沒有聲明serialVersionUID變量) static-access to suppress warnings relative to incorrect static access(抑制不正確的靜態(tài)訪問方式警告) synthetic-access to suppress warnings relative to unoptimized access from inner classes(抑制子類沒有按最優(yōu)方法訪問內(nèi)部類的警告) unchecked to suppress warnings relative to unchecked operations(抑制沒有進行類型檢查操作的警告) unqualified-field-access to suppress warnings relative to field access unqualified (抑制沒有權(quán)限訪問的域的警告) unused to suppress warnings relative to unused code (抑制沒被使用過的代碼的警告)到此這篇關(guān)于java中@SuppressWarnings注解用法詳解的文章就介紹到這了,更多相關(guān)java @SuppressWarnings注解內(nèi)容請搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
