書摘《設計重構》

閱讀時間約 27 分鐘


前言

程式的複雜度將隨程式的演化而遞增,除非採取措施來保持或降低複雜度。 —— 雷曼的複雜度遞增定律。 p. x

好的設計人員熟悉設計解決方案,而偉大的設計人員明白設計中的問題 (臭味)、導致問題的原因,以及如何應用成熟合理的設計原則來解決問題。 p. x

可利用設計臭味來幫助理解軟體工程師在應用設計原則時所犯的錯誤。 p. xiv

從違反了那些底層設計原則的角度來看待每種臭味時,我們對該臭味將有更深入的認識。更重要的是,這也自然而然地指出了消除該臭味的潛在重構方法。 p. xiv

Chapter 1 技術債

設計臭味是特定的設計結構,它們違反了基本設計原則,為設計品質帶來了負面影響。 p. 1

技術債是有意或無意地做出錯誤或非最佳的設計決策所引發的債務。 p. 2

在極端情況下,累積的技術債多到再也無力償還,只能放棄該軟體產品。這稱之為技術破產 (technical bankruptcy) p. 2

要求軟體開發人員以更快的速度時做出功能特性 (features)。在這種情況下,開發人員可能沒有機會或時間對設計決策的影響作出正確的評估。 p. 3

技術債影響軟體系統的內在品質,而這種內在品質不是終端用戶可以直接感知的。軟體公司很重視終端用戶,承擔不起失去終端用戶帶來的損失,因此缺陷獲得的關注最大,而與不可見的技術債相關的問題通常被拖延,甚至根本得不到解決。 p. 4

除技術難題外,技術債還會影響開發小組的士氣與積極性。隨著技術債不斷增加,軟體將難以修改,導致開發小組開始氣餒、煩悶。 p. 4

Chapter 2 設計臭味

心理學家注意到犯錯會促使人去學習,這種動力源自於發現自己犯錯時的詫異。 p. 9

設計原則為設計人員提供了指南,得以實現有效和高品質的軟體設計方案。如果設計人員違反了設計原則,這種違反將以臭味的方式呈現出來。 p. 12

有時候,架構師和設計人員使用著名的解決方案來解決問題時,並沒有完全明白這些解決方案所帶來的影響。這些解決方案通常是以設計模式的方式呈現,架構師/設計人員急於應用這些模式,卻沒有充分認識到必須平衡各種作用力。 p. 13

軟體黏滯性指的是採用正確的方案解決問題時所必將遇到的「阻力 (即需要付出更多的時間和精力)」。 p. 14

環境黏滯性指的是遵循最佳實踐時,必須克服的軟體開發環境帶來的阻力。 p. 14

我們將 Booch 提出的物件模型中的這四個主要元素視為設計原則,並將它們統稱為 PHAME (Principles of Hierarchy, Abstraction, Modularization, and Encapsulation,層級結構、抽象、模組化和封裝原則)。本書使用的臭味分類方案是根據這些原則而來,因此每種設計臭味都對應於受其負面影響最大的一種設計原則。 p. 16

臭味的名稱都由兩部分組成,其中第一部分為形容詞,它修飾違反的設計原則名稱 (第二部分)。 p. 17

Chapter 3 抽象型臭味

下面是我們透過實踐總結出來的一些重要實現手法,這些實現手法讓我們能夠在軟體設計中應用抽象原則。

  • 提供清晰的概念邊界和唯一身分
  • 映射領域實體
  • 確保內聚性和完整性
  • 賦予單一而重要的職責
  • 避免重複 p. 22

3.1 缺失抽象

使用一系列資料或編碼字串,而不建立類別或介面時,將引發這種臭味。 p. 24

通常缺乏抽象時,相關資料和行為將分散在其他抽象中,這將導致兩個問題:

  • 可能像其他抽象暴露時做細節,進而違反封裝原則。
  • 資料和相關行為分散在不同的抽象中,可能導致實體之間高度耦合 ... (略) ... 違反了模組化原則。 p. 24

要透過重構消除這種臭味,可建立在內部使用基本資料型別值或字串的抽象。 p. 26

要確定是否值得建立抽象,可檢查是否存在以下需求 (該清單只列出部分需求)。

  • 使用建構子初始化預設的資料值。
  • 驗證資料值。
  • 以漂亮的格式列印資料值。
  • 釋放已獲取的資源 (如果有)。 p. 29
每一節的標題即是一種設計臭味,以下都會類似上面這樣,僅摘錄臭味發生的原因、問題 (原理)、重構手法和現實考量。

3.2 命令式抽象

這種臭味是將操作轉換為類別所引起的,它的表現是類別指定義了一個方法,有時候類別名稱和該方法名稱相同。... (略) ... 這種臭味另一個經常的表現形式為,方法操作的資料位於另一個類別之中。 p. 29

將函數或過程明確定義為類別 (其處理的資料位於其他地方) 是典型的結構化編寫思維,而不是物件導向編寫思維。 p. 29

