程序維護(hù)手冊范例解析

1、維護(hù)手冊1. 引言? 編寫目的軟件維護(hù)是軟件生命周期的最后一個階段 ,它處于系統(tǒng)投入生產(chǎn)性運行以后的 時期中 , 因此不屬于系統(tǒng)開發(fā)過程。軟件維護(hù)需要的工作量非常大 , 雖然在不同應(yīng)用領(lǐng)域維護(hù)成本差別很大 , 但是, 平均說 來,大型軟件的維護(hù)成本高達(dá)開發(fā)成本的四倍左右。目前國外許多軟件開發(fā) 組織把 60%以 上的人力用于維護(hù)已有的軟件 , 而且隨著軟件數(shù)量增多和使用壽命延 長, 這個百分比還在持 續(xù)上升。軟件維護(hù)就是在軟件已經(jīng)交付使用之后 ,為了改正錯誤或者滿足新的需要而修 改軟件 的過程。它有如下幾種性質(zhì)的維護(hù) :改正性維護(hù)因為軟件測試不可能暴露出一個大型軟件系統(tǒng)中所有潛藏的錯誤 , 所以

2、在使用 期間, 用 戶必然會發(fā)現(xiàn)程序錯誤 , 并且把他們遇到的問題報告給維護(hù)人員。 我們把 診斷和改正錯誤的 過程稱為改正性維護(hù)。適應(yīng)性維護(hù)計算機(jī)科學(xué)技術(shù)領(lǐng)域的各方面都在迅速進(jìn)步 , 需要經(jīng)常地修改版本。 為了和變 化了的環(huán) 境適當(dāng)?shù)嘏浜隙M(jìn)行的修改軟件的活動稱為適應(yīng)性維護(hù)。完善性維護(hù)在軟件編寫完成之后 , 投入實踐 , 在使用軟件的過程中 , 用戶往往提出增加新功 能或修 改已有的功能的建議 ,這就需要進(jìn)行完善性維護(hù)。預(yù)防性維護(hù)為了改進(jìn)未來的可維護(hù)性或可靠性 ,或為了給未來的改進(jìn)奠定更好的基礎(chǔ)而修 改軟件 時,就需要進(jìn)行預(yù)防性維護(hù)。維護(hù)的過程本質(zhì)上是修改和壓縮了的軟件定義和開發(fā)過程 , 而且

3、事實上遠(yuǎn)在提 出一項維 護(hù)要求之前 ,與軟件維護(hù)有關(guān)的工作已經(jīng)開始了。鑒于以上各點 , 編寫維護(hù)軟件的文檔十分重要。 它給軟件維護(hù)人員提供了一份 完整, 清晰的說明文檔 ,便于其快速有效地進(jìn)行維護(hù)工作。? 開發(fā)單位項目的提出者 :開發(fā)者:用戶:使用場所:? 定義和縮寫a. 數(shù)據(jù)流圖 描繪系統(tǒng)的邏輯模型 ,圖中沒有任何具體的物理元素 ,只是描繪信息 在系 統(tǒng)中流動和處理的情況 ,它表示了數(shù)據(jù)和處理過程的關(guān)系。數(shù)據(jù)流圖有四種基 本符號: 正 方形（或立方體表示數(shù)據(jù)的源點或終點。圓 角矩形（或圓形代表變換數(shù)據(jù)的處理。處理不一定是一個程序。一個處理框可以代表一系列程序 ,單個程序或者程序 的 一個模塊

