目錄

第1章整潔代碼1
1.1要有代碼2
1.2糟糕的代碼2
1.3混亂的代價3
1.3.1華麗新設計4
1.3.2態度4
1.3.3迷題5
1.3.4整潔代碼的藝術5
1.3.5什麼是整潔代碼6
1.4思想流派10
1.5我們是作者11
1.6童子軍軍規12
1.7前傳與原則12
1.8小結12
1.9文獻13

第2章有意義的命名15
2.1介紹15
2.2名副其實16
2.3避免誤導17
2.4做有意義的區分18
2.5使用讀得出來的名稱19
2.6使用可搜索的名稱20
2.7避免使用編碼21
2.7.1匈牙利語標記法21
2.7.2成員前綴21
2.7.3接口和實現22
2.8避免思維映射22
2.9 類名23
2.10方法名23
2.11別扮可愛23
2.12每個概念對應一個詞24
2.13別用雙關語24
2.14使用解決方案領域名稱25
2.15使用源自所涉問題領域的名稱25
2.16添加有意義的語境25
2.17不要添加沒用的語境27
2.18後的話27

第3章函數29
3.1短小32
3.2隻做一件事33
3.3每個函數一個抽像層級34
3.4switch語句35
3.5使用描述性的名稱36
3.6函數參數37
3.6.函數的普遍形式38
3.6.2標識參數38
3.6.函數38
3.6.函數39
3.6.5參數對像39
3.6.6參數列表40
3.6.7動詞與關鍵字40
3.7無副作用40
3.8分隔指令與詢問42
3.9使用異常替代返回錯誤碼42
3.9.1抽離Try/Catch代碼塊43
3.9.2錯誤處理就是一件事44
3.9.3Error.java依賴磁鐵44
3.10別重復自己44
3.11結構化編程45
3.12如何寫出這樣的函數45
3.13小結45
3.14SetupTeardownIncluder程序46
3.15文獻48

第4章注釋49
4.1注釋不能美化糟糕的代碼50
4.2用代碼來闡述51
4.3好注釋51
4.3.1法律信息51
4.3.2提供信息的注釋51
4.3.3對意圖的解釋52
4.3.4闡釋53
4.3.5警示53
4.3.6TODO注釋54
4.3.7放大54
4.3.8公共API中的Javadoc55
4.4壞注釋55
4.4.1喃喃自語55
4.4.2多餘的注釋56
4.4.3誤導性注釋58
4.4.4循規式注釋58
4.4.5日志式注釋59
4.4.6廢話注釋59
4.4.7可怕的廢話61
4.4.8能用函數或變量時就別用注釋62
4.4.9位置標記62
4.4.10括號後面的注釋62
4.4.11歸屬與署名63
4.4.12注釋掉的代碼63
4.4.13HTML注釋64
4.4.14非本地信息64
4.4.15信息過多65
4.4.16不明顯的聯繫65
4.4.17函數頭66
4.4.18非公共代碼中的Javadoc66
4.4.19範例66
4.5文獻69

第5章格式71
5.1格式的目的72
5.2垂直格式72
5.2.1向報紙學習73
5.2.2概念間垂直方向上的區隔73
5.2.3垂直方向上的靠近74
5.2.4垂直距離75
5.2.5垂直順序79
5.3橫向格式79
5.3.1水平方向上的區隔與靠近80
5.3.2水平對齊81
5.3.3縮進82
5.3.4空範圍84
5.4團隊規則84
5.5鮑勃大叔的格式規則85

第6章對像和數據結構87
6.1數據抽像87
6.2數據、對像的反對稱性89
6.3得墨忒耳律91
6.3.1火車失事91
6.3.2混雜92
6.3.3隱藏結構92
6.4數據傳送對像93
6.5小結94
6.6文獻94

第7章錯誤處理95
7.1使用異常而非返回碼96
7.2先寫Try-Catch-Finally語句97
7.3使用不可控異常98
7.4給出異常發生的環境說明99
7.5依調用者需要定義異常類99
7.6定義常規流程100
7.7別返回null值101
7.8別傳遞null值102
7.9小結103
7.10 文獻104

第8章邊界105
8.1使用第三方代碼106
8.2瀏覽和學習邊界107
8.3學習log4j108
8.4學習性測試的好處不隻是免費110
8.5使用尚不存在的代碼110
8.6整潔的邊界111
8.7文獻112