要透過重構消除「命令式抽象」設計臭味,必須找到或建立一個合適的抽象,並將命令式抽象中的方法一道這個抽象中。你還必須在該抽象封裝這些方法所需的資料,以提高內聚性並降低耦合度。 p. 32

具體化 (reification) 指的是將不是物件的東西提升為物件。將行為具體化後,便可對其進行儲存、傳遞和轉換。具體化可提高系統的靈活性,但代價是增加系統的複雜度。 p. 35

很多設計模式都利用了具體化:

  • 狀態模式
  • 命令模式
  • 策略模式 p. 35

換句話說,為提高可重用性、靈活性和可擴展性 (及改善設計品質) 而有意識地將原本不是物件的東西提升為物件時,這不算臭味。 p. 35

3.3 不完整的抽象

抽象未支援所有互補或相關的方法時,將導致這種臭味。 p. 36

為解決抽象曝路的介面不完整的問題,客戶程式可能試圖直接存取抽象的內部實作細節;因此,未正確應用抽象原則所帶來的副作用式可能違反封裝原則。 p. 36

重構方法是在抽象中添加所有缺失的方法。 p. 39

前後兩個方法指的是完全不同的概念啊...

有時候,設計人員可能有意識地做出不提供對稱或配套方法的設計決策。... (略) ... 在這種情況下,抽象看似不完整,但不算臭味。 p. 41

3.4 多方面抽象

抽象被賦予不指一項職責時,將導致這種臭味。 p. 42

設計元素的修改頻率與其缺陷數之間通常存在很強的正相關關係。這意味著多方面抽象存在的缺陷可能更多。 p. 42

具體地說,可建立新類別,並將存在「多方面抽象」臭味的類別中相關的方法和藍未一道新類別中。 p. 45

3.5 不必要的抽象

在軟體設計中引入實際上不需要 (即原本可以避免) 的抽象時,將導致這種臭味, p. 47

如果建立的抽象沒必要或只是為了方便,他們承擔的職責微不足道,甚至根本沒有承擔任何職責,這違反了抽象原則。 p. 47

介面是實作介面的類別必須支援的協議。將介面作為常數容器示範用抽象機制。 p. 49

我不否認自己會這麼用,因為不是所有的常數都適合用 enum 表示,也不是所有的常數都屬於實作細節,只能說有些語言對於常數確實不那麼友善。

有些設計模式 (如中介者模式、代理模式、門面模式和轉接器模式) 使用了委派,其中包含一個看似不必要的類別。... (略) ... 要判斷只執行委派的抽象是否多餘,必須以具體情況進行具體分析。 p. 51

3.6 未利用的抽象

建立的抽象未利用 (未被直接使用或繼承) 時,將導致這種臭味。 p. 52

設計應該服務於真實需求,而非憑空想像或推測的需求。未實作的抽象類別和介面是多餘或憑空想像出來的泛化,因此是不需要的。 p. 52

通常,開發人員不將就程式刪除的原因之一,他們不確定是否還有其他程式在使用它。 p. 53

最簡單的重構方法是,將未利用的抽象從程式中刪除。 p. 55

類別庫和框架通常以抽象類別或介面的方式提供擴展點,這些抽象類別或介面可能在函式庫或框架中未被使用,但他們是提供客戶程式使用的擴充點,因此不屬於未利用的抽象。 p. 56

3.7 重複的抽象

兩個抽象的名稱、實作或兩者皆相同時,將導致這種臭味。 p. 57

對名稱相同的重複抽象,重構建議是將其中一個抽象改為不同的名稱。對於實作相同的重複抽象,如果實作完全相同,可將其中一個實作刪除。 p. 61

導致重複抽象的一個原因是,要同時支援同步與非同步變形。 p. 63

事實上,要對大型系統,建立完全統一的領域模型要嘛不可行要嘛不划算。領域驅動設計提供一個解決方案是,將大型系統分成多個「有界上下文 (Bounded Context)」。採用這種方法時,不同上下文的模型可能包含同名的型別。有鑑於有界上下文是幫助處理大型領域建模問題的模式之一,這種在不同上下文使用同名型別的做法是可以接受的。 p. 63

Chapter 4 封裝行臭味

封裝原則倡導透過隱藏抽象的實作細節和隱藏變化等手法,來實作關注點分離和資訊隱藏。 p. 65

有兩種實作手法可有效地應用封裝原則:

  • 隱藏實作細節
  • 隱藏變化 p. 66

透過隱藏變化,更容易在不給客戶程式帶來太大影響的情況下修改抽象的實作。 p. 66

4.1 不充分的封裝

對於抽象的一個或多個成員,宣告的存取全縣超過了實際需求時,將導致這種臭味。 p. 67

這種臭味的一種極端表現形式是,存在一些用全域變數、全域資料結構等表示的全域狀態,整個軟體系統的所有抽象都可以存取他們。 p. 67

如果抽象曝露了實作細節,將導致抽象和客戶程式緊密耦合。這不可取,因為每當需要修改抽象的實作細節時,都將影響客戶程式。 p. 67

對於公有資料成員,可採取重構手法「對欄位進行封裝」,將欄位宣告為私有的,並提供必要的存取方法。對於與實作類別相關的公有方法,必須將其宣告為私有或受保護的。 p. 74

