22種程式碼的壞味道

edithfang發表於2014-09-26



1.Duplicated Code(重複的程式碼)

臭味行列中首當其衝的就是Duplicated Code。如果你在一個以上的地點看到相同的程式結構,那麼當可肯定:設法將它們合而為一,程式會變得更好。

最單純的Duplicated Code就是[同一個class內的兩個方法含有相同表示式(expression)]。這時候你需要做的就是採用ExtractMethod提煉出重複的程式碼,然後讓這兩個地點都呼叫被提煉出來的那一段程式碼。

另一種常見情況就是[兩個互為兄弟(sibling)的subclasses內含有相同表示式]。要避免這種情況,只需要對兩個classes都使用Extract Method,然後再對被提煉出的程式碼使用Pull UpMethod,將它推入superclass內。如果程式碼之間只是類似,並非完全相同,那麼就得運用ExtractMethod將相似部分和差異部分割開,構成單獨一個方法。然後你可能發現或許可以運用Form Template Method獲得一個TemplateMethod設計模式。如果有些方法以不同的演算法做相同的事,你可以擇定其中較清晰的一個,並使用Substitute Algorithm將其它方法的演算法替換掉。

如果兩個毫不相關的classes內出現Duplicated Code,你應該考慮對其中一個使用ExtractClass,將重複程式碼提煉到一個獨立class中,然後在另一個class內使用這個新class。但是,重複程式碼所在的方法也可能的確只應該屬於某個class,另一個class只能呼叫它,抑或這個方法可能屬於第三個class,而另兩個classes應該引用這第三個class。你必須決定這個方法放在哪兒最合適,並確保它被安置後就不會再在其它任何地方出現。
2.Long Method(過長方法)

擁有[短方法](shortmethods)的物件會活得比較好、比較長。不熟悉物件導向技術的人,常常覺得物件程式中只有無窮無盡的delegation(委託),根本沒有進行任何計算。和此類程式共同生活數年之後,你才會知道,這些小小方法有多大價值。[間接層]所能帶來的全部利益——解釋能力、共享能力、選擇能力——都是由小型方法支援的。

很久以前程式設計師就已認識到:程式愈長愈難理解。早期的程式語言中,[子程式呼叫動作]需要額外開銷,這使得做你們不太樂意使用smallmethod,現代OO語言幾乎已經完全免除了程式內的[方法呼叫動作額外開銷]。不過程式碼閱讀者還是得多費力氣,因為他必須經常轉換上下文去看看子程式做了什麼。某些開發環境允許使用者同時看到兩個方法,這可以幫助你省去部分麻煩,但是讓smallmethod容易理解的真正關鍵在於一個好名字。如果你能給方法起個好名字,讀者就可以通過名字瞭解方法的作用,根本不必去看其中寫了些什麼。

最終的效果是:你應該更積極進取地分解方法。我們遵循這樣一條原則:每當感覺需要以註釋來說明點什麼的時候,我們就把需要說明的東西寫進一個獨立的方法中,並以其用途(而非實現手法)命名。我們可以對一組或甚至短短一行程式碼做這件事。哪怕替換後的方法呼叫動作比方法自身還長,只要方法名稱能夠解釋其用途,我們也該毫不猶豫地那麼做。關鍵不在於方法的長度,而在於方法[做什麼]和[如何做]之間的語義距離。

百分之九十九的場合裡,要把方法變小,只需使用Extract Method。找到方法中適合集在一起的部分,將它們提煉出來形成一個新方法。

如果方法內有大量的引數和臨時變數,它們會對你的方法提煉形成阻礙。如果你嘗試運用ExtractMethod,最終就會把許多這些引數和臨時變數當作引數,傳遞給被提煉出來的新方法,導致可讀性幾乎沒有任何提升。啊是的,你可以經常運用 Replace Tempwith Query則可以將過長的引數列變得更簡潔一些。

