實用軟件工程課件第8章

實用軟件工程----IT企業(yè)軟件的開發(fā)與管理趙池龍zhaochilong@

第8章軟件實現(xiàn)本章導(dǎo)讀：從宏觀上講，軟件實現(xiàn)包括詳細設(shè)計、編程實現(xiàn)、單元測試和集成測試。從微觀上講，軟件實現(xiàn)是指編程和單元測試。本章只講編程實現(xiàn)方法，包括編碼風(fēng)格、界面定義、幫助信息，以及用戶指南書寫的參考指南。要求理解：編碼風(fēng)格、界面定義、幫助和提示信息要求掌握：

1）《用戶使用手冊》的編寫方法

2）《用戶安裝手冊》的編寫方法

8.1軟件實現(xiàn)方法軟件實現(xiàn)的輸入是《詳細設(shè)計說明書》，輸出是源程序、目標(biāo)程序及用戶指南。根據(jù)“五個面向理論”，編程實現(xiàn)的主要方法是“面向?qū)ο髮崿F(xiàn)”。因為現(xiàn)在流行的編程語言，基本上都是面向?qū)ο蟮恼Z言?！懊嫦?qū)ο髮崿F(xiàn)”的目標(biāo)是：按照《詳細設(shè)計說明書》的要求，從軟件公司的函數(shù)庫、類庫、構(gòu)件庫中挑選有關(guān)的零部件，遵照軟件公司的程序設(shè)計規(guī)范，用面向?qū)ο蟮恼Z言，通過穿針引線的方法，將這些零部件組裝起來，分別實現(xiàn)各模塊的功能，從而實現(xiàn)目標(biāo)系統(tǒng)的功能、性能、接口、界面等要求。軟件實現(xiàn)方法

1．新增函數(shù)的實現(xiàn)及函數(shù)庫的管理

2．新增存儲過程的實現(xiàn)及存儲過程庫的管理

3．新增類的實現(xiàn)及類庫的管理

4．新增構(gòu)件的實現(xiàn)及構(gòu)件庫的管理

5．新增中間件的實現(xiàn)及中間件的管理

6．部件組裝

7．程序設(shè)計風(fēng)格與編程規(guī)范

(1).程序設(shè)計風(fēng)格的內(nèi)容包括：規(guī)范化的程序內(nèi)部文檔、數(shù)據(jù)結(jié)構(gòu)的詳細說明、清晰的語句結(jié)構(gòu)、遵守某一編程規(guī)范。

(2).編程規(guī)范的內(nèi)容包括：命名規(guī)范、界面規(guī)范、提示及幫助信息規(guī)范、熱鍵定義等。4.2源程序設(shè)計風(fēng)格良好的程序設(shè)計風(fēng)格，能使程序員進行“無私程序設(shè)計”，避免程序員與其所產(chǎn)生的代碼之間的關(guān)系過于密切，提高程序代碼的規(guī)范化程度，使程序代碼易讀、易懂、易修改，實現(xiàn)程序員之間相互進行程序測試和維護的目的。程序設(shè)計要求：（1）依照所確定的規(guī)范進行程序設(shè)計。（2）模塊本身要高內(nèi)聚，模塊之間要低耦合。（3）每個程序模塊的行數(shù)不做規(guī)定。對于程序模塊中相對獨立性較強的程序塊，提煉成為一個函數(shù)或構(gòu)件。（4）盡量為程序塊加上明確的注釋。對于較復(fù)雜的程序或算法需要有注釋文件，并在程序中注明注釋文件名，在注釋文件中注明程序名。4.3屏幕界面設(shè)計屏幕界面上看得見的窗口、畫面、圖像、按鈕等對象，在設(shè)計與實現(xiàn)中，統(tǒng)稱為“控件”。構(gòu)件分為可視構(gòu)件和非可視構(gòu)件兩種，控件是一種可視構(gòu)件，它是構(gòu)件的一種表現(xiàn)形式?？丶挠袡C排列和組合，就構(gòu)成了用戶需求的各種屏幕界面。屏幕界面設(shè)計的內(nèi)容包括：(1)控件級設(shè)計;(2)窗口級定義;(3)系統(tǒng)級定義。屏幕界面設(shè)計遵從的原則是：界面簡潔樸素，控件擺放整齊，顏色風(fēng)格統(tǒng)一，照顧客戶習(xí)慣。4.3.1控件級定義這里講的控件，是指屏幕界面上的控件，它是屏幕窗口中的基本元素，是構(gòu)件的一種表現(xiàn)形式。控件1：按鈕（Button）屬性：Height=92，Width依具體情況而定；按鈕在窗口右下方或右方排列，當(dāng)控件中包含按鈕時，按鈕不應(yīng)和控件外的按鈕在同一方向上排列?？丶?：按鈕（Button）控件2：分組框（GroupBox）控件3：單行編輯器、下拉列表框、圖形下拉列表框、數(shù)字轉(zhuǎn)盤控件4：圖表（Graph）控件5：復(fù)選框、單選鈕控件6：圖片（Picture）控件7：標(biāo)簽（Tab）4.3.2窗口級定義窗口級定義包括：