但說真的,若沒經過考慮,就把 set 加上去,其實跟公有成員是一樣的。

然而,由於當今的編譯器和 JIT 編譯器會內聯 (inline) 存取方法,因此使用存取方法帶來的效能影響通常微不足道。 p. 77

4.2 洩漏的封裝

抽象透過公有介面曝露或洩露實作細節時,將導致這種臭味。... (略) ... 即便抽象不吋在「不充分的封裝」臭味,其公有介面中的方法也可能洩露實作細節。 p. 77

重構建議是對介面進行修改,以免它曝露實作。例如,內部的演算法細節在公有介面上曝露,那麼就重構公有介面,以免它曝露演算法細節。 p. 81

向客戶程式返回指向內部資料結構的控制程式也不合適,因為這會讓客戶程式能透過該控制程式直接修改內部狀態。解決這種問題的方法有下列幾種:

  • 透過深複製建立一個物件副本,並返回該副本。
  • 建立並返回一個不可修改的物件。 p. 82
參考 閒談軟體設計:Immutable Interface

4.3 缺失封裝

沒有將實作變化封裝在抽象或 hierarchy 中,將導致這種臭味。 p. 85

將彼此獨立的各種關注點聚合在一個 hierarchy 中,而不是分開時,如果關注點發生變化,可能導致類別的數量呈爆炸性增長。 p. 87

重構建議是封裝變化。在實踐中,這通常是透過策略和橋街等模式來實現的。 p. 89

4.4 未利用的封裝

客戶程式使用顯式型別檢查 (使用一連串 if-else 語句或 switch 語句檢查物件的型別),而不利用 hierarchy 內以封裝的型別變化時,將導致這種臭味。 p. 93

顯式型別檢查讓客戶程式與具體型別緊密耦合,降低了設計的可維護性。例如,引入新型別後,必須修改客戶程式,在其中檢查新型別以執行相應操作的程式。 p. 93

參考 閒談軟體設計:Switch 壞味道

Chapter 5 模組化型臭味

模組化原則倡導利用集中和分解等手法建立高內聚、低耦合的抽象。 p. 101

本書中,模組這個術語指的是類別級抽象,即具體類別、抽象類別和介面。... (略) ... 實現手法如下:

  • 將先關的資料和方法集中在一起
  • 將抽象分解為易於管理的規模
  • 建立非循環依賴
  • 限制依賴關係數 p. 102

5.1 拆散的模組化

應集中在一個抽象中的資料和/或方法分散在多個抽象中時,將導致這種臭味。這種臭味的常見表現形式如下:

  • 類別被當作資料容器,其中沒有任何操作這些資料的方法。
  • 類別的方法更常被其他類別的成員呼叫。 p. 104

對於包含大量資料類別的程序型設計,可採用重構手法「將程序型設計轉換為物件導向」。在這類重構手法中,可以將資料成員以及與資料成員相關聯的行為移到同一個類別。 p. 107

為消除「拆散的模組化」臭味,將緊密相關的方法放到一個抽象之中,可能會導致「多方面抽象」或「不充分的模組化」臭味。有鑑於此,重構這種臭味時,需要特別小心。 p. 109

對於自動產生的程式,不推薦直接修改它們,因為這將導致模型與程式無法同步。有鑑於此,在自動產生的程式中包含資料類別可能是可以接受的。 p. 110

DTO 聚合資料,但不包含行為;這是有意為之的,只在方便同步。 p. 110

5.2 不充分的模組化

抽象分解得不徹底,且透過進一步分解,可以降低其規模和實作複雜度時,將導致這種臭味。這種臭味有以下兩種表現形式:

  • 臃腫的介面
  • 擁腫的實作 p. 110

兩種臭味常常同時出現:龐大而複雜的抽象常常承擔多項職責。然而,它們式兩種不同的臭味:即便抽象只承擔了一項職責,也可能龐大而複雜;同樣的,很小的抽象也可能承擔了多項職責。 p. 111

如果類別包含多組為不同客戶程式提供服務的方法,可以考慮應用介面分離原則 (ISP),將原來的介面分成多個針對不同客戶程式的介面。 p. 115

如果方法的邏輯很複雜,可以引入私有的輔助方法,以簡化該方法的程式。 p. 115

對於循環複雜度極高的複雜方法實作,必須編寫大量的測試案例,對其所有執行路徑進行測試。 p. 116

關鍵類別抽象了系統最重要的概念,通常龐大而複雜,並與系統的眾多其他類別緊密耦合。在真實的系統中,這樣的類別難以避免,但必須考慮如何分解它們以簡化維護工作,這很重要。 p. 117

5.3 循環依賴式模組化

多個抽象直接或間接彼此依賴,導致抽象之間緊密耦合時,將引發這種臭味。 p. 117

抽象之間存在循環依賴時,可能必須同時理解、修改、使用、測試和重用這些抽象。 p. 117

實作回呼 (callback) 功能時,常常會在兩個類別之間引入不必要的循環依賴。 p. 119

