編寫有效用例

第1章  引言 1
1.1  用例是什么（梗概） 1
用例1   通過網(wǎng)絡(luò)購買股票   3
用例2   汽車交通事故索賠   5
用例3   對運(yùn)到的包裝箱進(jìn)行登記   6
1.2  你的用例不能作為我的用例 7
用例4   買東西（非正式版本）  10
用例5   買東西（完整正式版本）  10
◆ Steve Adolph：在新領(lǐng)域中“發(fā)掘”需求 14
1.3  需求和用例 15
圖1-1 “輪軸和輪輻”需求模型 17
用例作為項(xiàng)目連接結(jié)構(gòu) 18
1.4  用例的增值點(diǎn) 18
1.5  合理安排你的精力 19
1.6  先用使用敘述做熱身 21
1.7  練習(xí) 22
第1部分  用例體部分
第2章  用例是規(guī)范行為的契約 27
2.1  具有目標(biāo)的執(zhí)行者之間的交互 27
執(zhí)行者具有目標(biāo) 27
圖2-1  一個(gè)具有目標(biāo)的執(zhí)行者請求另一個(gè)執(zhí)行者履行職責(zé) 28
目標(biāo)可能失敗 29
交互是復(fù)雜的 30
用例聚集場景 33
圖2-2  條形褲：成功和失敗場景 33
圖2-3  在條形褲中展示子目標(biāo)的小條形褲 34
2.2  涉及利益的項(xiàng)目相關(guān)人員之間的契約 35
圖2-4  SuD為主執(zhí)行者提供服務(wù)，同時(shí)維護(hù)幕后項(xiàng)目
相關(guān)人員的利益 36
2.3  圖形模型 37
圖2-5  執(zhí)行者和項(xiàng)目相關(guān)人員 38
圖2-6  行為 38
圖2-7  用例是職責(zé)的激發(fā)者 39
圖2-8  作為組合的交互 39
第3章  范圍 41
表3-1 “內(nèi)/外”列表 41
3.1  功能范圍 42
“執(zhí)行者?目標(biāo)”列表 42
表3-2 “執(zhí)行者?目標(biāo)”列表 43
用例簡述 43
表3-3  用例簡述 44
3.2  設(shè)計(jì)范圍 44
◆ 一個(gè)簡短而真實(shí)的故事 45
圖3-1  設(shè)計(jì)范圍的大小是任意的 46
用圖標(biāo)來突出設(shè)計(jì)范圍 46
設(shè)計(jì)范圍示例 47
（1）企業(yè)系統(tǒng)范圍 47
用例6   增加新服務(wù)（企業(yè)）  48
用例7   增加新服務(wù)（Acura）  49
（2）一個(gè)應(yīng)用程序?qū)?yīng)多臺(tái)計(jì)算機(jī) 49
用例8   輸入和修改請求（聯(lián)合系統(tǒng)）  50
用例9   添加新服務(wù)（給Acura添加）  50
用例10   通知新服務(wù)請求（BSSO中）  51
用例11   更新服務(wù)請求（BSSO中）  51
用例12   通知更新后的服務(wù)請求（Acura中）  51
（3）基本用例 51
圖3-2  Acura-BSSO的用例圖 52
圖3-3  Acura-BSSO的一組用例圖 52
用例13   資源的串行存取   53
用例14   實(shí)施資源鎖轉(zhuǎn)換政策   54
用例15   實(shí)施存取兼容性政策  55
用例16   實(shí)施存取選擇政策  56
用例17   令服務(wù)客戶等待獲得資源存取權(quán)限  56
3.3  最外層用例 57
3.4  使用范圍確定的工作產(chǎn)品 59
3.5  練習(xí) 60
第4章  項(xiàng)目相關(guān)人員和執(zhí)行者 61
4.1  項(xiàng)目相關(guān)人員 61
◆ 一個(gè)簡短而真實(shí)的故事 62
4.2  主執(zhí)行者 62
主執(zhí)行者為什么有時(shí)是不重要的（而有時(shí)又是重要的） 63
在開始用例編寫時(shí) 64
在用例編寫和設(shè)計(jì)過程中 64
設(shè)計(jì)之后，準(zhǔn)備配置系統(tǒng)時(shí) 66
執(zhí)行者與角色 66
統(tǒng)一建模語言（UML）圖和執(zhí)行者/角色規(guī)格說明 67
刻畫主執(zhí)行者的特點(diǎn) 67
表4-1 “執(zhí)行者概況”表示例 68
4.3  輔助執(zhí)行者 68
4.4  被討論系統(tǒng) 68
4.5  內(nèi)部執(zhí)行者和白盒用例 69
4.6  練習(xí) 69
第5章  三個(gè)命名的目標(biāo)層次 71
圖5-1  用例層次 72
5.1  用戶目標(biāo)（藍(lán)色，海平面 ） 72
◆ 一個(gè)簡短而真實(shí)的故事 74
藍(lán)色的兩個(gè)層次 74
5.2  概要層次（白色，云朵 /風(fēng)箏 ） 75
用例18   操作保險(xiǎn)單＋   75
重溫最外層用例的內(nèi)容 76
5.3  子功能（靛青色/黑色，海平面以下 蛤 ） 77
目標(biāo)層次總結(jié) 78
5.4  利用圖標(biāo)來突出目標(biāo)層次 78
5.5  找出正確的目標(biāo)層次 79
找出用戶目標(biāo) 80
提升和降低目標(biāo)層次 80
圖5-2  通過問“為什么”的問題來轉(zhuǎn)換層次 81
5.6  一個(gè)較長的編寫實(shí)例：“處理索賠”的多層次示范 81
用例19   處理索賠（業(yè)務(wù)）  82
用例20   評估工作補(bǔ)償索賠   84
用例21   處理索賠（系統(tǒng)）+   86
用例22   損失注冊   88
用例23   查找……（問題陳述）  92
5.7  練習(xí) 93
第6章  前置條件、觸發(fā)事件和保證 95
6.1  前置條件 95
6.2  最小保證 97
6.3  成功保證 98
6.4  觸發(fā)事件 99
6.5  練習(xí) 100
第7章  場景和步驟 101
7.1  主成功場景 101
常見的環(huán)境結(jié)構(gòu) 101
場景主體 103
7.2  執(zhí)行步驟 104
準(zhǔn)則 104
準(zhǔn)則1：使用簡單的語法 104
準(zhǔn)則2：明確地寫出“誰控制球” 105
準(zhǔn)則3：從系統(tǒng)外部的角度來編寫用例 105
準(zhǔn)則4：顯示過程向前推移 106
準(zhǔn)則5：顯示執(zhí)行者的意圖，而不是動(dòng)作 107
準(zhǔn)則6：包含“合理”的活動(dòng)集 108
圖7-1  一個(gè)事務(wù)由4個(gè)部分組成 109
準(zhǔn)則7：“確認(rèn)”而不是“檢查是否” 110
準(zhǔn)則8：可選擇地提及時(shí)間限制 111
準(zhǔn)則9：習(xí)慣用語：“用戶讓系統(tǒng)A與系統(tǒng)B交互” 111
準(zhǔn)則10：習(xí)慣用語：“循環(huán)執(zhí)行步驟x到y(tǒng)，直到條件滿足” 112
編號(hào)或不編號(hào) 113
7.3  練習(xí) 114
第8章  擴(kuò)展 117
8.1  擴(kuò)展的基礎(chǔ) 117
8.2  擴(kuò)展條件 118
集中討論所有可能的失敗和可選擇的過程 120
準(zhǔn)則11：用“檢測到什么”的方式來編寫條件 121
◆ 一個(gè)真實(shí)的、令人不快的小故事 122
關(guān)于集中討論列表 123
擴(kuò)展列表的合理化 123
逐層合并失敗 124
8.3  擴(kuò)展處理 125
準(zhǔn)則12：條件處理的縮排方式 127
失敗的嵌套 128
從擴(kuò)展中創(chuàng)建新用例 129
8.4  練習(xí) 130
第9章  技術(shù)和數(shù)據(jù)的變化 131圖9-1  在UML中使用具體化方式表現(xiàn)技術(shù)變化 132
第10章  連接用例 133
10.1  子用例 133
10.2  擴(kuò)展用例 133
圖10-1  擴(kuò)展用例的UML圖 135
什么時(shí)候使用擴(kuò)展用例 136
10.3  練習(xí) 137
擴(kuò)展用例 137
第11章  用例格式 139
11.1  供選擇的格式 139
完整正式的用例格式 139
用例24   完整正式的用例模板<名字> 139
非正式用例格式 140
用例25   實(shí)際登錄（非正式版本）  140
單列表格格式 141
表11-1  用例的單列表格格式 141
雙列表格格式 142
表11-2  雙列表格 142
RUP格式 143
用例26   登記課程   144
條件語句格式 147
Occam格式 147
圖形方式 148
UML用例圖 149
11.2  影響用例書寫格式的因素 149
矛盾的因素：業(yè)務(wù)環(huán)境、社會(huì)作用、不同文化 150
理解層次 150
項(xiàng)目相關(guān)人員的要求 150
經(jīng)驗(yàn)與格式 151
覆蓋面 151
一致性 151
復(fù)雜度 152
沖突 152
完整性 152
目標(biāo)與任務(wù)——完成什么與怎樣完成 153
資源 153
其他因素 153
11.3  5種項(xiàng)目類型的標(biāo)準(zhǔn) 153
需求了解階段用例 154
用例27   需求了解用例模板——Oble a New Biscum   154
業(yè)務(wù)過程建模用例 155
用例28   業(yè)務(wù)過程用例模板——Symp a Carstromming  155
確定系統(tǒng)需求用例規(guī)模 156
用例29   確定系統(tǒng)需求用例規(guī)模模板——
Burble the Tramling   156
短期、高強(qiáng)度的項(xiàng)目用例 157
用例30   高強(qiáng)度項(xiàng)目用例模板——Kree a Ranfath   157
詳細(xì)功能需求用例 158
用例31   用例名字——Nathorize a Permion   158
11.4  總結(jié) 159
11.5  練習(xí) 159
第2部分  經(jīng)常討論的主題
第12章  什么時(shí)候才算完成 163
關(guān)于“正在完成” 164
第13章  擴(kuò)展到多個(gè)用例 165
簡單描述每個(gè)用例（低精度表示） 165
創(chuàng)建用例簇 165
第14章  CRUD和參數(shù)化用例 167
14.1  CRUD用例 167
用例32   管理報(bào)表用例  168
用例33   存儲(chǔ)報(bào)表用例   170
14.2  參數(shù)化用例 173
第15章  業(yè)務(wù)過程建模 177
15.1  建模與設(shè)計(jì) 177
從核心業(yè)務(wù) 178
圖15-1  核心業(yè)務(wù)黑盒 179
圖15-2  白盒用例中的新業(yè)務(wù)設(shè)計(jì) 179
從業(yè)務(wù)過程到技術(shù) 179
圖15-3  白盒用例中的新業(yè)務(wù)設(shè)計(jì)（又一次） 180
圖15-4  帶黑盒系統(tǒng)用例的新業(yè)務(wù)過程 180
從技術(shù)到業(yè)務(wù)過程 181
15.2  業(yè)務(wù)用例和系統(tǒng)用例 181
◆ Rusty Walters：業(yè)務(wù)建模和系統(tǒng)需求 183
第16章  遺漏的需求 185
16.1  數(shù)據(jù)需求的精度 186
16.2  從用例到其他需求的交叉鏈接 188
圖16.1  翻新圖1.1，“輪軸和輪輻”需求模型 188
第17章  用例在整個(gè)過程中的作用 191
17.1  用例在項(xiàng)目組織中的作用 191
通過用例標(biāo)題進(jìn)行組織 191
表17-1  規(guī)劃表示例 192
◆ 一個(gè)真實(shí)的小故事 192
跨版本處理用例 193
交付完整場景 194
◆ 一個(gè)短而真實(shí)的集成實(shí)例 194
17.2  從用例到任務(wù)或特征列表 194
用例34：  獲得折扣  196
表17-2 “獲得折扣”任務(wù)列表 197
17.3  從用例到設(shè)計(jì) 197
◆ 一個(gè)真實(shí)的小故事 199
面向?qū)ο螅∣O）設(shè)計(jì)者特別注意 199
17.4  用例到用戶界面（UI）設(shè)計(jì) 201
17.5  用例到測試用例 202
用例35： 訂購商品，產(chǎn)生發(fā)貨單（測試?yán)樱? 202
表17-3  主要成功場景測試（好信用） 203
表17-4  主要成功場景測試（壞信用） 203
17.6  實(shí)際用例編寫 203
分工合作過程 204
第1階段：制定粗略的系統(tǒng)功能圖 204
第2階段：制定詳細(xì)用例視圖 206
用例需要的平均時(shí)間 208
從大型團(tuán)隊(duì)中收集用例 208
◆ Andy Kraus：從龐大、不同層次的團(tuán)隊(duì)收集用例 209
第18章  用例概述和極端編程 213第19章  錯(cuò)誤改正 215
19.1  沒有系統(tǒng) 215
19.2  沒有主執(zhí)行者 216
19.3  過多的用戶接口細(xì)節(jié) 217
19.4  過低的目標(biāo)層次 218
19.5  目標(biāo)和內(nèi)容不符 220
19.6  用戶接口描述過多的改進(jìn)實(shí)例 221
用例36：  尋找一種解決方案——修改前   221
用例37：  尋找可能的解決方案——修改后   226
第3部分  對忙于編寫用例的人的提示
第20章  對每個(gè)用例的提示 233
提示1：每個(gè)用例都是一篇散文 233
提示2：使用例易于閱讀 233
提示3：僅用一種句型 234
提示4：“包含”子用例 235
提示5：誰控制著球 235
提示6：正確地得到目標(biāo)層 236
圖20-1  問“為什么”以提高層次 237
提示7：不考慮GUI 237
提示8：兩個(gè)結(jié)局 238
提示9：項(xiàng)目相關(guān)人員需要的保證 238
提示10：前置條件 240
提示11：對用例進(jìn)行通過/失敗測試 240
表20-1  對用例進(jìn)行通過/失敗測試 241
第21章  對用例集的提示 243
提示12：一個(gè)不斷展開的故事 243
提示13：業(yè)務(wù)范圍和系統(tǒng)范圍 244
提示14：核心價(jià)值和變化 244
核心價(jià)值 245
適當(dāng)?shù)母淖?nbsp;246
不合適的改變 247
提示15：用例集中的質(zhì)量問題 248
第22章  處理用例的提示 249
提示16：僅僅有3章（第4章在哪兒呢？） 249
提示17：首先向廣度上努力 249
圖22-1  工作隨著細(xì)化而增加 250
提示18：12步秘訣 251
提示19：認(rèn)識(shí)到錯(cuò)誤的開銷 252
提示20：喜歡藍(lán)色牛仔褲 252
提示21：處理失敗情況 253
提示22：前期和后期的工作標(biāo)題 254
提示23：執(zhí)行者扮演角色 255
提示24：大的圖畫惡作劇 255
圖22-2 “媽媽，我想回家?！?nbsp;256
圖22-3  橢圓圖形式的語境圖 257
表22-1  語境圖的執(zhí)行者?目標(biāo)列表 257
提示25：大型工具的爭論 257
提示26：使用標(biāo)題和簡介的項(xiàng)目計(jì)劃 259
附錄A  UML中的用例 261
A.1  橢圓和“小人”圖符 261
A.2  UML中的包含關(guān)系 262
圖A-1  包含關(guān)系的畫法 262
準(zhǔn)則13：將高層目標(biāo)畫得高一點(diǎn) 263
A.3  UML的擴(kuò)展關(guān)系 263
圖A-2  擴(kuò)展關(guān)系的畫法 264
準(zhǔn)則14：將擴(kuò)展用例畫得低一些 264
準(zhǔn)則15：用不同的箭頭形狀 264
正確地使用擴(kuò)展 265
圖A-3  擴(kuò)展一個(gè)基用例的三個(gè)中斷用例 265
擴(kuò)展點(diǎn) 266
A.4  UML的泛化關(guān)系 267
正確地使用泛化關(guān)系 267
圖A-4  泛化關(guān)系的畫法。 268
準(zhǔn)則16：將泛化目標(biāo)畫得高一點(diǎn) 268
泛化的危害 269
圖A-5  泛化的危害——終止大交易 269
圖A-6  改正后的終止大交易 270
A.5  從屬用例與子用例 270
A.6  用例圖的畫法 271
準(zhǔn)則17：語境圖中的用戶目標(biāo) 271
準(zhǔn)則18：將支持執(zhí)行者放在右邊 271
A.7  代之以編寫基于文本的用例 272
附錄 B  部分習(xí)題的答案 273
第3章 273
練習(xí)3.1 273
練習(xí)3.2 273
第4章 274
練習(xí)4.2 274
練習(xí)4.3 275
第5章 275
練習(xí)5.1 275
練習(xí)5.2 276
第6章 276
練習(xí)6.1 276
練習(xí)6.4 277
第7章 277
練習(xí)7.1 277
練習(xí)7.2 278
練習(xí)7.4 278
用例38   使用訂單處理系統(tǒng)   279
第8章 279
練習(xí)8.1 279
練習(xí)8.5 280
用例39   在網(wǎng)上買股票   280
第11章 281
練習(xí)11.1 281
用例40   執(zhí)行清潔火花塞服務(wù)   281
附錄 C  術(shù)語表 283
主要術(shù)語 283
用例類型（Use Case Type） 285
圖形 286
附錄D  參考讀物 289
本書參考了以下書籍 289
本書參考了以下文章 289
有用的在線資源 290
索引 291