第9測試113
9.1TDD三定律114
9.2保持測試整潔115
9.3整潔的測試116
9.3.1面向特定領域的測試語言118
9.3.2雙重標準119
9.4每個測試一個斷言121
9.5F.I.R.S.T.122
9.6小結123
9.7文獻124

第10章類125
10.1類的組織126
10.2類應該短小126
10.2.1單一權責原則128
10.2.2內聚129
10.2.3保持內聚性就會得到許多短小的類130
10.3為了修改而組織136
10.4文獻139

第11章繫統141
11.1如何建造一個城市142
11.2將繫統的構造與使用分開142
11.2.1分解main143
11.2.2工廠143
11.2.3依賴注入144
11.3擴容145
11.4Java代理148
11.5純Java AOP框架150
11.6AspectJ的方面152
11.7測試驅動繫統架構153
11.8優化決策154
11.9明智使用添加了可論證價值的標準154
11.10 繫統需要領域特定語言154
11.11 小結155
11.12 文獻155

第12章迭進157
12.1通過迭進設計達到整潔目的157
12.2簡單設計規則1：運行所有測試158
12.3簡單設計規則2～4：重構158
12.4不可重復159
12.5表達力161
12.6盡可能少的類和方法162
12.7小結162
12.8文獻162

第13章並發編程163
13.1為什麼要並發164
13.2挑戰165
13.3並發防御原則166
13.3.1單一權責原則166
13.3.2推論：限制數據作用域166
13.3.3推論：使用數據復本167
13.3.4推論：線程應盡可能地獨立167
13.4了解Java庫167
13.5了解執行模型168
13.5.1生產者-消費者模型169
13.5.2讀者-作者模型169
13.5.3宴席哲學家169
13.6警惕同步方法之間的依賴169
13.7保持同步區域微小170
13.8很難編寫正確的關閉代碼170
13.9測試線程代碼171
13.9.1將偽失敗看作可能的線程問題171
13.9.2先使非線程代碼可工作171
13.9.3編寫可插撥的線程代碼172
13.9.4編寫可調整的線程代碼172
13.9.5運行多於處理器數量的線程172
13.9.6在不同平臺上運行172
13.9.7裝置試錯代碼173
13.9.8硬編碼173
13.9.9自動化174
13.10小結175
13.11文獻175

第14章逐步改進176
14.1Args的實現177
14.2Args：草稿183
14.2.1所以我暫停了195
14.2.2漸進195
14.3字符串參數197
14.4小結234

第15章JUnit內幕235
15.1JUnit框架236
15.2小結249

第16章重構SerialDate251
16.1首先，讓它能工作252
16.2讓它做對254
16.3小結266
16.4文獻267

第17章味道與啟發269
17.1注釋270
17.2環境271
17.3函數271
17.4一般性問題272
17.5Java288
17.6名稱291
17.7測試294
17.8小結295
17.9文獻296

附錄A並發編程II297
A.1客戶端/服務器的例子297
A.1.1服務器297
A.1.2添加線程代碼298
A.1.3觀察服務器端299
A.1.4小結301
A.2執行的可能路徑301
A.2.1路徑數量302
A.2.2深入挖掘303
A.2.3小結305
A.3了解類庫305
A.3.1Executor框架305
A.3.2非鎖定的解決方案306
A.3.3非線程安全類307
A.4方法之間的依賴可能破壞並發代碼308
A.4.1容忍錯誤309
A.4.2基於客戶代碼的鎖定309
A.4.3基於服務端的鎖定311
A.5提升吞吐量312
A.5.1單線程條件下的吞吐量313
A.5.2多線程條件下的吞吐量313
A.6死鎖314
A.6.1互斥315
A.6.2上鎖及等待315
A.6.3無搶先機制315
A.6.4循環等待315
A.6.5不互斥316
A.6.6不上鎖及等待316
A.6.7滿足搶先機制317
A.6.8不做循環等待317
A.7測試多線程代碼317
A.8測試線程代碼的工具支持320
A.9小結320
A.10 教程：完整代碼範例321
A.10.1客戶端/服務器非線程代碼321
A.10.2使用線程的客戶端/服務器代碼324

附錄Borg.jfree.date.SerialDate327

結束語389