重構這種臭味,需要段開依賴環路。對此有很多策略,其中一些重要的策略如下:

  • 為環路中的抽象之一引入一個介面。
  • 如果有依賴是多餘的,完全可以刪除,即將該依賴刪除。
  • 將導致循環依賴的程式移到一個新的抽象中。
  • 如果從語意上說,循環依賴牽涉的抽象表示的是單一物件,可將這些抽象合併為單一抽象。 p. 122

有專門負責避免架構腐蝕或設計退化的架構師,這很重要。 p. 127

但說真的,很少有公司有這角色,參考 閒談軟體設計:架構師難尋?

對依賴循環牽涉的一個抽象進行修改時,可能引發連鎖反應,波及依賴鏈牽涉的所有類別 (包括最初修該的抽象)。導致無論是要理解、分析和實作新功能特性,還是修改依賴循環牽涉的任何抽象等等,都很困難。 p. 127

5.4 輪轂式模組化

這位翻譯難道不能挑個更簡單的名詞嗎?輪轂... 很冷僻的字耶,有人知道它原文是 Hub-like Modularization 嗎?

一個抽象與大量其他的抽象之間存在依賴關係時,將導致這種臭味。 p. 129

要重構這種臭味,可能需要採用下述一種或多種重構手法。

  • 如果樞紐類別承擔了多項職責,表示職責分配不合理,則重構建一是將那些職責化分給多個新/舊抽象。
  • 如果依賴關係是因為將成員錯誤地放到樞紐類別所導致的,則重構建議是將這些成員移到合適的抽象中。
  • 在有些情況下,可使用職責鏈模式來減少樞紐類別的被依賴關係數。 p. 131

Chapter 6 層次結構 (hierarchy) 型臭味

層次結構 (hierarchy) 原則倡導採用分類、合併、替換和排序等手法以層次方式組織抽象。 p. 135

在軟體設計中應用 hierarchy 的一些重要實現手法:

  • 進行有意義的分類
  • 進行有意義的合併
  • 確保可替換性
  • 避免冗餘路徑
  • 確保排列順序正確 p. 136

為了進行有意義的分類,在這個步驟中,應專注於型別行為 (而非資料) 的共同性和差異。 p. 136

確保 hierarchy 中的型別遵循里氏替換原則 (LSP),即可將超型別參照替換為子型別物件,而不會改變程式的行為。 p. 137

在繼承 hierarchy 中,子型別依賴於超型別很容易理解,但如果超型別依賴於子型別,設計就更難理解了,因為這違反了依賴順序原則。 p. 137

6.1 缺失 hierarchy

程式片段使用條件邏輯 (通常帶有標籤型態) 來顯式地管理行為變化,而原本可以建立一個 hierarchy 來封裝這些變化時,將導致這種臭味。 p. 139

當型別資訊被編碼,例如使用列舉、整數值或字串時,說明沒有正確地封裝行為變化,也未利用這些型別的共同性。 p. 139

可考慮使用以下手法來重構這種臭味:

  • 如果條件檢查中的多個實作呼叫的方法相同,可引入相關的介面來抽象共同的協議。
  • 可採取重構手法「提取 hierarchy」來建立一個類別 hierarchy,其中每個類別都表示條件檢查中的一種情形。如此便可透過執行期多型性來利用這個 hierarchy。 p. 142

如果應用程式需要與外部世界的實體互動 (例如以下的情形),要避免使用條件邏輯是很難的。

  • 讀取設定檔以修改應用程式在執行期的設定。
  • 根據應用程式的需求使用工廠實例化物件。

在這種情形下,不管設計中是否有對應於型別碼的 hierarchy,都可能必須使用以型別碼編寫的 switch 語句。 p. 146

6.2 不必要的 hierarchy

當整個繼承 hierarchy 顯得多餘,亦即在特定的設計片段中使用了不必要的繼承時,將導致這種臭味。 p. 146

所謂進行「有意義」的分類,指的是捕捉行為而不是資料層面的共同性和差異。 p. 146

可考慮採用以下重構策略:

  • 將 hierarchy 刪除,並將子型別替換為型別實例。
  • 將這個不必要的 hierarchy 刪除,並使用相應的語言特性。 p. 150

6.3 未合併的 hierarchy

hierarchy 中的型別存在不必要的重複十,將導致這種臭味。這種臭味有兩種表現形式。

  • 兄弟型別之間重複
  • 超型別與子型別之間重複。 p. 153

原因有三個:

  • 未合併介面
  • 未合併實作
  • 未合併介面和實作 p. 153

重構方法是應用「合併」原則。

  • 如果不同兄弟型別的方法簽章、方法定義或欄位相同,就將相關的方法介面、方法定義或欄位「上移」到超型別中。
  • 如果不同的兄弟型別中,方法定義類似但有些不同,就採取合適的手法提取這些子型別的共同性到超類別中。 p. 159

6.4 過寬的 hierarchy

當繼承 hierarchy 太寬,顯示可能缺失中間型別時,將導致這種臭味。 p. 163

根據我們的經驗,只要任何型別的直接子型別超過 9 個,這樣的 hierarchy 就太寬了。 p. 163

