1.9 Put, Add, and Set

某一天我去面試的時候, 面試我的工程師跟我聊到這三個名詞在Java裡面的意義, 會聊到這個是因為我們談到了Clean Code這本書, 剛好我們都拜讀過這本大作, 所以就聊了一下內容.

好的, 那這三個動詞有什麼差別各位看倌有想過嗎?

對於非native speaker的華人來說, 也許第一反應就是: 不就是插放進去嗎!?

其實不然, 這邊簡單分類一下, 希望大家在實作上也可以使用正確的動詞.

Put: 通常會看到這個動詞是在HashMap之類的資料結構上, 其特性是放入的資料是不重複的(HashMap是要放入K-V pair)

Add: 把可重複的東西放到collection中, 如list.add()

Set: 如一般POJO的setter, 把物件上的attribute value做更改/新增

錯誤的方法命名可能會導致呼叫API的人誤解API行為, 進而導致程式出現bug. 譬如說, 你寫一個包含了add字眼的方法, 結果其他developer拿來用後, 發現有問題, 因為你這個addXXX的方法底層其實是在call HashMap的put.

所以, 在幫方法命名的時候, 要根據場合挑選合適的命名.

當然, 若你覺得我這邊寫的是錯的, 也麻煩糾正我一下.