如果你已經這麼做,仍然有太多臨時變數和引數,那就應該拿出我們的殺手鐗:Replace Method with Method Object。

如何確定該提煉哪一段程式碼呢?一個很好的技巧是:尋找註釋。它們通常是指出[程式碼用途和實現手法間的語義距離]的訊號。如果程式碼前言有一行註釋,就是在提醒你:可以將這段程式碼替換成一個方法,而且可以在註釋的基礎上給這個方法命名。就算只有一行程式碼,如果它需要以註釋來說明,那也值得將它提煉到獨立的方法去。

條件式和迴圈常常也是提煉的訊號。你可以使用Decompose Conditional處理條件式。至於迴圈,你應該將迴圈和其內的程式碼提煉到一例獨立方法中。
3.Large Class(過大類)

如果想利用單一class做太多事情,其內往往就會出現太多instance變數。一旦如此,Duplicated Code也就接踵而至了。

你可以運用ExtractClass將數個變數一直提煉到新class內。提煉時應該選擇class內彼此相關的變數,將它們放在一直。例如”depositAmount”和”depositCurrency”可能應該隸屬同一個class。通常如果class內的數個變數有著相同的字首或字尾,這就意味有機會把它們提煉到某個元件內。如果這個元件適合作為一個subclass,你會發現ExtractSubclass往往比較簡單。

有時候class並非在所有時刻都使用所有instance變數。果真如此,你或許可以多次使用Extract Class或Extract Subclass。

和[太多instance變數]一樣,class內如果有太多程式碼,也是[]程式碼重複、混亂、死亡]的絕佳滋生地點。最簡單的解決方案是把贅餘的東西消弭於class內部。如果有五個[百行方法],它們之中很多程式碼都相同,那麼或許你可以把它們變成五個[十行方法]和十個提煉出來的[雙行方法]。

和[擁有太多instance變數]一樣,一個class如果擁有太多程式碼,往往也適合使用Extract Class和ExtractSubclass。這裡有個有用技巧:先確定客戶端如何使用它們,然後運用ExtractInterface為每一種使用一個介面。這或許可以幫助你看清楚如何分解這個class。

如果你的Large Class是個GUIclass,你可能需要把資料和行為移到一個獨立的領域物件去。你可能需要兩邊各保留一些重複資料,並令這些資料同步。Duplicate ObservedData告訴你該怎麼做。這種情況下,特別是如果你使用舊式AWT元件,你可以採用這種方式去掉GUI class並代以Swing元件。
4.Long Parameter List(過長引數列)

剛開始學習程式設計的時候,老師教我們:把方法所需的所有東西都以引數傳遞進去。這可以理解,因為除此之外就只能選擇全域性資料,而全域性資料是邪惡的東西。物件技術改變了這一情況,因為如果你手上沒有你所需要的東西,總可以叫另一個物件給你。因此,有了物件,你就不必把方法需要的所有東西都以引數傳遞給它了,你只需給它足夠的東西、讓方法能從中獲得自己需要的所有東西就行了。方法需要的東西多半可以在方法的宿主類(hostclass)中找到。物件導向程式中的方法,其引數列通常比在傳統程式中短得多。

這是好現象,因為太長的引數列難以理解,太多引數會造成前後不一致、不易使用,而且一旦你需要更多資料,就不得不修改它。如果將物件傳遞給方法,大多數修改都將沒有必要,因為你很可能只需(在方法內)增加一兩條請求,就能得到更多資料。

如果[向既有物件發出一條請求]就可以取得原本位於引數列上的一份資料,那麼你應該啟用重構準則Replace Parameter withMethod。上述的既有物件可能是方法所屬class內的一個欄位,也可能是另一個引數。你還可以運用Preserve WholeObject將來自同一物件的一堆資料收集起來,並以該物件替換它們。如果某些資料缺乏合理的物件歸屬,可使用Introduce ParameterObject為它們製造出一個[引數物件]。