個人是沒印象有設計過有 9 個的情況,但這確實是個很大的數字。

對於過寬的 hierarchy,檢查其中是否缺失中間抽象。如果是這樣,就採用「提取超類別」的重構手法,並引入中間抽象。 p. 165

6.5 憑空想像的 hierarchy

根據憑空想像而非真實需求,在 hierarchy 中提供相應的型別時,將導致這種臭味。 p. 169

存在基於憑空想像的需求而建立的超型別時,可採取重構手法「緊縮 hierarchy」,將相關的超型別刪除。 p. 170

6.6 過深的 hierarchy

繼承 hierarchy 過深時,將導致這種臭味。 p. 172

hierarchy 過深時,要預測葉子型別 (leaf type) 的行為,難度將急遽增大,因為這種型別從其超類別那裏繼承了較多的方法。下面的範例說明了這種問題。

  • 位於頂部附近的超型別的方法可能在 hierarchy 中被改寫多次,因此,在葉子型別中,這個繼承方法的語意可能不清晰。
  • 超型別定義的欄位可能被子型別的方法隱藏。 p. 172

一種經驗法則是,如果 hierarchy 超過了 6 層,就可認為它太深了。 p. 172

太深的 hierarchy 包含不必要或憑空想像的中間抽象時,可採用重構方法「緊縮 hierarchy」。 p. 174

較深的繼承 hierarchy 可改善可重用性,很多使用廣泛的成熟框架和函式庫都包含很深的 hierarchy。因此,建立很深的 hierarchy 前,設計人員必須根據具體情況深利入考慮,權衡其利 (如提供可重用性) 弊 (如降低可理解性、可修改性、可擴展性、可靠性和效能)。 p. 178

6.7 叛逆型 hierarchy

子型別拒絕超型別提供的方法時,將導致這種臭味。 p. 178

子型別可修改從超型別那裡繼承的行為。改寫超型別的方法時,如果行為得到了改善 (即更具體),那麼這種修改是無害的。然而,如果改寫方法時限制或撤銷了超型別方法的行為,這種修改將是有害的。 p. 178

超型別的方法被有些子型別拒絕時,如果該方法只適用於部分子型別,可採用「移動方法 (move method)」的重構手法,將這些方法從超類別移到相關的子型別中。如果超型別的某個方法被所有子型別拒絕,可採用「刪除方法 (remove method)」的重構手法,將它從超型別中刪除。 p. 181

6.8 支離破碎的 hierarchy

當超型別和子型別之間從概念上來說不存在 is-a 關係,而導致可替換性遭到破壞時,將導致這種臭味。 p. 189

這種臭味的一種極端形式是,「反轉」了超型別和子型別之間的繼承關係。換句話說,子型別應為超型別,超型別應為子型別。 p. 189

簡單說,就是亂七八糟隨便繼承...

對於支離破碎的 hierarchy,通常採用重構手法「以委派取代繼承」。 p. 195

對於「反轉的 hierarchy」臭味,一種顯而易見的重構方案是,將超型別和子型別之間的繼承關係倒過來。 p. 196

6.9 多路徑 hierarchy

子型別同時直接和間接地繼承超型別,讓 hierarchy 包含不必要的繼承路徑實,將導致這種臭味。 p. 199

對於多路徑 hierarchy,重構建議是刪除 hierarchy 中不必要的繼承路徑。 p. 203

6.10 循環 hierarchy

在 hierarchy 中,超型別依賴於子型別實,將導致這種臭味。這種依賴性有以下表現形式:

  • 超型別包含子型別物件。
  • 超型別參照了子型別的名稱。
  • 超型別存取子型別的資料成員或呼叫其方法。 p. 206

超型別的建構子主動使用了子型別實,將導致一種很不可取的循環 hierarchy。因為初始化超型別實,子型別還未初始化,這可能導致超型別的程式存取子型別未初始化的部分。 p. 206

對於循環 hierarchy,可考慮採用以下的重構方法。

  • 如果超型別包含的子型別參照不是必要的,將該參照刪除。
  • 如果超型別和直接子型別偶和緊密,可考慮將它們合而為一。
  • 根據具體情況,採用重構手法「移動方法」或「提取類別」消除超類別到子類別的循環依賴。
  • 如果超型別必須使用子型別提供的服務,可考慮使用 State (狀態) 模式或 Strategy (策略) 模式。 p. 207

Chapter 7 臭味生態系統

我們發現了設計臭味的一些有趣特徵。如果設計一個由設計決策和臭味共同構成的生態系統,將發現臭味既影響該生態系統,也受該生態系統的影響。 p. 213

首先,臭味的存在很可能觸發消除它的新設計決策!其次,臭味可能影響或限制或旭設計決策,導致在設計生態系統中出現新的臭味。第三,臭味之間常常會互相影響。 p. 213

不知道有沒有像噬菌體這樣的臭味,可以修除別的臭味 XD

要確保整個設計的高品質,在做設計決策時必須對該決次會給整個設計帶來的利弊瞭如指掌。然而在實際工作中,軟體開發人員常常只關心設計決策的好處,對其弊端視而不見,進而在設計中引入了臭味。 p. 214

