Effective Java(3rd)-Item27 消除未經(jīng)檢查的警告

??當(dāng)你使用泛型編程時止吁,你將看到許多編譯警告:未檢查的強(qiáng)制轉(zhuǎn)換警告佳窑,未檢查的方法調(diào)用淋硝,未檢查的參數(shù)化vararg類型警告雹熬,以及未檢查的轉(zhuǎn)換警告。 使用泛型獲得的經(jīng)驗越多谣膳,得到的警告就越少竿报,但是不要期望新編寫的代碼能夠干凈地編譯。
??許多未檢查的異常很容易消除继谚。比如烈菌,假設(shè)你意外地編寫這段聲明:

Set exaltation = new HashSet();

編譯器將會溫柔地提醒你哪里錯了:


image.png

??然后你可以根據(jù)提示更正,從而警告消失。請注意芽世,你實際上不必指定類型參數(shù)挚赊,只需要表明它與Java7中引入的菱形操作符(<>)一起存在。編譯器將會正確推斷實際的類型參數(shù)(在這種情況下济瓢,類型是Lark):

Set exaltation = new HashSet<>();
??

如果你不能消除一個警告荠割,但是你可以證明引發(fā)警告的代碼是類型安全的,那么(只有在那個時候)使用@Suppress Warnings("uncheckded")注釋來抑制警告葬荷。如果你沒有在第一時間證明代碼是類型安全的就抑制警告了涨共,你就給了自己一個錯誤的安全感纽帖。代碼可以編譯而不發(fā)出任何警告宠漩,但是它仍然可以在運(yùn)行時拋出ClassCastException。但是懊直,如果你忽略了你知道是安全的未經(jīng)檢查的警告(而不是抑制它們)扒吁,那么你將不會注意到什么時候出現(xiàn)了新的警告,它代表了一個真正的問題室囊。新的警告將在你沒有沉默的所有虛假警報中消失
??SuppressWarnings注解可以在任何聲明上使用雕崩,從一個局部的本地變量聲明到一整個類。始終在最小范圍中使用SuppressWarnings注解融撞。通常盼铁,這將是一個變量聲明或一個非常小的方法或構(gòu)造方法。永遠(yuǎn)別再一整個類中使用SuppressWarnings尝偎。這么做會掩蓋關(guān)鍵的警告饶火。

??如果你發(fā)現(xiàn)自己在多行長的方法或構(gòu)造方法上使用了SuppressWarnings注解,你可以將其轉(zhuǎn)移到局部變量聲明中致扯。你可能需要聲明一個新的局部變量肤寝,但是這是值得的。例如抖僵,考慮這個toArray方法鲤看,它來自ArrayList。


image.png

??如果你編譯ArrayList耍群,該方法將會生成這個警告:


image.png

??在return語句上添加SuppressWarnings注解是非法的义桂,因為它不是一個聲明 [JLS, 9.7]你可能會嘗試將注釋放在整個方法上,但是不要這么做蹈垢。相反澡刹,聲明一個局部變量以保存返回值并注釋其聲明,如下所示:


image.png

??生成的方法可以干凈地編譯耘婚,并最小化未檢查的警告被抑制的范圍罢浇。
??每次你使用@SuppressWarnings(“unchecked”)注解,需要添加注釋說明為什么這么做是安全的。浙江幫助別人理解代碼嚷闭,更重要的是攒岛,它將降低有人修改代碼的可能性,而導(dǎo)致計算變得不安全胞锰。如果你覺得很難寫出這樣的注釋灾锯,那就繼續(xù)思考。你可能最終會發(fā)現(xiàn)未經(jīng)檢查的操作畢竟是不安全的嗅榕。

??總之顺饮,未經(jīng)檢查的警告是重要的。不要忽視它們凌那。每個未檢查警告代表了一個在運(yùn)行時潛在的ClassCastException危險兼雄。盡你最大的努力來消除這些警告。如果你不能消除未經(jīng)檢查的警告帽蝶,并可以證明引發(fā)該警告的代碼是類型安全赦肋,請在盡可能窄的范圍內(nèi)使用@SuppressWarnings("unChecking")注解來抑制警告。并在注釋中記錄你決定抑制警告的理由励稳。
本文寫于2019.6.7佃乘,歷時1天

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市驹尼,隨后出現(xiàn)的幾起案子趣避,更是在濱河造成了極大的恐慌,老刑警劉巖新翎,帶你破解...
    沈念sama閱讀 206,968評論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件程帕,死亡現(xiàn)場離奇詭異,居然都是意外死亡料祠,警方通過查閱死者的電腦和手機(jī)骆捧,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,601評論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來髓绽,“玉大人敛苇,你說我怎么就攤上這事∷撑唬” “怎么了枫攀?”我有些...
    開封第一講書人閱讀 153,220評論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長株茶。 經(jīng)常有香客問我来涨,道長,這世上最難降的妖魔是什么启盛? 我笑而不...
    開封第一講書人閱讀 55,416評論 1 279
  • 正文 為了忘掉前任蹦掐,我火速辦了婚禮技羔,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘卧抗。我一直安慰自己藤滥,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 64,425評論 5 374
  • 文/花漫 我一把揭開白布社裆。 她就那樣靜靜地躺著拙绊,像睡著了一般。 火紅的嫁衣襯著肌膚如雪泳秀。 梳的紋絲不亂的頭發(fā)上标沪,一...
    開封第一講書人閱讀 49,144評論 1 285
  • 那天,我揣著相機(jī)與錄音嗜傅,去河邊找鬼金句。 笑死,一個胖子當(dāng)著我的面吹牛磺陡,可吹牛的內(nèi)容都是我干的趴梢。 我是一名探鬼主播漠畜,決...
    沈念sama閱讀 38,432評論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼币他,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了憔狞?” 一聲冷哼從身側(cè)響起蝴悉,我...
    開封第一講書人閱讀 37,088評論 0 261
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎瘾敢,沒想到半個月后拍冠,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,586評論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡簇抵,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,028評論 2 325
  • 正文 我和宋清朗相戀三年庆杜,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片碟摆。...
    茶點故事閱讀 38,137評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡晃财,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出典蜕,到底是詐尸還是另有隱情断盛,我是刑警寧澤,帶...
    沈念sama閱讀 33,783評論 4 324
  • 正文 年R本政府宣布愉舔,位于F島的核電站钢猛,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏轩缤。R本人自食惡果不足惜命迈,卻給世界環(huán)境...
    茶點故事閱讀 39,343評論 3 307
  • 文/蒙蒙 一贩绕、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧壶愤,春花似錦丧叽、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,333評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至陕靠,卻和暖如春迂尝,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背剪芥。 一陣腳步聲響...
    開封第一講書人閱讀 31,559評論 1 262
  • 我被黑心中介騙來泰國打工垄开, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人税肪。 一個月前我還...
    沈念sama閱讀 45,595評論 2 355
  • 正文 我出身青樓溉躲,卻偏偏與公主長得像,于是被迫代替她去往敵國和親益兄。 傳聞我的和親對象是個殘疾皇子锻梳,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 42,901評論 2 345

推薦閱讀更多精彩內(nèi)容