此間存在一個重要的例外。有時候你明顯不希望造成[被呼叫之物件]與[較大物件]間的某種依存關係。這時候將資料從物件中拆解出來單獨作為引數,也很合情合理。但是請注意其所引發的代價。如果引數列太長或變化太頻繁,你就需要重新考慮自己的依存結構了。
5.Divergent Change(發散式變化)

我們希望軟體能夠更容易被修改——畢竟軟體再怎麼說本來就該是[軟]的。一旦需要修改,我們希望能夠跌到系統的某一點,只在該處做修改。如果不能做到這點,你就嗅出兩種緊密相關的刺鼻味道中的一種了。

如果某個class經常因為不同的原因在不同的方向上發生變化,Divergent Change就出現了。當你看著一個class說:“呃,如果新加入一個資料庫,我必須修改這三個方法;如果新出現一種金融工具,我必須修改這四個方法”,那麼此時也許將這個物件分成兩個會更好,這麼一來每個物件就可以只因一種變化而需要修改。當然,往往只有在加入新資料庫或新金融工具後,你才能發現這一點。針對某一外界變化的所有相應修改,都只應該發生在單一class中,而這個新class內的所有內容都應該反應該外界變化。為此,你應該找出因著某特定原因而造成的所有變化,然後運用ExtractClass將它們提煉到另一個class中。
6.Shotgun Surgery(霰彈式修改)

Shotgun Surgery類似DivergentChange,但恰恰相反。如果每遇到某種變化,你都必須在許多不同的class內做出許多小修改以響應之,你所面臨的壞味道就是ShotgunSurgery。如果需要修改的程式碼散佈四處,你不但很難找到它們,也很容易忘記某個重要的修改。

這種情況下你應該使用Move Method和MoveField把所有需要修改的程式碼放進同一個class。如果眼下沒有合適的class可以安置這些程式碼,就創造一個。通常你可以運用InlineClass把一系列相關行為放進同一個class。這可能會造成少量Divergent Change,但你可以輕易處理它。

Divergent Change是指[一個class受多種變化的影響],ShotgunSurgery則是指[一種變化引發多個classes相應修改]。這兩種情況下你都會希望整理程式碼,取得[外界變化]與[待改類]呈現一對一關係的理想境地。
7.Feature Envy(依戀情結)

物件技術的全部要點在於:這是一種[將資料和加諸其上的操作行為包裝在一起]的技術。有一種經典氣味是:方法對某個class的興趣高過對自己所處之 hostclass的興趣。這種孺慕之情最通常的焦點便是資料。無數次經驗裡,我們看到某個方法為了計算某值,從另一個物件那兒呼叫幾乎半打的取值方法。療法顯而易見:把這個方法移到另一個地點。你應該使用MoveMethod把它移到它該去的地方。有時候方法中只有一部分受這種依戀之苦,這時候你應該使用Extract Method把這一部分提煉到獨立方法中,再使用MoveMethod帶它去它的夢中家園。

當然,並非所有情況都這麼簡單。一個方法往往會用上數個classes特性,那麼它究竟該被置於何處呢?我們的原則是:判斷哪個class擁有最多[被此方法使用]的資料,然後就把這個方法和那些資料擺在一起。如果先以ExtractMethod將這個方法分解為整個較小方法並分別置放於不同地點,上述步驟也就比較容易完成了。

有數個複雜精巧的模式破壞了這個規則。說起這個話題,[四巨頭]的Streategy和Visitor立刻跳入我的腦海,Kent Beck的SelfDelegation也豐此列。使用這些模式是為了對抗壞味道DivergentChange。最根本的原則是:將總是一起變化的東西放在一塊兒。[資料]和[引用這些資料]的行為總是一起變化的,但也有例外。如果例外出現,我們就搬移那些行為,保持[變化只在一起發生]。Strategy和Visitor使你得以輕鬆修改方法行為,因為它們將少量需要被覆寫的行為隔離開來——當然也付出了[多一層間接性]的代價。
8.Data Clumps(資料泥團)