(1)系統(tǒng)主窗口;(2)基本參數(shù)（又稱代碼或數(shù)據(jù)字典）維護窗口;(3)錄入查詢修改窗口;(4)統(tǒng)計窗口;(5)對話框窗口等等。在面向?qū)ο蟮木幊陶Z言中，窗口定義是一件較簡單的事情。(1)．系統(tǒng)主窗口定義(2)．基本參數(shù)維護窗口定義(3)．錄入/查詢/修改窗口定義錄入/查詢/修改窗口定義（1）選中記錄：移動鼠標(biāo)到該條記錄上，并單擊它。（2）瀏覽記錄：用鼠標(biāo)拖動滾動條，這樣可以看到更多的參數(shù)。（3）增加記錄：按下“插入”按鈕，在左邊的數(shù)據(jù)窗口中將會增加一條空白記錄。按下“保存”按鈕，就會將它存入數(shù)據(jù)庫中。（4）刪除記錄：選中將要刪除的記錄，按下“刪除”按鈕。按下“保存”按鈕，就會從數(shù)據(jù)庫中刪除該記錄。（5）修改記錄：選中需要修改的記錄，就可以修改。（6）放棄修改：對數(shù)據(jù)進行了改動，允許放棄改動。辦法是按下右邊的“查詢”按鈕。（7）打印記錄：按下“打印”按鈕，就得到所需的報表。

(4)．統(tǒng)計窗口定義統(tǒng)計窗口定義(5)．對話框窗口定義4.3.3系統(tǒng)級定義(1)．系統(tǒng)結(jié)構(gòu)圖定義用彩色示意圖，形象地表示該系統(tǒng)的總體結(jié)構(gòu)。(2)．起始畫面定義用于顯示系統(tǒng)的名稱和版權(quán)人等信息。(3)．登錄定義用戶錄入名稱和口令，登錄等待過程需加入動畫。(4)．菜單定義同一層菜單項之間，功能不同者用“橫線”隔開；主菜單項名稱用“兩個字符”表達；子系統(tǒng)功能相同的菜單項必須用同一名稱。(5)．快捷鍵定義4.4幫

助

信

