第73條 拋出與抽象對(duì)應(yīng)的異常
-
更高層的實(shí)現(xiàn)應(yīng)該捕獲底層的異常,同時(shí)拋出可以按照高層抽象進(jìn)行解釋的異常。這種做法稱為*異常轉(zhuǎn)義
// 來自AbstractSequentialList的get方法 public E get(int index) { ListIterator<E> i = listIterator(index); try { return i.next(); } catch (NoSuchElementException e) { throw new IndexOutOfBoundsException("Index: " + index); } } -
一種特殊的異常轉(zhuǎn)譯形式被稱為異常鏈,如果底層的異常對(duì)于調(diào)試導(dǎo)致高層異常的問題非常有幫助,使用異常鏈就很合適。底層的異常原因被傳到高層的異常,高層的異常提供訪問方法
Throwable.getCause來獲得底層的異常try { ... // Use lower-level abstraction to do our bidding } catch (LowerLevelException cause) { throw new HigherLevelException(cause); } 對(duì)于沒有支持鏈的異常,可以利用
Throwable的initCause方法設(shè)置原因盡管異常轉(zhuǎn)譯與不加選擇地從底層傳遞異常的做法相比有所改進(jìn),但是它也不能被濫用。可以在給底層傳遞參數(shù)之前,檢查更高層方法的參數(shù)的有效性,從而避免底層方法拋出異常
思考
- 我們編寫業(yè)務(wù)代碼,很少會(huì)自己構(gòu)造異常鏈,我們基本上也不會(huì)主動(dòng)拋出異常。我們一般情況下都是會(huì)使用
getCause方法判斷異常原因。比如我們會(huì)在transaction結(jié)束的時(shí)候catch住異常,不斷getCause拿到最底層的報(bào)錯(cuò)原因,判斷是否是數(shù)據(jù)庫報(bào)了樂觀鎖,從而進(jìn)入不同的異常處理flow
第74條 每個(gè)方法拋出的所有異常都要建立文檔
- 始終要單獨(dú)地聲明受檢的異常,使用
@throws標(biāo)記,準(zhǔn)確地記錄下拋出每個(gè)異常的條件 - 永遠(yuǎn)不要聲明一個(gè)方法
throws Exception,或者throws Throwable - 使用
@throws標(biāo)簽記錄下一個(gè)方法可能拋出的每個(gè)未受檢異常,但是不要在未受檢異常上使用throws關(guān)鍵字 - 如果一個(gè)類中的許多方法出于同樣的原因而拋出同一個(gè)異常,則可以在類的文檔注釋中記錄異常
思考
- 一般的開發(fā)中,我很少一個(gè)方法會(huì)
throws一個(gè)Exception,最多會(huì)在參數(shù)校驗(yàn)失敗或者其它極端的情況throw IllegalArgumentException,這其實(shí)一般情況寫也是不會(huì)發(fā)生的。這種throws一般出現(xiàn)在框架代碼中,給其它的業(yè)務(wù)開發(fā)者使用,業(yè)務(wù)代碼里很少會(huì)看到一個(gè)方法會(huì)看到throws