資料項就像小孩子:喜歡成群結隊地待在一塊兒。你常常可以在很多地方看到相同的三或四筆資料項:兩個classes內的相同欄位、許多方法簽名式中的相同引數。這些[總是綁在一起出現的資料]真應該放進屬於它們自己的物件中。首先請找出這些資料的欄位形式出現點,運用ExtractClass將它們提煉到一個獨立物件中。然後將注意力轉移到方法簽名式上頭,運用Introduce Parameter Object或Preserve WholeObject為它減肥。這麼做的直接好處是可以將很多引數列縮短,簡化方法呼叫動作。是的,不必因為DataClumps只用上新物件的一部分欄位而在意,只要你以新物件取代兩個(或更多)欄位,你就值回票價了。

一個好的評斷辦法是:刪掉眾多資料中的一筆。其它資料有沒有因而失去意義?如果它們不再有問詢,這就是個明確訊號:你應該為它們產生一個新物件。

縮短欄位個數和引數個數,當然可以支隊一些壞味道,但更重要的是:一旦擁有新物件,你就有機會讓程式散發出一種芳香。得到新物件後,你就可以著手尋找Feature Envy,這可以幫你指出[可移到新class]中的種種程式行為。不必太久,所有classes都將在它們的小小社會中充分發揮自己的生產力。
9.Primitive Obsession(基本型別偏執)

大多數程式設計環境都有兩種資料:結構型別允許你將資料組織成有意義的形式;基本型別則是構成結構型別的積木塊。結構總是會帶來一定的額外開銷。它們有點像資料庫中的表格,或是那些得不償失的東西。

物件的一個極具價值的東西早到:它們模糊了橫亙於基本資料和體積較大的classes之間的界限。你可以輕鬆編寫出一些與語言內建型別無異的小型classes。例如Java就以基本型別表示數值,而心class表示字串和日期——這兩個型別在其它許多程式設計環境中都以基本型別表現。

物件技術的新手通常在小任務上運用小物件——像是結合數值和幣別的money class、含一個起始值和一個結束值的rangeclass、電話號碼或郵政編碼等等的特殊strings。你可以運用Replace Data Value withObject將原本單獨存在的資料值替換為物件,從而走出傳統的洞窟,進入炙手可熱的物件世界。如果欲替換之資料值是typecode,而它並不影響行為,你可以運用Replace Type Code with Class將它換掉。如果你有相依於此typecode的條件式,可運用Replace Type Code with Subclass或Replace Type Code withState/Strategy加以處理。

如果你有一組應該總是被放在一起的欄位,可運用Extract Class。如果你在引數列中看到基本型資料,不妨試試Introduce ParameterObject。如果你發現自己正從array中挑選資料,可運用Replace Array with Object。
10.Switch Statements(switch驚悚現身)

物件導向程式的一個最明顯特徵就是:少用switch(或case)語句。從本質上說,switch語句的問題在於重複。你常會發現同樣的switch語句散佈於不同的地點。如果要為它新增一個新的case子句,你必須找到所有switch語句並修改它們。面向的多型概念可為此帶來優雅的解決辦法。

大多數時候,一看到switch語句你就應該考慮以多型來替換它。問題是多型該出現在哪兒?switch語句常常根據typecode進行選擇,你要的是[與該type code相關的方法或class]。所以你應該使用ExtractMethod將switch語句提煉到一個獨立方法中,再以Move Method將它搬移到需要多型性的那個class裡頭。此時你必須決定是否使用ReplaceType Code with Subclasses或Replace Type Code withState/Strategy。一旦這樣完成繼承結構之後,你就可以運用Replace Conditional with Polymorphism了。