這真的蠻常見的,特別是想引入某個新技術時,推廣者會拼命說這個多好多好,卻從來不提引入後會帶來什麼缺點。

該採取什麼樣的重構解決方案呢?這記取決於存在的臭味,也取決於具體情況。重構時如果不考慮具體情況,很可能讓設計無謂地複雜化,乃至引入新的臭味。 p. 216

設計臭味可能強化其它夠味的影響。 p. 218

有些臭味常常與其它臭味同時出現。 p. 219

有些臭味常常是其他臭味的前導兵。 p. 220

在臭味之間存在因果關係時,透過是當的重構消除根臭味 (root smell) 後,根臭味導致的臭味將隨之消除。 p. 220

解決更深層的問題可能會給整體設計帶來極大的好處,因此我們強烈建議你不要滿足於找出設計中的臭味,而應該根據發現的臭味,找出設計中更深層的問題。 p. 222

修 bug 也是如此,參閱 書摘《程式設計守則》守則 13 | 揪出引發雪崩的那顆小石頭。

Chapter 8 技術債償還實戰

要提出正確的修改建議並進行修改,都必須理解程式的內部結構,這是一個重要的前提條件。... (略) ... 為應對這種挑戰,可使用理解工具來產生視覺化輔助元素,如控制結構視覺化、資料傳輸流分析、呼叫序列分析和繼承圖,以幫助理解程式的內部結構。 p. 224

技術債很難精確地量化,其中主要原因有兩個。首先,對於那些因素將導致技術債,並沒有統一的看法;其次,沒有度量這些因素的標準方式。 p. 225

對於評估和重構發現工具產生的違規結果或建議,只能做為參考。必須根據具體情況對這些結果進行詳盡的分析,以排除假陽性警報。 p. 225

如果不進行單元測試,就難以確保軟體重構後的行為不變;而要編寫單元測試,就必須先讓程式/設計是可測試的。這種重構任務陷入了兩難,在遺留專案中尤其如此,因為它們通常缺乏單元測試,但又必須重構。 p. 226

制定小規模的重構計畫。採取循序漸進的方式。 p. 228

量化重構前後的設計品質,以便能夠透過比較設計品質突顯出重購的正面影響。 p. 228

在實際工作中,「大刀闊斧」的重構方法效果不佳。 p. 231

每次發布主要版本後,都留出一段時間來完成重構任務,確保技術債處於可控狀態,然後在進行下一個主要版本的開發工作。 p. 232


這本書的寫作方式蠻像學期期刊論文的寫法,也詳盡地列出文獻,本書大多數的內容都以 OO 的概念出發,詳列了許多設計的臭味道,也有大量的例子。個人雖然不會這樣寫程式,但仍是覺得受益良多,至少在 code review 時能更清楚知道該怎麼描述問題。但對於不是用 OO 概念寫程式的人來說,大多數章節可能都覺得無感吧!

最近幾年的觀察,不確定是不是我的錯覺,data + function 反而比 OO 來的受歡迎,但以我自己的感覺,程式的規模大到一定的程度,團隊成員成長到一定的規模,重複的 function 肯定會變多,邏輯四散的情況會越嚴重,但就是找不到合適的方式整理,因為對不是用 OO 的人來說,就是不會有把資料和行為封裝成類別的概念。

書摘只精簡地列出臭味和重構方法,但個人十分建議看書中的範例,特別是對 OO 不習慣的人,看範例比較能清楚知道什麼是臭味道。不過,即便不是用 OO 的概念,有些章節還是可以帶來一些想法,用 OO 概念寫程式的人更不該錯過這本好書。

