chapter 1.
four parts of a method
- collecting input
- performing work
- delivering output
- handling failures
chapter 2.
1. We must identify the messages we want to send in order to accomplish the task at hand.
2. We must identify the roles which correspond to those messages.
3. We must ensure the method's logic receives objects which can play those roles
第二張 performing work
在講說
method裡面要做的事情
要定義好說
要傳遞的訊息是什麼（Message） 以及 誰接收這個訊息（Receiver Role）
def import_legacy_purchase_data(data)
purchase_list = legacy_data_parser.parse_purchase_records(data)
purchase_list.each do |purchase_record|
customer = customer_list.get_customer(purchase_record.email_address)
product = product_inventory.get_product(purchase_record.product_id)
customer.add_purchased_product(product)
customer.notify_of_files_available(product)
log_successful_import(purchase_record)
end
end
chapter 3.
3.2 Use built-in conversion protocols
If we want to provide maximum leeway in input, we can use explicit conversion methods like #to_i. If we want to provide a little exibility while ensuring that client code isn't blatantly mis-using our method, we can use an implicit conversion such as #to_int
3.3 Conditionally call conversion methods
在講說 有時候輸入的參數 要確認型別時 就條件式的轉換
她有這種型別方法的時候 就轉換
可能可以有好幾種型別 都沒有的時候就報錯
3.4 Define your own conversion protocols
建立自己的轉換型別的方法
3.5 Define conversions to user-defined types
定義好轉型的方法
主要方法接收參數時 只接有此轉型方法的參數
其餘的要報錯誤
3.6 Use built-in conversion functions
用最大的力量來轉型
3.7 Use the Array() conversion function to array-ify inputs
當參數需要是array時 用Array(參數) 先來強制轉型
3.8 Define conversion functions
建立一個idempotent的方法 強制轉換, 中間可能包含多種的轉換 不過結果就是出來一種型態
當我們需要某一個型態的時候 都用這個方法來強制轉換
3.9 Replace "string typing" with classes
當傳入的參數是string 而且方法裡面有很多case when的時候
試著把傳入的參數 變成有意義的物件
3.12 Reject unworkable values with preconditions
在preconditions就把一些需要的檢查做掉 還有需要使用到的變數轉換
3.13 Use #fetch to assert the presence of Hash keys
用fetch來判斷hash有沒有哪些key值
3.14 Use #fetch for defaults
用fetch來判斷default值
用block來當做參數 丟入fetch
If we had used the block form, the expensive computation would only have been triggered when it was actually needed.
3.15 Document assumptions with assertions
接外部可能會變動的api時
要再接的時候 針對每個參數 做處理檢查 一有不同 就要報錯
ex: hash要用 fetch確保參數都有, 型別轉換也要不是這個型別的話 就要報錯 Kernel#Float
amount = transaction.fetch("amount")
amount_cents = (Float(amount) * 100).to_i
3.16 Handle special cases with a Guard Clause
特別case的處理時 可以放在方法的最上方 當發生時 就導去別處
而不用因為用到if else 導致程式的結構不好閱讀
方法裡面主要就放常常發生的case
3.17 Represent special cases as objects
特別的case處理時 如果這個case再很多地方用到
可以用一個特別的class來處理他
例如current_user, 可以有一個特別的class => GuessUser 來代表沒有current_user的情況
3.18 Represent do-nothing cases as null objects
有時候會有一些要判斷是不是nil的情況時
可以用一個null object來處理 就不用寫很多if來判斷是不是nil
但是在null object裡面 log要寫好 不然有一些錯誤永遠不會發現
class NullObject < BasicObject
def method_missing(*) end
def respond_to_missing?(name) true end
def nil? true end
def ! true end
end
3.19 Substitute a benign value for nil
當nil的情況 是要走另一種情形 不會導致錯誤, 給他一個有意義的值
3.20 Use symbols as placeholder objects
當nil的情況 會導致錯誤時
給他一個有意義的symbol來報錯 會比較好debug
3.21 Bundle arguments into parameter objects
當兩個參數一定是要一起出現時 用一個物件把他包起來
當有if的情況出現時, 看是不是可以在refactor
3.22 Yield a parameter builder object
後面看不太懂
3.23 Receive policies instead of data
可以用block的方式 來做錯誤處理
def delete_files(files, &error_policy)
error_policy ||= ->(file, error) { raise error }
files.each do |file|
begin
File.delete(file)
rescue => error
error_policy.call(file, error)
end
end
end
4.1 Write total functions
當回傳的形態是array時
不管任何情形都要回array
4.2 Call back instead of returning
有時候用callback來取代回傳直會更好
用callback有時能更明顯的表達出這個function在做什麼
command-query separation (CQS). CQS is a simplifying principle of OO design which advises us to write methods which either have side effects (commands), or return values (queries), but never both
4.3 Represent failure with a benign value
不要用nil回復失敗的情況
用個有意義一點的值
4.4 Represent failure with a special case object
錯誤case時用特別的物件來回
反正不要nil就是了
4.5 Return a status object
當回傳情況有多種時 可以用一個新的狀態物件來回傳
4.6 Yield a status object
一樣用callback 可以讓function更清楚的表達她是要做什麼
callback是一個狀態物件的各種處理情形
就可以知道回傳的各種情況 是怎麼處理
4.7 Signal early termination with throw
用throw和catch來提早結束某些情況
5.1 Prefer top-level rescue clause
用top-level的rescue
5.2 Use checked methods for risky operations
還是用block的方式 傳入錯誤的時候要怎麼處理
5.3 Use bouncer methods
在用另一個方法 來包裝錯誤處理完後 要回傳的東西