如果你只是在單一方法中髭選擇事例,而你並不想改動它們,那麼[多型]就有點殺雞用牛刀了。這種情況下Replace Parameter withExplicit Methods是個不錯的選擇。如果你的選擇條件之一是null,可以試試Introduce Null Object。
11.Parallel Inheritance Hierarchies(平等繼承體系)

Parallel Inheritance Hierarchies其實是ShotgunSurgery的特殊情況。在這種情況下,每當你為某個class增加一個subclass,必須也為另一個class相應增加一個subclass。如果你發現某個繼承體系的class名稱字首和另一個繼承體系的class名稱字首完全相同,便是聞到了這種壞味道。

消除這種重複性的一般策略是:讓一個繼承體系的實體指涉另一個繼承體系的實體。如果再接再厲運用Move Method和MoveField,就可以將指涉端的繼承體系消弭於無形。
12.Lazy Class(冗贅類)

你所建立的每一個class,都得有人去理解它、維護它,這些工作都是要花錢的。如果一個class的所得不值其身份,它就應該消失。專案中經常會出現這樣的情況:某個class原本對得起自己的身份,但重簷使它身形縮水,不再做那麼多工作;或開發者事前規劃了某些變化,並新增一個class來就會這些變化,但變化實際上沒有發生。不論上述哪一種原因,請讓這個class莊嚴赴義吧。如果某些subclass沒有做滿足夠工作,試試CollapseHierarchy[合併繼承]。對於幾乎沒用的元件,你應該以Inline Class對付它們。
13.Speculative Generality(誇誇其談未來性)

這個令我們十分敏感的壞味道,命名者是BrianFoote。當有人說“噢,我想我們總有一天需要做這事”並因而企圖以各式各樣的掛勾和特殊情況來處理一些非必要的事情,這種壞味道就出現了。那麼做的結果往往造成系統更難理解和維護。如果所有裝置都會被用到,那就值得那麼做;如果用不到,就不值得。用不上的裝置只會擋你的路,所以,把它搬弄吧。

如果你的某個abstract class其實沒有太大作用,請運用Collapse Hierarchy。非必要之delegation可運用InlineClass除掉。如果方法的某些引數示被用上,可對它實施Rename Method讓它現實一些。

如果方法或class的惟一使用者是test cases,這就飄出了壞味道SpeculativeGenerality。如果你發現這樣的方法或class,請把它們連同其test cases都刪掉。但如果它們的用途是幫助testcases檢測正當功能,當然必須刀下留人。
14.Temporary Field(令人迷惑的暫時欄位)

有時你會看到這樣的物件:其內某個instance變數僅為某種特定情勢而設。這樣的程式碼讓人不易理解,因為你通常認為物件在所有時候都需要它的所有變數。在變數未被使用的情況下猜測當初其設定目的,會讓你發瘋。

請使用Extract Class給這個可憐的孤獨創造一個家,然後把所有和這個變數相關的程式碼都放進這個新家。也許你還可以使用Introduce NullObject在[變數不合法]的情況下建立一個Null物件,從而避免寫出[條件式程式碼]。

如果class中有一個複雜演算法,需要好幾個變數,往往就可能導致壞味道TemporaryField的出現。由於實現者不希望傳遞一長串引數,所以他把這些引數都放進欄位中。但是這些欄位只在使用該演算法時才有效,其它情況下只會讓人迷惑。這時候你可以利用ExtractClass把這些變數和其相關方法提煉到一個獨立class中。提煉後的新物件將是一個method object。
15.Message Chains(過度耦合的訊息鏈)

如果你看到使用者向一個物件索求另一個物件,然後再向後者索求另一個物件,然後再索求另一個物件……這就是MessageChain。實際程式碼中你看到的可能是一長串getThis()或一長串臨時變數。採取這種方式,意味客戶將與查詢過程中的航行結構緊密耦合。一旦物件間的關係發生任何變化,客戶端就不得不做出相應修改。