內容總結
設計重構
5
/5
53會員
104內容數
這是從 Medium 開始的一個專題,主要是想用輕鬆閒談的方式,分享這幾年軟體開發的心得,原本比較侷限於軟體架構,但這幾年的文章不僅限於架構,也聊不少流程相關的心得,所以趁換平台,順勢換成閒談軟體設計。
留言0
查看全部
發表第一個留言支持創作者!
Spirit的沙龍 的其他內容
實際就業後,會發現收集與分析需求,通常都不是工程師在做,會有另一群人,以非工程的角度收集及分析需求,然後在開發過程中蹦出不同的火花,於是很好奇另一群人的想法是什麼?我不敢說這本書能完全代表另一群人的想法,但確實能夠得到很多有用的思維。推薦給所有的軟體工程師。
4/5從需求到設計
本書介紹了戰略設計、管理領域複雜度、實際應用領域驅動設計等主題。透過對核心子領域、支持子領域、限界上下文等概念的探討,提供了領域驅動設計的相關知識。這篇文章中還涉及了微服務、事件驅動架構和資料網格等相關主題,提供了設計系統和應用領域驅動設計的指導。
4/5領域驅動設計學習手冊
這本書如果是剛看完《Clean Architecture》這本書,想要直接看答案怎麼實作,是可以當作一個起始點,但我會比較建議,自己循著書中前幾個章節提到的 principles,思考看看怎麼設計出一個符合大多數 principles 的方案,這會比較有趣。
4/5Clean Architecture 實作篇
本文介紹了建立高效的工作團隊所需的要素,從激勵和溝通到目標設定和團隊文化。團隊中最有影響力的人通常是真誠且善於聆聽的人,而不一定是經理或領導者。透過激勵、測試、測試再測試和克服人為障礙的過程,可以建立一支高效的團隊文化,這對團隊的成功至關重要。
內容十分精實,一百多頁很薄的一本書,但含了很多有用的資訊,就算不是開發微服務,書中的內容也可以用在很多雲端服務的開發與維運上。中文版唯一可惜的地方,翻譯非常不通順,很多不像中文的句子,會看到好幾個「與」連在一起用,標點符號的用法也有點怪,閱讀的痛苦指數有點高...
3/5高品質微服務
今天的任務是找到獨一無案的方法創造新事物,不只讓未來變得不一樣,而且要更好,所以我們要從 0 到 1。最重要的第一步是自己獨立思考。唯有重新看待世界,像古人首次見到它那樣覺得新鮮古怪,我們才能重新創造,並將更好的未來留給後世。
5/5從 0 到 1
實際就業後,會發現收集與分析需求,通常都不是工程師在做,會有另一群人,以非工程的角度收集及分析需求,然後在開發過程中蹦出不同的火花,於是很好奇另一群人的想法是什麼?我不敢說這本書能完全代表另一群人的想法,但確實能夠得到很多有用的思維。推薦給所有的軟體工程師。
4/5從需求到設計
本書介紹了戰略設計、管理領域複雜度、實際應用領域驅動設計等主題。透過對核心子領域、支持子領域、限界上下文等概念的探討,提供了領域驅動設計的相關知識。這篇文章中還涉及了微服務、事件驅動架構和資料網格等相關主題,提供了設計系統和應用領域驅動設計的指導。
4/5領域驅動設計學習手冊
這本書如果是剛看完《Clean Architecture》這本書,想要直接看答案怎麼實作,是可以當作一個起始點,但我會比較建議,自己循著書中前幾個章節提到的 principles,思考看看怎麼設計出一個符合大多數 principles 的方案,這會比較有趣。
4/5Clean Architecture 實作篇
本文介紹了建立高效的工作團隊所需的要素,從激勵和溝通到目標設定和團隊文化。團隊中最有影響力的人通常是真誠且善於聆聽的人,而不一定是經理或領導者。透過激勵、測試、測試再測試和克服人為障礙的過程,可以建立一支高效的團隊文化,這對團隊的成功至關重要。
內容十分精實,一百多頁很薄的一本書,但含了很多有用的資訊,就算不是開發微服務,書中的內容也可以用在很多雲端服務的開發與維運上。中文版唯一可惜的地方,翻譯非常不通順,很多不像中文的句子,會看到好幾個「與」連在一起用,標點符號的用法也有點怪,閱讀的痛苦指數有點高...
3/5高品質微服務
今天的任務是找到獨一無案的方法創造新事物,不只讓未來變得不一樣,而且要更好,所以我們要從 0 到 1。最重要的第一步是自己獨立思考。唯有重新看待世界,像古人首次見到它那樣覺得新鮮古怪,我們才能重新創造,並將更好的未來留給後世。
5/5從 0 到 1
你可能也想看
Google News 追蹤
Thumbnail
這個秋,Chill 嗨嗨!穿搭美美去賞楓,裝備款款去露營⋯⋯你的秋天怎麼過?秋日 To Do List 等你分享! 秋季全站徵文,我們準備了五個創作主題,參賽還有機會獲得「火烤兩用鍋」,一起來看看如何參加吧~
Thumbnail
今天是要開箱我大學同學的新家,喜歡童趣、獨特設計的話,可以參考看看~我個人覺得很像小朋友的遊樂園,可以玩可以鑽,果然很有他的個性! 以下是同學角度,正文開始: 我覺得現在大部分裝潢看起來都很像,木紋啊、白色啊,而我和我老婆就是想和人家不一樣,所以先開了設計要求,才去找適合的設計公司。
Thumbnail
一個互動列應用就像一塊積木,可以方便地與其他互動列應用組合在一起,進而完成高度複雜的工作。這就像只要掌握26個字母,就可以組合出近乎無限的單字。
Thumbnail
無論是參與面試或釐清需求,系統設計常常令人感到困惑,不知如何進行。 我想,原因大概有兩種。 首先,不同領域的系統通常都有不同的設計要素,如何找出這些要素進行提問? 其次,即便提出疑問找出重點,接下來要如何針對這些要素進行高層設計或規劃? 《系統設計面試指南》對於系統設計的初步規劃或高層結構提供合適的
Thumbnail
我想,回到Harvey Cox的論述,若讀者同意他所說的,勢必能夠帶給身處台灣的我們,再思一位「宗教徒」在現代公民社會中,該以甚麼樣的態度來生活。
Thumbnail
意料之外的有趣,內容說明「 幸災樂禍」這種任何人都有的劣根性,像是點開《爆笑一籮筐》的影片後,驚覺時間小偷的出現,或是看見別人吃鱉感到心情愉悅,不用恥於自身的道德虧損,這就是每個人都有的天性。
Thumbnail
《四宮格目標筆記》是一本標榜能夠擊退拖延的筆記術。書的內容簡單直白,分成「設定目標」、「四宮格筆記」兩個部分。書中花很多篇幅協助讀者列出目標。這些方法相當詳盡、又從很多面向切入,對於不清楚自己喜好的讀者幫助很大。 上篇將介紹書中關於「設立目標」的建議,四宮格筆記則會在下篇作介紹。
Thumbnail
龔立人老師對社會的弱勢社群,常有獨到的見解,本書先描述他怎樣看殘障人士,同性戀者和性工作者。他認為,「正常」和「不正常」是一種身分政治。作者以「不正常」來描述他相遇的人物,包括同性戀者、性工作者和精神病患者,從這種相遇,我們會看到正常化反映的權力和操縱。 生命可以有任務,但生命不是一個個任務。生命原
Thumbnail
羅蘭巴特的《明室》一書並非去定義何謂好的照片,而是因母親離去引起的哀愁,進而抽絲剝繭地探討攝影的本質;其中提到「知面」、「刺點」等概念,以及從攝影者、被攝者、觀賞者的三個面向解析攝影,都很有意思。 這一篇以筆記形式、僅簡單描述他的主要概念,並且嘗試以巴特的思路去探討今日的攝影。
Thumbnail
「這本書雖稱之為《教學筆記》,但更是自2009年第一屆畢業生邁入社會後10年來,金大建築的成果發表」。是在這教學相長的過程中每位同學、每位學長姐的學習成果。
Thumbnail
這個秋,Chill 嗨嗨!穿搭美美去賞楓,裝備款款去露營⋯⋯你的秋天怎麼過?秋日 To Do List 等你分享! 秋季全站徵文,我們準備了五個創作主題,參賽還有機會獲得「火烤兩用鍋」,一起來看看如何參加吧~
Thumbnail
今天是要開箱我大學同學的新家,喜歡童趣、獨特設計的話,可以參考看看~我個人覺得很像小朋友的遊樂園,可以玩可以鑽,果然很有他的個性! 以下是同學角度,正文開始: 我覺得現在大部分裝潢看起來都很像,木紋啊、白色啊,而我和我老婆就是想和人家不一樣,所以先開了設計要求,才去找適合的設計公司。
Thumbnail
一個互動列應用就像一塊積木,可以方便地與其他互動列應用組合在一起,進而完成高度複雜的工作。這就像只要掌握26個字母,就可以組合出近乎無限的單字。
Thumbnail
無論是參與面試或釐清需求,系統設計常常令人感到困惑,不知如何進行。 我想,原因大概有兩種。 首先,不同領域的系統通常都有不同的設計要素,如何找出這些要素進行提問? 其次,即便提出疑問找出重點,接下來要如何針對這些要素進行高層設計或規劃? 《系統設計面試指南》對於系統設計的初步規劃或高層結構提供合適的
Thumbnail
我想,回到Harvey Cox的論述,若讀者同意他所說的,勢必能夠帶給身處台灣的我們,再思一位「宗教徒」在現代公民社會中,該以甚麼樣的態度來生活。
Thumbnail
意料之外的有趣,內容說明「 幸災樂禍」這種任何人都有的劣根性,像是點開《爆笑一籮筐》的影片後,驚覺時間小偷的出現,或是看見別人吃鱉感到心情愉悅,不用恥於自身的道德虧損,這就是每個人都有的天性。
Thumbnail
《四宮格目標筆記》是一本標榜能夠擊退拖延的筆記術。書的內容簡單直白,分成「設定目標」、「四宮格筆記」兩個部分。書中花很多篇幅協助讀者列出目標。這些方法相當詳盡、又從很多面向切入,對於不清楚自己喜好的讀者幫助很大。 上篇將介紹書中關於「設立目標」的建議,四宮格筆記則會在下篇作介紹。
Thumbnail
龔立人老師對社會的弱勢社群,常有獨到的見解,本書先描述他怎樣看殘障人士,同性戀者和性工作者。他認為,「正常」和「不正常」是一種身分政治。作者以「不正常」來描述他相遇的人物,包括同性戀者、性工作者和精神病患者,從這種相遇,我們會看到正常化反映的權力和操縱。 生命可以有任務,但生命不是一個個任務。生命原
Thumbnail
羅蘭巴特的《明室》一書並非去定義何謂好的照片,而是因母親離去引起的哀愁,進而抽絲剝繭地探討攝影的本質;其中提到「知面」、「刺點」等概念,以及從攝影者、被攝者、觀賞者的三個面向解析攝影,都很有意思。 這一篇以筆記形式、僅簡單描述他的主要概念,並且嘗試以巴特的思路去探討今日的攝影。
Thumbnail
「這本書雖稱之為《教學筆記》,但更是自2009年第一屆畢業生邁入社會後10年來,金大建築的成果發表」。是在這教學相長的過程中每位同學、每位學長姐的學習成果。