息幫助信息與用戶指南有所不同。前者是聯(lián)機在線動態(tài)幫助，后者是脫機靜態(tài)指導(dǎo)。聯(lián)機動態(tài)幫助與程序運行之間，存在動態(tài)對應(yīng)關(guān)系。脫機靜態(tài)幫助，是一種宏觀靜態(tài)說明。幫助信息又分為：在線幫助和提示信息兩部分，此處專門介紹幫助信息的實現(xiàn)方法。4.4.1在線幫助程序代碼與在線幫助的關(guān)系采用間接調(diào)用方式處理。在幫助菜單或按鈕中，先調(diào)用幫助關(guān)鍵字，再根據(jù)關(guān)鍵字查找?guī)椭黝}。這樣可以使程序代碼開發(fā)和幫助書寫工作分離，便于開發(fā)過程中整體工作的協(xié)調(diào)安排。(1)．在線幫助的使用規(guī)定所有的業(yè)務(wù)功能（如錄入、修改、查詢、制單處理、總賬處理、明細賬處理）或者較復(fù)雜的非業(yè)務(wù)功能（如任意匯總查詢、數(shù)據(jù)通信和傳輸）中都要提供在線幫助；使用按鈕操作的窗口，在線幫助使用按鈕；使用菜單操作的窗口，在線幫助使用菜單；對于查詢功能，查詢結(jié)果形成前的響應(yīng)窗口應(yīng)提供在線幫助。

在線幫助(2)．在線幫助的處理過程在所有需要幫助的地方，調(diào)用一個自定義的公用函數(shù)，由該函數(shù)負責(zé)打開在線幫助。公用函數(shù)的格式如下：

GifHelp(String

psHelpId)

參數(shù)psHelpId

為幫助關(guān)鍵字。(3)．幫助關(guān)鍵字的構(gòu)造規(guī)范幫助關(guān)鍵字

=系統(tǒng)編號（2位）+|+對象名字(不定位)+|+語義序號(4)．在線幫助函數(shù)的調(diào)用方法及規(guī)定

psHelpId按照上述規(guī)定的規(guī)范形成。各程序員都要形成一個積累幫助的文件，文件名規(guī)定為Help+程序員名字縮寫，每調(diào)用一次，都要向該文件中加入一行信息，以登記調(diào)用情況，文件格式的規(guī)定，如表8-3所示。表8-3幫助文件的格式

子系統(tǒng)模塊幫助關(guān)鍵字在線幫助(5)．幫助關(guān)鍵字與幫助主題的對應(yīng)關(guān)系為了保證程序中所調(diào)用的幫助關(guān)鍵字能夠同幫助文件中幫助主題完全對應(yīng)，特定義一個保存這種對應(yīng)關(guān)系的文件，該文件稱為對應(yīng)關(guān)系文件，它作為一個客戶端的配置文件存在，不在數(shù)據(jù)庫中單獨列表。

配置文件名：HLPTOPIC.INI

格式：

[子系統(tǒng)代碼]

HelpId=HelpTopic，HelpFile

例如：

[ZW]

zw|w_kmzd|kmsr=幫助主題，幫助文件

zw|w_pzcl|pzsr=幫助主題，幫助文件4.4.2提示信息1．提示信息的分類可將系統(tǒng)中所有提示信息分為4類：（1）引導(dǎo)性提示信息：該類提示信息一般在需要用戶干預(yù)時出現(xiàn)，要求用戶決定下一步的操作。如在退出時提示“修改的數(shù)據(jù)尚未存盤，存盤否？”。（2）錯誤性提示信息：該類提示信息一般在軟件運行出錯時出現(xiàn)，告訴用戶軟件遇到了問題。如“系統(tǒng)運行出現(xiàn)故障，請與系統(tǒng)管理員聯(lián)系！”。（3）狀態(tài)性提示信息：該類提示信息一般在軟件處于“忙”狀態(tài)下提示，告訴用戶軟件正在進行什么操作，讓用戶耐心等待。如“正在進行數(shù)據(jù)傳輸，請稍待…”。（4）位置性提示信息：該類提示信息一般根據(jù)鼠標(biāo)的位置進行提示，告訴用戶鼠標(biāo)正指向什么功能。如“報表打印”。提示信息2．提示信息的提示方法對于所有提示信息，可使用函數(shù)gsShowMessage(psMessId，psErrMess)，其中psMessId為提示信息的ID號，psErrMess為根據(jù)系統(tǒng)獲得的錯誤信息，該參數(shù)只對錯誤性提示信息有效。（1）對于引導(dǎo)性提示信息，使用MessageBox進行提示。（2）對于錯誤性提示信息，顯示時只顯示信息表中提供的信息，提供詳細按鈕，執(zhí)行時將詳細的錯誤信息顯示出來。（3）對于狀態(tài)性提示信息，顯示一個固定窗口，同時提供一個函數(shù)gsCloseMess()，對于該類提示信息，在執(zhí)行完畢后，執(zhí)行函數(shù)將提示窗口關(guān)閉。（4）位置性提示信息顯示在狀態(tài)提示欄中。提示信息3．信息序號的編碼規(guī)則及使用時應(yīng)做的工作

