[筆記] Effective Java #74 每個方法拋出的所有異常都要建立文件

Effective Java 3rd 簡體中文版筆記 #74 每個方法拋出的所有異常都要建立文件
在丟出異常時，應該用 Javadoc 的 @throws 標籤，清楚說明每個異常丟出的原因，不要寫成throws Exception 或是 throws Throwable，這樣的寫法會讓調用者不知道到底會丟出什麼異常，更無法針對不同的異常來作對應的處理。
Javadoc 的 @throws 標籤，記錄方法會丟出的受檢異常，但是不要將未受檢異常寫在文件中，這樣有助於調用者區分兩者。另外，未受檢異常是有機會被 catch 住，有機會被吸收處理或異常轉譯。如果一個 class 中有許多方法基於相同原因都丟出同一個異常，那在 class 的文件中，說明該異常是可以接受的。

轉載請註明原文網址 https://cookieandcoketw.blogspot.com/2021/03/effective-java-74-exception-document.html