### Long Method(過長函數)
擁有[短函數」(short methods)的對象會活得比較好、比較長。不熟悉面向對象技術的人,常常覺得對象程序中只有無窮無盡的delegation(委托),根本沒有進行任何計算。和此類程序共同生活數年之后,你才會知道,這些小小函數有多大價值。「間接層」所能帶來的全部利益——解釋能力、共享能力、選擇能力——都是由小型函數支持的(請看p.61的「闖接層和重構」〕。
很久以前程序員就巳認識到:程序愈長愈難理解。早期的編程語言中,「子程序調用動作」需要額外開銷,這使得人們不太樂意使用small method。現代OO語言幾乎已經完全免除了進程(process)內的「函數調用動作額外開銷」。不過代碼閱讀者還是得多費力氣,因為他必須經常轉換上下文去看看子程序做了什么。某些開發環境允許用戶同時看到兩個函數,這可以幫助你省去部分麻煩,但是讓small method容易理解的真正關鍵在于一個好名字。如果你能給函數起個好名字,讀者就可以通過名字了解函數的作用,根本不必去看其中寫了些什么。
最終的效果是:你應該更積極進取地分解函數。我們遵循這樣一條原則:每當感覺需要以注釋來說明點什么的時候,我們就把需要說明的東西寫進一個獨立函數中,并以其用途(而非實現手法)命名。我們可以對一組或甚至短短一行代碼做這件事。哪怕替換后的函數調用動作比函數自身還長,只要函數名稱能夠解釋其用途,我們也該毫不猶豫地那么做。關鍵不在于函數的長度,而在于函數「做什么」和「如何做」之間的語義距離。
百分之九十九的場合里,要把函數變小,只需使用Extract Method。找到函數中適合集在一起的部分,將它們提煉出來形成一個新函數。
如果函數內有大量的參數和臨時變量,它們會對你的函數提煉形成阻礙。如果你嘗試運用Extract Method,最終就會把許多這些參數和臨時變量當作參數,傳遞給被提煉出來的新函數,導致可讀性幾乎沒有任何提升。啊是的,你可以經常運用Replace Temp with Query 來消除這些暫時元素。Introduce Parameter Object 和Preserve Whole Object 則可以將過長的參數列變得更簡潔一些。
如果你已經這么做了,仍然有太多臨時變量和參數,那就應該使出我們的殺手锏: Replace Method with Method Object。
如何確定該提煉哪一段代碼昵? 一個很好的技巧是:尋找注釋。它們通常是指出「代碼用途和實現手法間的語義距離」的信號。如果代碼前方有一行注釋,就是在提醒 你:可以將這段代碼替換成一個函數,而且可以在注釋的基礎上給這個函數命名。就算只有一行代碼,如果它需要以注釋來說明,那也值得將它提煉到獨立函數去。
條件式和循環常常也是提煉的信號。你可以使用Decompose Conditional 處理條件式。至于循環,你應該將循環和其內的代碼提煉到一個獨立函數中。
- 譯序 by 侯捷
- 譯序 by 熊節
- 序言
- 前言
- 章節一 重構,第一個案例
- 起點
- 重構的第一步
- 分解并重組statement()
- 運用多態(Polymorphism)取代與價格相關的條件邏輯
- 結語
- 章節二 重構原則
- 何謂重構
- 為何重構
- 「重構」助你找到臭蟲(bugs)
- 何時重構
- 怎么對經理說?
- 重構的難題
- 重構與設計
- 重構與性能(Performance)
- 重構起源何處?
- 章節三 代碼的壞味道
- Duplicated Code(重復的代碼)
- Long Method(過長函數)
- Large Class(過大類)
- Long Parameter List(過長參數列)
- Divergent Change(發散式變化)
- Shotgun Surgery(散彈式修改)
- Feature Envy(依戀情結)
- Data Clumps(數據泥團)
- Primitive Obsession(基本型別偏執)
- Switch Statements(switch驚悚現身)
- Parallel Inheritance Hierarchies(平行繼承體系)
- Lazy Class(冗贅類)
- Speculative Generality(夸夸其談未來性)
- Temporary Field(令人迷惑的暫時值域)
- Message Chains(過度耦合的消息鏈)
- Middle Man(中間轉手人)
- Inappropriate Intimacy(狎昵關系)
- Alternative Classes with Different Interfaces(異曲同工的類)
- Incomplete Library Class(不完美的程序庫類)
- Data Class(純稚的數據類)
- Refused Bequest(被拒絕的遺贈)
- Comments(過多的注釋)
- 章節四 構筑測試體系
- 自我測試代碼的價值
- JUnit測試框架
- 添加更多測試
- 章節五 重構名錄
- 重構的記錄格式
- 尋找引用點
- 這些重構準則有多成熟
- 章節六 重新組織你的函數
- Extract Method(提煉函數)
- Inline Method(將函數內聯化)
- Inline Temp(將臨時變量內聯化)
- Replace Temp with Query(以查詢取代臨時變量)
- Introduce Explaining Variable(引入解釋性變量)
- Split Temporary Variable(剖解臨時變量)
- Remove Assignments to Parameters(移除對參數的賦值動作)
- Replace Method with Method Object(以函數對象取代函數)
- Substitute Algorithm(替換你的算法)
- 章節七 在對象之間搬移特性
- Move Method(搬移函數)
- Move Field(搬移值域)
- Extract Class(提煉類)
- Inline Class(將類內聯化)
- Hide Delegate(隱藏「委托關系」)
- Remove Middle Man(移除中間人)
- Introduce Foreign Method(引入外加函數)
- Introduce Local Extension(引入本地擴展)
- 章節八 重新組織數據
- Self Encapsulate Field(自封裝值域)
- Replace Data Value with Object(以對象取代數據值)
- Change Value to Reference(將實值對象改為引用對象)
- Replace Array with Object(以對象取代數組)
- Replace Array with Object(以對象取代數組)
- Duplicate Observed Data(復制「被監視數據」)
- Change Unidirectional Association to Bidirectional(將單向關聯改為雙向)
- Change Bidirectional Association to Unidirectional(將雙向關聯改為單向)
- Replace Magic Number with Symbolic Constant(以符號常量/字面常量取代魔法數)
- Encapsulate Field(封裝值域)
- Encapsulate Collection(封裝群集)
- Replace Record with Data Class(以數據類取代記錄)
- Replace Type Code with Class(以類取代型別碼)
- Replace Type Code with Subclasses(以子類取代型別碼)
- Replace Type Code with State/Strategy(以State/strategy 取代型別碼)
- Replace Subclass with Fields(以值域取代子類)
- 章節九 簡化條件表達式
- Decompose Conditional(分解條件式)
- Consolidate Conditional Expression(合并條件式)
- Consolidate Duplicate Conditional Fragments(合并重復的條件片段)
- Remove Control Flag(移除控制標記)
- Replace Nested Conditional with Guard Clauses(以衛語句取代嵌套條件式)
- Replace Conditional with Polymorphism(以多態取代條件式)
- Introduce Null Object(引入Null 對象)
- Introduce Assertion(引入斷言)
- 章節十一 處理概括關系
- Pull Up Field(值域上移)
- Pull Up Method(函數上移)
- Pull Up Constructor Body(構造函數本體上移)
- Push Down Method(函數下移)
- Push Down Field(值域下移)
- Extract Subclass(提煉子類)
- Extract Superclass(提煉超類)
- Extract Interface(提煉接口)
- Collapse Hierarchy(折疊繼承關系)
- Form Template Method(塑造模板函數)
- Replace Inheritance with Delegation(以委托取代繼承)
- Replace Delegation with Inheritance(以繼承取代委托)
- 章節十二 大型重構
- 這場游戲的本質
- Tease Apart Inheritance(梳理并分解繼承體系)
- Convert Procedural Design to Objects(將過程化設計轉化為對象設計)
- Separate Domain from Presentation(將領域和表述/顯示分離)
- Extract Hierarchy(提煉繼承體系)
- 章節十三 重構,復用與現實
- 現實的檢驗
- 為什么開發者不愿意重構他們的程序?
- 現實的檢驗(再論)
- 重構的資源和參考資料
- 從重構聯想到軟件復用和技術傳播
- 結語
- 參考文獻
- 章節十四 重構工具
- 使用工具進行重構
- 重構工具的技術標準(Technical Criteria )
- 重構工具的實用標準(Practical Criteria )
- 小結
- 章節十五 集成
- 參考書目