(1).信息序號的規(guī)則如下：信息序號=信息類別（兩位）+信息代號（八位）(2).“信息類別”表示為以下信息中的一種：（1）.LE引導(dǎo)性信息（2）.ER錯誤性信息（3）.ST狀態(tài)性信息（4）.PO位置性信息(3).“信息級別”僅對ER有效，級別在最后統(tǒng)一編排。(4).“提問方式”僅對LE有效，表示如何提示用戶，以便于用戶回答：YesNo(是否)；YesNoCancel(是否取消)；OkCancel(確認(rèn)取消)；Ok(確認(rèn))。提示信息4．提示信息的時機及內(nèi)容編寫規(guī)定（1）引導(dǎo)性提示主要是引導(dǎo)用戶進行下一步操作，一般出現(xiàn)的機會比較多，如“修改的數(shù)據(jù)未存盤，存盤否？”。（2）錯誤性提示在測試比較好的情況下應(yīng)極少出現(xiàn)，它出現(xiàn)的原因不外乎兩種：一種為測試不夠；另一種可能為數(shù)據(jù)出現(xiàn)錯誤，如服務(wù)器運行異常等。對于這種情況一定要將錯誤原因詳盡提示出來，由程序員在新的版本中改正錯誤，或維護人員根據(jù)錯誤原因解決問題。（3）狀態(tài)性提示要明確簡單，讓用戶確實了解系統(tǒng)目前正在“忙”什么。（4）要將位置性提示準(zhǔn)確顯示在狀態(tài)提示欄中。提示信息5．熱鍵定義及使用規(guī)范對于各種對象（如菜單、按鈕等）的熱鍵，在各種對象的介紹中已經(jīng)規(guī)定，在此不再做重復(fù)規(guī)定，這里只規(guī)定整個系統(tǒng)的熱鍵，如表8-5所示。