這時候你應該使用Hide Delegate。你可以在Message Chain的不同位置進行這種重構手法。理論上你可以重構MessageChain上的任何一個物件,但這麼做往往會把所有中介物件都變成Middle Man。通常更好的選擇是:先觀察MessageChain最終得到的物件是用來幹什麼的,看看能否以Extract Method把使用該物件的程式碼提煉到一個獨立方法中,再運用MoveMethod把這個方法推入Message Chain。如果這條鏈上的某個物件有多位客戶打算航行此航線的剩餘部分,就加一個方法來做這件事。
有些人把任何方法鏈都視為壞東西,我們不這樣想。呵呵,我們的總代表鎮定是出了名的,起碼在這件事情上是這樣。
16.Middle Man(中間轉手人)

物件的基本特徵之一就是封裝——對外部世界隱藏其內部細節。封裝往往伴隨delegation。比如說你問主管是否有時間參加一個會議,他就把這個訊息委託給他的記事簿,然後才能回答你。很好,你沒必要知道這位主管到底使用傳統記事簿或電子記事簿抑或祕書來記錄自己的約會。

但是人們可能過度運用delegation。你也許會看到某個class介面有一半的方法都委託給其它class,這樣就是過度運用。這裡你應該使用 RemoveMiddle Man,直接和負責物件打交道。如果這樣[不幹實事]的方法只有少數幾個,可以運用InlineMethod把它們”inlining”,放進呼叫端。如果這些Middle Man還有其它行為內銷可以運用Replace Delegation withInheritance把它變成負責物件的subclass,這樣你既可以擴充套件原物件的行為,又不必負擔那麼多的委託動作。
17.Inappropriate Intimacy(狎暱關係)

有時候你會看到兩個classes過於親密,花費太多時間去探究彼此的private成分。如果這發生在兩個[人]之間,我們不必做衛道之士;但對於classes,我們希望它們嚴守清規。

就像古代戀人一樣,過份狎暱的classes必須拆散。你可以採用Move Method和MoveField幫它們劃清界線,從而減少狎暱行徑。你也可以看看是否運用Change Bidirectional Association toUnidirectional[將雙向關聯改為單向]讓其中一個class對另一個斬斷情絲。如果兩個classes實在情投意合,可以運用ExtractClass把兩者共同點提煉到一個安全地點,讓它們坦蕩地使用這個新class。或者也可以嘗試運用Hide Delegate讓另一個class來為它們傳遞相思情。

繼承往往造成過度親密,因為subclass對superclass的瞭解總是超過superclass的主觀願望。如果你覺得該讓這個孩子獨自生活了,請運用ReplaceInheritance with Delegation讓它離開繼承體系。
18.Alternative Classes with Different Interfaces(異曲同工的類)

如果兩個方法做同一件事,卻有著不同的簽名式,請運用Rename Method根據它們的用途重新命名。但這往往不夠,請反覆運用MoveMethod將某些行為移入classes,直到兩者的協議一致為止。如果你必須重複而贅餘地移入程式碼才能完成這些,或許可運用ExtractSuperclass為自己贖點罪。
19.Incomplete Library Class(不完美的程式庫類)

複用常被視為物件的終極目的。我們認為這實在是過度估計了。但是無可否認,許多程式設計技術都建立在libraryclasses的基礎上,沒人敢說是不是我們都把排序演算法忘得一乾二淨了。

Library classes構築者沒有未卜先知的能力,我們不能因此責怪他們。畢竟我們自己也幾乎總是在系統快要構築完成的時候才能弄清楚它的設計,所以library構築者的任務真的很艱鉅。麻煩的是library的形式往往不夠好,往往不可能讓我們修改其中的classes使它完成我們希望完成的工作。這是否意味那些經過實踐檢驗的戰術如MoveMethod等等,如今都派不上用場了?

