Effective Java Item 58:優先使用 for-each 迴圈而非傳統 for 迴圈

整理 Effective Java 書中 Item 58: Prefer for-each loops to traditional for loops 心得筆記

主旨

在 Java 中處理陣列或集合時,for-each 迴圈(也叫 enhanced for loop)比傳統的 for 迴圈更簡潔、更安全、更容易維護。除非遇到特定場景(例如刪除元素、修改值、平行遍歷多集合),否則應優先使用 for-each。

Read more

Effective Java Item 57:縮小區域變數的使用範圍

整理 Effective Java 書中 Item 57: Minimize the scope of local variables 心得筆記

主旨

在 Java 裡,區域變數(local variables)應該只在真正需要的時候才宣告,並且讓它的「作用範圍」儘可能小。這樣做不僅能讓程式碼更清楚、易讀,也能有效降低 bug 發生的機率。

Read more

Effective Java Item 56:為所有公開的 API 元素撰寫文件註解

整理 Effective Java 書中 Item 56: Write doc comments for all exposed API elements 心得筆記

主旨

寫 Java 程式時,若要讓 API 好用、好維護,註解文件不可或缺。Java 提供的 JavaDoc 工具讓我們能直接從原始碼產生 API 文件,但前提是你要在類別、方法、欄位前寫好符合格式的「doc comment」。本篇說明該怎麼寫註解才真正有幫助,該注意的格式細節與常見錯誤。

Read more

Effective Java Item 55:謹慎使用 Optional 作為回傳值

整理 Effective Java 書中 Item 55: Use Optional judiciously 心得筆記

主旨

在 Java 8 以前,當方法沒辦法回傳有效值時,我們只有兩個選擇:拋出例外回傳 null。但這兩者都有明顯缺點。Java 8 引入的 Optional<T> 提供了更安全、更具表達力的選項,但這並不表示它應該無腦使用。

本篇會釐清什麼情況該用 Optional、什麼情況不該用,並提供實務建議。

Read more

Effective Java Item 54:回傳空集合或陣列,不要回傳 null

整理 Effective Java 書中 Item 54: Return empty collections instead of null心得筆記

主旨

當方法沒有資料可回傳時,有些人會選擇回傳 null,以代表「沒有資料」。但這麼做會讓呼叫端增加處理成本,也提高潛在錯誤發生的機率。正確做法應該是 回傳空的集合或陣列,這樣寫起來更簡潔、安全、直觀,也幾乎不會有效能損失。

Read more