軟件設計中用例詳細需求描述的應用研究

肖俊飛

云南省曲靖市第一中學，云南曲靖 655000

用例詳細描述是軟件詳細設計過程中的重要環節。通過用例詳細描述完成用例詳細設計說明書。

1 用例詳細描述的用途

通過用例模型和業務對象模型，對目標系統的功能和數據有了概要的理解。這兩者將成為高層需求說明書的主要內容。更進一步，需要以用例為單位，進行細節的描述，即編制系統需求說明書。由于信息技術的發展，當今研發的信息系統，均采用聯機方式。用戶在客戶機前，采用鼠標，鍵盤或其它工具，通過圖形用戶界面（GUI）與系統進行交互，引導系統完成規定的處理，達到預定的結果。用例詳細描述就是這一交互過程的細節描述。然而，高層需求說明書只是描述系統應該做什么，至于系統內部的處理過程，即系統如何做，則有待設計和實現階段去解決。

正如事件是業務流程流轉的線索一樣，事件也是用例實現的線索。詳細描述用例的基本思路是，以圖形用戶界面為媒介，系統事件為線索，描述每個事件的發生，從而引發系統做什么的交互過程，即系統行為過程的描述。如何來描述做什么呢？我們要敘述清楚，在特定的系統狀態下，要進行什么處理，在什么情況下應創建、更新、閱讀、刪除哪些對象或其間的關聯。返回什么信息，即系統對于事件的響應，即系統行為。系統行為的本質是由業務邏輯決定的，所以相應的內容叫做業務規則。

用例模型是功能模型，記錄著本系統需要完成哪些事情，說明系統的行為特點。業務對象模型，記錄著本系統需要處理或持久保存數據，說明系統的結構特點。但在用例模型中只是從使用者角度粗略地說明要做的事情是什么，并沒有說明這件事情具體怎么做，用例詳細描述就是用來說明用例內部是如何工作的，即用例的實現，用例詳細描述相當于分析階段的動態模型。

2 用例詳細描述的要素

用例詳細描述，也叫用例規格說明，包含下列內容：

用例名稱：用例的名稱。

用例簡述：用例的作用和目標，或是簡要的過程。

事件流程：采用參與者與系統之間對話的方式，描述是什么和做什么，不描述原因和方式。如明確指明輸入商品編號和數量，不能籠統地說輸入商品信息；也不描述輸入的方式，是鍵盤錄入，還是用條碼掃描，在規格說明時不必指明。留待設計階段再補充技術細節。

基本事件流：從用例啟動開始，直至結束的骨干流程。

替換流程：基本流程中發生了替換，如果只要幾行就能描述清楚，則寫在基本流程中；如果較為復雜，則另行設置替換流程段。

前置條件：用例執行之前，系統必須處于的狀態。如按訂單收貨，訂單必須處于確認狀態。

后置條件：系統完成用例之后，可能處于的一組狀態。如按訂單收貨，可能訂單收貨全部完成，處于收貨完成狀態，也可能某些訂單行項尚末完成收貨，仍處于訂單確認狀態。

擴展點：擴展點描述使用、擴展關系的發生位置。以擴展點名指明在事件流程中的位置。

界面原型：描述圖形用戶界面的邏輯構成、圖形元素及其布置。如果一個用例涉及幾個界面，則要描述引發界面轉換的事件。說明界面流轉情景的圖稱為屏幕流轉圖，或叫連環畫，形象地說明了用例的動態過程。因為它具有直觀生動的特點，常常成為與用戶交流業務需求的重要方式。界面原型表示方式可以是草圖，也可以是快速工具開發的界面，界面原型是后期界面設計的基礎。

特殊需求：常常是非功能性需求。

3 用例詳細描述舉例

用例ID UC001

參與者：系統管理員

用例名稱：用戶管理

用例描述：系統管理員新建、修改或刪除用戶

前置條件：系統管理員進入系統

后置條件：無

基本操作流程：

1）系統要求系統管理員選擇要執行的操作（新建用戶、修改用戶或刪除用戶）；

2）一旦系統管理員選擇了要執行的操作，以下子流程中的某一個將被執行。

（1）如果選擇新建用戶，則‘新建用戶’子流程將被執行；

（2） 如果選擇修改用戶，則‘修改用戶’子流程將被執行；

（3）如果選擇刪除用戶，則‘刪除用戶’子流程將被執行。

新建用戶：

① 系統管理員輸入用戶名、登錄名、口令信息；

②系統驗證所錄入的信息（用戶名、登錄名不能為空；登錄名不能重復）；

③通過驗證，系統保存用戶信息；沒有通過驗證，系統返回相應提示信息給系統管理員，不保存用戶信息。

修改用戶：

① 系統檢索出所有用戶；

② 系統管理員選擇需要修改的用戶；

③系統管理員修改其用戶名、登錄名、口令等信息；

④ 系統驗證修改過后的用戶信息（用戶名、登錄名不能為空；登錄名不能重復）；

⑤通過驗證，系統保存用戶信息；沒有通過驗證，系統返回相應提示信息給系統管理員，不保存用戶信息。

刪除用戶：

① 系統檢索出所有用戶；

②系統管理員選擇要刪除的用戶；

③判斷用戶是否已使用；

④ 如果未使用，執行步驟e；如果已使用，不能刪除該用戶，直接結束；

⑤系統詢問系統管理員是否確認刪除所選擇的用戶；

⑥如果選擇是，系統刪除該用戶信息；選擇否，系統不刪除該用戶。

可選操作流程：

備注說明：用戶已使用：為用戶分配過角色或權限。

4 編寫用例詳細描述過程中的注意事項

1）用例詳細描述是用例實現的一種表達方式，主要對用例的內部運作過程的一種描述；

2）用例詳細描述涉及的內容較多：業務藍圖、用例清單、業務對象、界面原型、業務的系統流程等，所以需要理解上述內容后才能正確建模；

3）替換流程與基本流程之間是擴展關系；

4）除了分析用例的實現過程，還要對實現過程中的質量方面的要求加以說明。質量方面的要求是非功能需要，用例詳細需求描述是將功能與非功能相結合。

5 結論

用例詳細描述記錄著系統某個用例的行為過程。用例詳細描述是用例在特定場景下的運行情況的詳細說明。

用例的實現有多種方式：有的用活動圖、有的通過建立分析模型再用用順序圖實現等，用例詳細需求描述這種方式是我們在企業工作中積累的行之有效的方法，也符合我國軟件企業的實際情況。用用例詳細描述來實現用例，使需求獲取、需求分析、需求定義、需求管理等幾個主要的需求開發環節形成一個有機的整體，為后期工作提供更實用的幫助。但用例詳細描述在后期也會有變化的，一個不斷完善的過程。

一個項目的所有用例詳細描述匯總在一起形成用例詳細需求說明書。這是一份非常重要的文檔，對后面設計及實現具體非常重要的指導意義。

[1]陳顯剛.軟件設計.電子工業出版社.

[2]廖白楷，王如龍，洪躍山，等.醫院管理信息系統的研究與實踐[J].計算機技術與自動化，1992，11（2）：15-18.

[3]夏鋒，孫優賢.基于軟件工程的個性化網上教學系統開發研究[J].工業控制計算機，2003，16（1）：22-24.

[4]張海藩.軟件工程導論[M].北京：清華大學出版社，2003.