C#代碼整潔之道：代碼重構與性能提升

第1章　C#的編碼標準和原則  1
1.1　技術要求  2
1.2　良好的代碼與劣質的代碼  2
1.2.1　劣質的代碼  3
1.2.2　良好的代碼  14
1.3　編碼標準、原則和方法的必要性  18
1.3.1　編碼標準  19
1.3.2　編碼原則  19
1.3.3　編碼方法  19
1.3.4　編碼規(guī)則  20
1.3.5　模塊化  20
1.3.6　KISS原則  20
1.3.7　YAGNI原則  21
1.3.8　DRY原則  21
1.3.9　SOLID原則  21
1.3.10　奧卡姆剃刀法則  22
1.4　總結  22
1.5　習題  22
1.6　參考資料  23
第2章　代碼評審—過程及其重要性  24
2.1　代碼評審流程  25
2.2　準備代碼評審  25
2.3　引導代碼評審  26
2.3.1　創(chuàng)建pull request  27
2.3.2　響應pull request  28
2.3.3　反饋對被評審人的影響  30
2.4　確定評審內(nèi)容  33
2.4.1　公司編碼規(guī)范與業(yè)務需求  34
2.4.2　命名規(guī)則  34
2.4.3　代碼格式  34
2.4.4　測試  35
2.4.5　架構規(guī)范和設計模式  35
2.4.6　性能和安全性  36
2.5　何時發(fā)起代碼評審  36
2.6　提供并回應評審反饋  37
2.6.1　評審人提供反饋意見  38
2.6.2　被評審人回應反饋  38
2.7　總結  39
2.8　習題  39
2.9　參考資料  40
第3章　類、對象和數(shù)據(jù)結構  41
3.1　技術要求  41
3.2　組織類  42
3.3　一個類應當只具備一種職責  43
3.4　從注釋生成文檔  45
3.5　內(nèi)聚和耦合  48
3.5.1　緊耦合范例  48
3.5.2　低耦合范例  49
3.5.3　低內(nèi)聚范例  50
3.5.4　高內(nèi)聚范例  51
3.6　為變化而設計  52
3.6.1　面向接口編程  52
3.6.2　依賴注入和控制反轉  54
3.6.3　DI范例  54
3.6.4　IoC范例  56
3.7　迪米特法則  57
3.8　不可變對象與數(shù)據(jù)結構  59
3.9　對象應當隱藏數(shù)據(jù)并暴露方法  60
3.10　數(shù)據(jù)結構體應當暴露數(shù)據(jù)而無須包含方法  61
3.11　總結  62
3.12　習題  62
3.13　參考資料  63
第4章　編寫整潔的函數(shù)  64
4.1　理解函數(shù)式編程  65
4.2　保持方法短小  67
4.3　代碼縮進  69
4.4　避免重復代碼  70
4.5　避免多個參數(shù)  71
4.6　實現(xiàn)單一職責原則  72
4.7　總結  76
4.8　習題  76
4.9　參考資料  77
第5章　異常處理  78
5.1　檢查型異常和非檢查型異常  79
5.2　避免NullReferenceException  82
5.3　業(yè)務規(guī)則異常  84
5.3.1　范例1—使用業(yè)務規(guī)則異常進行條件處理  86
5.3.2　范例2—使用正常程序流程進行條件處理  87
5.4　異常應當提供有意義的信息  89
5.5　創(chuàng)建自定義異常  90
5.6　總結  92
5.7　習題  93
5.8　參考資料  93
第6章　單元測試  94
6.1　技術要求  95
6.2　為何要進行良好的測試  95
6.3　了解測試工具  98
6.3.1　MSTest  99
6.3.2　NUnit  105
6.3.3　Moq  110
6.3.4　SpecFlow  114
6.4　TDD方法實踐—失敗、通過與重構  117
6.5　刪除冗余的測試、注釋以及無用代碼  122
6.6　總結  123
6.7　習題  123
6.8　參考資料  124
第7章　端到端系統(tǒng)測試  125
7.1　端到端測試  125
7.1.1　登錄模塊（子系統(tǒng)）  127
7.1.2　管理員模塊（子系統(tǒng)）  129
7.1.3　測驗模塊（子系統(tǒng)）  131
7.1.4　對三模塊系統(tǒng)執(zhí)行E2E測試  132
7.2　工廠  134
7.3　依賴注入  140
7.4　模塊化  145
7.5　總結  147
7.6　習題  147
7.7　參考資料  147
第8章　線程與并發(fā)  148
8.1　理解線程的生命周期  149
8.2　添加線程參數(shù)  150
8.3　使用線程池  151
8.3.1　任務并行庫  152
8.3.2　ThreadPool.QueueUserWorkItem()方法  153
8.4　使用互斥量同步線程  154
8.5　使用信號量處理并行線程  156
8.6　限制線程池使用的處理器數(shù)目及線程數(shù)目  158
8.7　避免死鎖  159
8.8　避免競態(tài)條件  164
8.9　理解靜態(tài)構造器和靜態(tài)方法  166
8.9.1　添加靜態(tài)構造器  167
8.9.2　在代碼中添加靜態(tài)方法  168
8.10　可變性、不可變性與線程安全  170
8.10.1　編寫可變且線程不安全的代碼  171
8.10.2　編寫不可變且線程安全的代碼  172
8.11　理解線程安全  173
8.12　同步方法依賴  177
8.13　使用Interlocked類  177
8.14　通用建議  180
8.15　總結  181
8.16　習題  181
8.17　參考資料  182
第9章　API的設計與開發(fā)  183
9.1　技術要求  184
9.2　什么是API  184
9.3　API代理  185
9.4　API設計準則  186
9.4.1　明確定義軟件邊界  189
9.4.2　理解高質量API文檔的重要性  190
9.4.3　傳遞不可變結構體而非可變對象  192
9.4.4　測試第三方API  195
9.4.5　測試自己的API  196
9.5　使用RAML設計API  197
9.5.1　安裝Atom和MuleSoft的Workbench插件  198
9.5.2　創(chuàng)建項目  198
9.5.3　從RAML語言無關設計規(guī)范生成C# API代碼  200
9.6　總結  203
9.7　習題  204
9.8　參考資料  204
第10章　使用API密鑰和Azure Key Vault保護API  206
10.1　技術要求  207
10.2　范例API項目—股息日歷  207
10.3　訪問Morningstar API  208
10.4　在Azure中創(chuàng)建股息日歷ASP.NET Core Web應用程序  210
10.5　使用API密鑰保護股息日歷API  215
10.5.1　創(chuàng)建repository  216
10.5.2　設置認證和鑒權功能  218
10.6　測試API密鑰安全功能  223
10.7　添加股息日歷代碼  226
10.8　限制API調(diào)用  232
10.9　總結  235
10.10　習題  236
10.11　參考資料  236
第11章　處理切面關注點  237
11.1　技術要求  238
11.2　裝飾器模式  238
11.3　代理模式  240
11.4　使用PostSharp實現(xiàn)AOP  242
11.4.1　擴展“方面”框架  242
11.4.2　擴展架構框架  244
11.5　創(chuàng)建可重用的解決切面關注點問題的類庫  245
11.5.1　添加緩存關注點  245
11.5.2　添加文件日志功能  246
11.5.3　添加日志關注點  247
11.5.4　添加異常處理關注點  249
11.5.5　添加安全關注點  249
11.5.6　添加驗證關注點  252
11.5.7　添加事務關注點  256
11.5.8　添加資源池關注點  257
11.5.9　添加配置關注點  257
11.5.10　添加檢測關注點  258
11.6　總結  259
11.7　習題  259
11.8　參考資料  259
第12章　使用工具改善代碼質量  260
12.1　技術要求  261
12.2　什么是高質量代碼  261
12.3　清理代碼并進行代碼度量  262
12.4　執(zhí)行代碼分析  264
12.5　使用快速操作  267
12.6　使用JetBrains dotTrace探查工具  267
12.7　使用JetBrains ReSharper  271
12.8　使用Telerik JustDecompile工具  279
12.9　總結  280
12.10　習題  280
12.11　參考資料  281
第13章　重構C#代碼—識別代碼壞味道  282
13.1　技術要求  282
13.2　應用程序級別代碼壞味道  283
13.2.1　布爾盲點  283
13.2.2　組合爆炸  284
13.2.3　人為復雜性  285
13.2.4　數(shù)據(jù)泥團  286
13.2.5　粉飾注釋  286
13.2.6　重復代碼  286
13.2.7　意圖不明  287
13.2.8　可變的變量  287
13.2.9　怪異的解決方案  288
13.2.10　霰彈式修改  290
13.2.11　解決方案蔓延  291
13.2.12　不可控的副作用  292
13.3　類級別代碼壞味道  292
13.3.1　過高的圈復雜度  292
13.3.2　發(fā)散式變化  295
13.3.3　向下類型轉換  296
13.3.4　過度的字面量使用  296
13.3.5　依戀情結  296
13.3.6　狎昵關系  298
13.3.7　不恰當?shù)谋┞?nbsp; 298
13.3.8　巨大的類  298
13.3.9　冗贅類  298
13.3.10　中間人類  299
13.3.11　孤立的變量和常量類  299
13.3.12　基本類型偏執(zhí)  299
13.3.13　被拒絕的遺贈  299
13.3.14　夸夸其談未來性  299
13.3.15　命令，而非詢問  300
13.3.16　臨時字段  300
13.4　方法級別的代碼壞味道  300
13.4.1　不合群的方法  300
13.4.2　過高的圈復雜度  300
13.4.3　人為復雜性  300
13.4.4　無用的代碼  301
13.4.5　過多的返回數(shù)據(jù)  301
13.4.6　依戀情結  301
13.4.7　過長或過短的標識符  301
13.4.8　狎昵關系  301
13.4.9　過長的代碼行  301
13.4.10　冗贅方法  301
13.4.11　過長的方法  302
13.4.12　參數(shù)過多  302
13.4.13　過度耦合的消息鏈  302
13.4.14　中間人方法  302
13.4.15　怪異的解決方案  302
13.4.16　夸夸其談未來性  302
13.5　總結  302
13.6　習題  303
13.7　參考資料  304
第14章　重構C#代碼—實現(xiàn)設計模式  305
14.1　技術要求  306
14.2　實現(xiàn)創(chuàng)建型設計模式  306
14.2.1　實現(xiàn)單例設計模式  306
14.2.2　實現(xiàn)工廠方法設計模式  307
14.2.3　實現(xiàn)抽象工廠設計模式  308
14.2.4　實現(xiàn)原型設計模式  311
14.2.5　實現(xiàn)建造者設計模式  313
14.3　實現(xiàn)結構型設計模式  317
14.3.1　實現(xiàn)橋接設計模式  317
14.3.2　實現(xiàn)組合設計模式  319
14.3.3　實現(xiàn)外觀設計模式  321
14.3.4　實現(xiàn)享元設計模式  323
14.4　行為型設計模式概述  325
14.5　關于整潔代碼和重構的思考  326
14.6　總結  328
14.7　習題  328
14.8　參考資料  329
參考答案  330