4.4.3其他規(guī)定（1）對于數(shù)字型（除Integer型）列，從表中取出后，必需進行四舍五入處理。（2）使用通配符的地方，一律使用“？”表示。（3）在退出時，檢查數(shù)據(jù)窗口中的數(shù)據(jù)是否做過改動，如做過改動，應(yīng)提示用戶是否存盤。（4）在存盤之前，應(yīng)檢查數(shù)據(jù)窗口中各項數(shù)據(jù)的正確性，如有不符合條件的項，應(yīng)提示，改正后再行存盤，提示的內(nèi)容應(yīng)為“錯誤信息”+“改正方法”。（5）對于日期型數(shù)據(jù)的顯示及輸入格式，規(guī)定為yyyy.mm.dd，不得使用其他任何格式。（6）每行數(shù)據(jù)輸入、刪除或修改后，要能夠及時提交。（7）在輸入某一項數(shù)據(jù)時，如果該項不在可視屏內(nèi)，則應(yīng)將該項移動到可視屏內(nèi)。其他規(guī)定（8）可以在事件中調(diào)用函數(shù)，但一般不在函數(shù)中觸發(fā)事件。函數(shù)體內(nèi)的語句出錯時，要返回錯誤代碼（如1表示成功，－1表示失?。┑?。（9）規(guī)定：事件的觸發(fā)應(yīng)不超過三級，視圖的連續(xù)層數(shù)應(yīng)不超過三層。（10）在數(shù)據(jù)更新中，動態(tài)SQL語句或嵌入式SQL語句執(zhí)行后都要進行判斷，根據(jù)執(zhí)行結(jié)果來決定下一步操作。（11）在某一子系統(tǒng)的主菜單下打開一窗口時，如果該窗口是Main（主）窗口，則以O(shè)penSheet()打開。（12）規(guī)定全程變量表，是各系統(tǒng)實現(xiàn)前要做的一項重要的工作。至于各子系統(tǒng)所使用的全程變量，則要待各子系統(tǒng)設(shè)計完成后，由高級程序員根據(jù)情況定義，但通用全程變量各子系統(tǒng)都要使用。4.5軟件實現(xiàn)文檔1．實現(xiàn)文檔的組成軟件實現(xiàn)文檔由源程序清單和用戶指南組成。由于面向?qū)ο蟮恼Z言與面向過程的語言有所不同，所以完整的源程序清單有時打印不出來，往往只能打印出部分源程序清單。一般的做法是：不打印出源程序清單，只保留其電子版本。用戶指南主要包括《用戶使用手冊》和《用戶安裝手冊》。在特殊情況下，例如，數(shù)據(jù)庫服務(wù)器上的存儲管理、數(shù)據(jù)維護、數(shù)據(jù)備份、數(shù)據(jù)傳輸?shù)葐栴}較復(fù)雜時，在用戶指南中還要增加《系統(tǒng)管理員手冊》的內(nèi)容。軟件實現(xiàn)文檔2．用戶指南的編寫要求（1）統(tǒng)一采用編寫工具Word進行編寫。（2）用統(tǒng)一的風(fēng)格和確定的方法，描述產(chǎn)品提供的所有功能。描述之后的功能，應(yīng)該具有如下特點：對于每一項功能的描述應(yīng)該完整。（3）術(shù)語部分包括系統(tǒng)術(shù)語和基本概念。系統(tǒng)術(shù)語在整個系統(tǒng)的含義是統(tǒng)一的，放在前言部分描述?；靖拍钤诟饔嘘P(guān)章節(jié)進行描述。（4）語言要簡潔明快，表達準(zhǔn)確。一句話不要太長，中間可以斷句幾次。（5）指南格式應(yīng)統(tǒng)一。軟件實現(xiàn)文檔3．用戶指南的排版建議

（1）.2人以上合作編寫，一定要有一人負責(zé)統(tǒng)稿。

(2）.交稿前一定要最后一次仔細審讀。（3）.圖以章為序，如圖5.1或圖5-1（半字線連接章號和圖號）。

(4）.表以章為序，如表3.1或表3-2。（5）.命令格式。操作步驟中使用的命令按鈕、菜單命令項、標(biāo)簽項等名稱用【】界定。如：打開【開始】菜單選擇【程序】項……

（6）.例題格式。例題以章為序，并用【】界定。如【例3.5】或【例3-5】。軟件實現(xiàn)文檔4．用戶指南的編寫原則（1）列出應(yīng)編制文檔的目錄。（2）提示編制文檔應(yīng)參考的標(biāo)準(zhǔn)。（3）指定文檔管理員。（4）提供編制文檔所需要的條件，落實文檔編寫人員、主管和所需經(jīng)費以及編制工具等。（5）明確保證文檔質(zhì)量的方法，為了確保文檔內(nèi)容的正確性、合理性，應(yīng)采取一定的措施，如評審、審稿、鑒定等。（6）繪制進度表，以圖表形式列出各階段應(yīng)產(chǎn)生的文檔、編制人員、編制主管、編制日期、完成日期、評審