編寫有效用例

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