4、 ; 它甚至可以代表一種人工處理過程。開 口矩形（或兩條平行橫線代表數(shù)據(jù)存儲。數(shù)據(jù)存儲可以表示一個文件 ,文件的一部分 ,數(shù)據(jù)庫的元素或紀(jì)錄的一部分等等。 數(shù)據(jù)存儲是處于靜止?fàn)顟B(tài)的數(shù)據(jù)。箭 頭代表數(shù)據(jù)流 ,即特定數(shù)據(jù)的流動方向。數(shù)據(jù)流是處于運動中的數(shù)據(jù)。還有幾種附加符號 :星 號表示數(shù)據(jù)流之間是 “與”關(guān)系加 號表示“或”關(guān)系異 或符號表示只能從中選一個b. 數(shù)據(jù)字典 (Data Dictionary, 簡稱 DD 是對系統(tǒng)中各類數(shù)據(jù)描述的集合 , 是各類 數(shù)據(jù)屬 性清單, 是進(jìn)行詳細(xì)的數(shù)據(jù)收集和數(shù)據(jù)分析所獲得的主要結(jié)果。 它通常包括 以下五個部 分:數(shù) 據(jù)項,是數(shù)據(jù)的最小的單位。數(shù) 據(jù)結(jié)構(gòu)

5、,是若 干數(shù)據(jù)項有意義的集合。數(shù)據(jù)流,可以是數(shù)據(jù)項 ,也可以是數(shù)據(jù)結(jié)構(gòu) ,表示某一處理過程的輸入或輸出。 數(shù) 據(jù)存儲,處理過程中存取的數(shù)據(jù)。常常是手工憑證 ,手工文檔 ,計算機(jī)文件。 處 理過程。它們的描述內(nèi)容如下 :1. 數(shù)據(jù)項描述 =數(shù)據(jù)項名 ,數(shù)據(jù)項含義說明 ,別名,類型,長度,取值范圍 ,與其他 數(shù) 據(jù)項的邏輯關(guān)系 取值范圍 ,與其他數(shù)據(jù)項的邏輯關(guān)系定義了數(shù)據(jù)的完整性約束條件 ,是設(shè)計數(shù)據(jù) 檢 驗功能的依據(jù)。2. 數(shù)據(jù)結(jié)構(gòu)描述 =數(shù)據(jù)結(jié)構(gòu)名 ,含義說明 ,組成: 數(shù)據(jù)結(jié)構(gòu)或數(shù)據(jù)項 3. 數(shù)據(jù)流 =數(shù)據(jù)流名 ,說明,流出過程,流入過程 ,組成:數(shù)據(jù)結(jié)構(gòu)或數(shù)據(jù)項 流 出過程 ,說明該數(shù)據(jù)流

6、由什么過程來。流入過程 ,說明該數(shù)據(jù)流到什么過程去。4. 數(shù)據(jù)存儲 =數(shù)據(jù)存儲名 ,說明,輸入數(shù)據(jù)流 ,輸出數(shù)據(jù)流 ,組成:數(shù)據(jù)結(jié)構(gòu)或數(shù) 據(jù)項 ,數(shù)據(jù)量 ,存取方式 數(shù)據(jù)量,說明每次存取多少數(shù)據(jù) ,每天（或每小時 ,或每周存取幾次的信息。 存 取方法,指的是批處理 ,還是聯(lián)機(jī)處理 ;是檢索還是更新 ;是順序檢索還是 隨機(jī)檢索;盡 可能詳細(xì)收集并加以說明。5. 處理過程 =處理過程名,說明,輸入:數(shù)據(jù)流 ,輸出:數(shù)據(jù)流 ,處理:簡要說 明 簡要說明中主要說明該處理過程的功能 ,即“做什么 ” 不（ 是怎么做 ;處理頻度要 求 ,如每小時 （或每分鐘處理多少事務(wù) ,多少數(shù)據(jù)量 ;響應(yīng)時間要求等。這

7、些處理要 求 是后面物理設(shè)計的輸入及性能評價的標(biāo)準(zhǔn)。d. 主鍵 :數(shù)據(jù)庫表中的關(guān)鍵域。值互不相同。e. 外部主鍵 :數(shù)據(jù)庫表中與其他表主鍵關(guān)聯(lián)的域。f. 系統(tǒng) :若未特別指出 , 統(tǒng)指本機(jī)票預(yù)定系統(tǒng)。g. SQL : Structured Query Language結(jié)（ 構(gòu)化查詢語言 , 一種用于訪問查詢數(shù)據(jù)庫 的語言h. SQL SERVER: 系統(tǒng)服務(wù)器所使用的數(shù)據(jù)庫管理系統(tǒng) （DBMS 。i. ATM : Asynchronous Transfer Mode （異步傳輸模式 。j. ROLLBACK : 數(shù)據(jù)庫的錯誤恢復(fù)機(jī)制。? 參考資料書籍:軟件工程導(dǎo)論第三版 張海藩 清華大學(xué)出版社

8、 實用軟件工程第二版 鄭 人杰 殷人昆 陶永雷 清華大學(xué)出版社 文檔 :需求規(guī)格說明書 ,概要設(shè)計說明書 ,詳細(xì)設(shè)計說明書 ,用戶操作手冊。2. 系統(tǒng)說明? 系統(tǒng)用途輸入:輸出:功能:? 安全保密系統(tǒng)提供一定的方式讓用戶表示自己的身份 ,系統(tǒng)進(jìn)行核實 ,通過鑒定后才提供 機(jī)器使用權(quán)。常用的方法有 :1. 用一個用戶名或用戶標(biāo)識號來標(biāo)識用戶身份。2. 口令。3. 系統(tǒng)提供一個隨機(jī)數(shù) ,用戶根據(jù)預(yù)先約定好的某一過程或者函數(shù)進(jìn)行計算 ,系 統(tǒng)根據(jù)用戶計算結(jié)果是否正確進(jìn)一步鑒定用戶身份。系統(tǒng)管理員還可對獲得上機(jī)權(quán)的用戶進(jìn)行權(quán)限控制 , 是不同的用戶對于不同的 數(shù)據(jù)對象 有不同的操作權(quán)限。? 總體說明系

9、統(tǒng)的總體功能 :系統(tǒng)接收輸入的預(yù)定機(jī)票的旅客信息 , 為旅客安排航班 , 印出 取票通 知和帳單 , 旅客在飛機(jī)起飛的前一天憑取票通知和帳單交款取票 , 系統(tǒng)校對 無誤即印出機(jī)票 給旅客。系統(tǒng)的具體功能 :1. 接 受:旅客信息及取票通知和帳單 ;2. 打 印:取票通知和帳單及機(jī)票 ;3. 網(wǎng) 絡(luò)輸出和加密 ,輸入和解密 ;4. 分 辨信息的種類并采取相應(yīng)的處理步驟 ;5. 判 斷信息的正誤并采取相應(yīng)的處理步驟 ;6. 進(jìn) 行數(shù)據(jù)庫的查詢、修改工作 ;7. 接 受并判斷錯誤 ,輸出相應(yīng)的出錯消息 ;? 程序說明1. PersInfoExam 過程 :對在旅客信息界面中輸入的各項信息進(jìn)行初步檢驗

10、。若發(fā)現(xiàn)錯 誤 , 令 ErrorAppear=T,判斷錯誤類型 ,并將相應(yīng)的 錯誤類型 ErrorType 或 ErrorRank 作為參數(shù) ,轉(zhuǎn) 入 ErrorHandle 過程。若未發(fā)現(xiàn)錯誤 ,轉(zhuǎn)入 PersInfoInput 過程。其中的 錯誤種類有 :1. 數(shù)據(jù)類型不匹配 ,ErrorType =T;姓名 string 旅行目的地 string性別 string 旅行時間 date工作單位 string (年 /月 /日 yy/mm/dd身份證號碼 long int2、數(shù)據(jù)超出規(guī)定范圍 ErrorRank =T;等等性別只能是 ,男?或,女? ;身份證號碼按規(guī)定必須是 13位;旅行時

11、間必須在 定票的 當(dāng)天過一天以后等等2、PersInfoInput 過程:經(jīng)檢驗無誤后 ,將輸入界面表單中的數(shù)據(jù)輸入到 Class PersInfoClass PersInfo /* 偽碼 */String name=姓名 ;String sex= 性別 ;String company= 工作單位 ;Long int idcode= 身份證號碼 ;Date stime= 旅行時間 ;(syear/smonth/stime=年 /月 /日String denist= 目的地2. 操作環(huán)境? 設(shè)備共享一個數(shù)據(jù)庫的若干臺電腦 ,臺式打印機(jī)若干? 支持軟件支持常用的數(shù)據(jù)庫應(yīng)用軟件 :VISUAL FO

12、XPRO 5.0 , DELPHI 4.0, POWER BUILDER 6.0? 數(shù)據(jù)庫標(biāo)識符:姓名,性別,工作單位 ,身份證號碼 ,旅行時間 ,旅行目的地。靜態(tài)數(shù)據(jù) :存儲在硬盤上的數(shù)據(jù)。動態(tài)數(shù)據(jù) :正處于處理過程中的數(shù)據(jù)。數(shù)據(jù)庫的存儲媒體 :硬盤。3. 維護(hù)過程? 規(guī)則1. 設(shè)計原則1. 密切結(jié)合結(jié)構(gòu) （數(shù)據(jù)設(shè)計和行為 （處理設(shè)計。2. 有機(jī)結(jié)合硬件 ,軟件 ,技術(shù)和管理的界面。3. 具體程序?qū)崿F(xiàn)過程中 ,對記錄 ,字段的引用參照 PersInfo 類。4. 存儲區(qū)的標(biāo)識符也參照 PersInfo 類。2.設(shè)計5. 在設(shè)計過程中參照瀑布模型 , ER 模型,層次圖, Jackson 程序

13、設(shè)計方法。 程序變更的準(zhǔn)則1. 檢 查可供選擇的設(shè)計方案 ,尋找一種與程序的原始設(shè)計原理相容的變更設(shè)計。2. 努 力使設(shè)計簡化3. 能 滿足可變性要求的設(shè)計。4. 不 降低程序質(zhì)量。5. 用 可測試的并具備測試方法的術(shù)語描述設(shè)計。6. 考 慮處理時間 ,存儲量和操作過程方面的變化。7. 考 慮標(biāo)更對用戶服務(wù)的干擾以及實施變更的代價與時間。3. 修改程序代碼的準(zhǔn)則1. 必 須要先熟悉整個程序的控制流程。2. 不 要做不必要的修改。3. 不 影響原始程序的風(fēng)格和相容性。4. 記 錄所作過的修改。5. 審 查軟件質(zhì)量是否符合標(biāo)準(zhǔn)。6. 更 新程序文檔以反映修改并保留修改前的程序代碼版本。4. 重新驗

14、證程序的準(zhǔn)則1. 首 先測試程序故障 ,然后測試程序的未改動部分 ,最后測試程序的修改部分。2. 不 允許做修改的維護(hù)程序員成為唯一的重新驗證程序的人。3. 鼓 勵終端用戶參與到重新測試進(jìn)程中來。4. 在 重新驗證進(jìn)程中 , 記錄出錯的次數(shù)與類型 , 并把結(jié)果同所提供的測試功能 進(jìn)行 比較 ,以便估量出程序是否退化? 驗證過程每當(dāng)軟件被修改后 ,都要校驗其正確性。維護(hù)員應(yīng)該有選擇地作些重新測試工 作, 不僅要證實新的邏輯的正確性 , 而且要校驗實程序的為修改部分是否無損害 , 并 且整個 程序運行正確。若發(fā)現(xiàn)錯誤 ,則要馬上進(jìn)行修正。? 出錯及糾正方法經(jīng)查詢還有余票 , 但輸入旅客信息后卻發(fā)現(xiàn)已沒有余票。 發(fā)生這種情況的原因 是:有多 臺計算機(jī)同時輸入訂購?fù)淮魏桨嗟穆每托畔?, 在查詢余票時 , 其他輸入信 息并未寫入磁盤 , 票數(shù)并未修改。此時 ,應(yīng)該等待數(shù)秒后重新查詢余票。? 專門維護(hù)過程系統(tǒng)