幸好我們有兩個專門就會這種情況的工具。如果你只想修改library classes內的一兩個方法,可以運用Introduce ForeignMethod;如果想要新增一大堆額外行為,就得運用Introduce Local Extension。
20.Data Class(純稚的資料類)

所謂DataClass是指:它們擁有一些欄位,以及用於訪問這些欄位的方法,除此之外一無長物。這樣的classes只是一種[不會說話的資料容器],它們幾乎一定被其它classes過份細瑣地操控著。這些classes早期可能擁有public欄位,果真如此你應該在別人注意到它們之前,立刻運用EncapsulateField將它們封裝起來。如果這些classes內含容器類的欄位,你應該檢查它們是不是得到了恰當的封裝;如果沒有,就運用EncapsulateCollection把它們封裝起來。對於那些不該被其它classes修改的欄位,請運用Remove Setting Method。

然後,找出這些[取值/設值]方法被其它classes運用的地點。嘗試以Move Method把那些呼叫行為搬移到DataClass來。如果無法搬移整個方法,就運用Extract Method產生一個可被搬移的方法。不久之後你就可以運用HideMethod把這些[取值/設值]方法隱藏起來了。

Data Class就像小孩子。作為一個起點很好,但若要讓它們像[成年]的物件那樣參與整個系統的工作,它們就必須承擔一定責任。
21.Refused Bequest(被拒絕的遺贈)

Subclasses應該繼承superclass的方法和資料。但如果它們不想或不需要繼承,又該怎麼辦呢?它們得到所有禮物,卻只從中挑選幾樣來玩!

按傳統說法,這就意味繼承體系設計錯誤。你需要為這個subclass新建一個兄弟,再運用Push Down Method和Push DownField把所有用不到的方法下推給那兄弟。這樣一來superclass就只持有所有subclasses共享的東西。常常你會聽到這樣的建議:所有superclasses都應該是抽象的。

既然使用[傳統說法]這個略帶貶義的詞,你就可以猜到,我們不建議你這麼做,起碼不建議你每次都這麼做。我們經常利用subclassing手法來複用一些行為,並發現這可以很好地應用於日常工作。這也是一種壞味道,我們不否認,但氣味通常並不強烈。所以我們說:如果RefusedBequest引起困惑和問題,請遵循傳統忠告。但不必認為你每次都得那麼做。十有八九這種壞味道很淡,不值得理睬。

如果subclass複用了superclass的行為(實現),卻又不願意支援superclass的介面,RefusedBequest的壞味道就會變得濃烈。拒絕繼承superclass的實現,這一點我們不介意;但如果拒絕繼承superclass的介面,我們不以為然。不過即使你不願意繼承介面,也不要胡亂修改繼承系,你應該運用ReplaceInheritance with Delegation來達到目的。
22.Comments(過多的註釋)

別擔心,我們並不是說你不該寫註釋。從嗅覺上說,Comments不是一種壞味道;事實上它們還是一種香味呢。我們之所以要在這裡提到Comments,因為人們常把它當作除臭劑來使用。常常會有這樣的情況:你看到一段程式碼有著長長的註釋,然後發現,這些註釋之所以存在乃是因為程式碼很糟糕。這種情況的發生次數之多,實在令人吃驚。

Comments可以帶我們找到本章先前提到的各種壞味道。找到壞味道後,我們首先應該以各種重構手法把壞味道去除。完成之後我們常常會發現:註釋已經變得多餘了,因為程式碼已經清楚說明了一切。

如果你需要註釋來解釋一塊程式碼做了什麼,試試Extract Method;如果你需要註釋說明某些系統的需求規格,試試Introduce Assertion。

如果你不知道該做什麼,這才是註釋的良好運用時機。除了用來記述將來的打算之外,註釋還可以用來標記你並無十足把握的區域。你可以在註釋裡寫下自己[為什麼做某某事]。這類資訊可以幫助將來的修改者,尤其是那些健忘的傢伙。
相關閱讀
評論(1)

相關文章