【正文】 叫轉(zhuǎn)移功能。 ?CC08交換機(jī)應(yīng)該提供鬧鐘服務(wù)功能。 這個(gè)“等”包含哪些內(nèi)容？怎么測(cè)試？ 測(cè)試人員 需求范例 69 課程內(nèi)容 ?為什么要文檔化 ?文檔寫(xiě)作基本要求 ?需求設(shè)計(jì)文檔模板 ?需求文檔寫(xiě)作 ?設(shè)計(jì)文檔寫(xiě)作 設(shè)計(jì)文檔大綱 (開(kāi)發(fā)項(xiàng)目 ) 零層設(shè)計(jì) 一層設(shè)計(jì) 二層設(shè)計(jì) 配置和 控制 簡(jiǎn)介 模塊 1 詳設(shè) 數(shù)據(jù)庫(kù) 模塊 n 詳設(shè) …… HLD LLD 上下文定義 設(shè)計(jì)思路 分解描述 依賴(lài)性描述 接口描述 …… 分解描述 依賴(lài)性描述 接口描述 …… 數(shù)據(jù)描述 函數(shù)描述 開(kāi)發(fā)項(xiàng)目： 系統(tǒng)總體設(shè)計(jì) 子系統(tǒng)設(shè)計(jì) 系統(tǒng)對(duì)外關(guān)系 ?HLD分解層次一般不超過(guò) 3層（ 0層、 1層、 2層），每層的模塊數(shù)以 2到 4個(gè)為宜，最多不要超過(guò) 7個(gè)。 單元模塊函數(shù)總數(shù)也不超過(guò) 7個(gè)； ?HLD階段將所有函數(shù)全部分解出來(lái)， LLD階段不再關(guān)注模塊分解； ?HLD使用 結(jié)構(gòu)圖 描述函數(shù)的調(diào)用關(guān)系； ?函數(shù)分解規(guī)模以 30~50行 (非空非注釋 )為宜，最大不超過(guò)200行。每個(gè)函數(shù)的復(fù)雜度控制在 10以?xún)?nèi)，即：一個(gè)函數(shù)中不能有太多的 if， else， for, switch…case 等邏輯； ?LLD階段寫(xiě) 偽碼 ，推薦在 source insight中寫(xiě)，完成后嵌入 LLD中。偽碼的粗細(xì)程度以適宜作注釋為標(biāo)準(zhǔn)； 設(shè)計(jì)文檔寫(xiě)作要點(diǎn) 結(jié)構(gòu)圖 (structure chart)描述了一個(gè)系統(tǒng)的模塊劃分，體現(xiàn)了模塊之間的層次、組織和通信關(guān)系 示例： 結(jié)構(gòu)圖 偽碼 又叫 PDL(Program Design Language)，是一種混合語(yǔ)言，用自然語(yǔ)言（如英語(yǔ)、漢語(yǔ)等）描述程序的處理邏輯，用一定的關(guān)鍵字語(yǔ)法（如 if、 else等）定義控制結(jié)構(gòu)和數(shù)據(jù)結(jié)構(gòu)。 優(yōu)點(diǎn)： ?維護(hù)方便 ?容易評(píng)審 ?作為代碼注釋 缺點(diǎn)： ?不容易掌握粗細(xì) ?容易寫(xiě)成代碼 偽碼 偽碼 = 關(guān)鍵字語(yǔ)法 + 自然語(yǔ)言描述 偽碼 ?使用 C語(yǔ)言的語(yǔ)法書(shū)寫(xiě)偽代碼，使用標(biāo)準(zhǔn)符號(hào)，如： if, else, { }, while等； ?用描述性語(yǔ)言來(lái)描述； if（接口是以太網(wǎng)接口） if（ InterfaceType == ETHERNET) ?詳略得當(dāng)。用概括性的語(yǔ)句來(lái)描述具體的處理，要求在每個(gè)邏輯處理分支用簡(jiǎn)練、概括性的語(yǔ)言描述處理，而不要局限于處理的細(xì)節(jié)。 封裝 IP報(bào)文頭的內(nèi)容 。 用收到報(bào)文的源地址來(lái)設(shè)置發(fā)送報(bào)文的目的地址 。 用發(fā)送報(bào)文接口的地址來(lái)設(shè)置發(fā)送報(bào)文的源地址 。 偽碼寫(xiě)作說(shuō)明： 75 設(shè)計(jì)樣例 設(shè)計(jì)文檔大綱 (增強(qiáng)、移植項(xiàng)目 ) 移植或增強(qiáng)項(xiàng)目： 修改分類(lèi) 1 修改原因 影響分析 修改描述 修改點(diǎn) 1 修改點(diǎn) n …… …… 修改分類(lèi) N 增強(qiáng)、移植設(shè)計(jì) 修改分類(lèi)： ? 對(duì)所有需要的修改點(diǎn)進(jìn)行分類(lèi)，一個(gè)修改分類(lèi)包含一個(gè)或多個(gè)修改點(diǎn)，實(shí)現(xiàn)一相對(duì)獨(dú)立的功能； ? 每個(gè)修改分類(lèi)都應(yīng)使用有明確含義的標(biāo)題，如：“關(guān)于 XXX的修改”。 修改分類(lèi)一 關(guān)于將 MQC策略應(yīng)用到 ATM PVC接口下的修改 修改點(diǎn)： ? 一個(gè)修改點(diǎn)描述一處修改，如一個(gè)數(shù)據(jù)結(jié)構(gòu)的修改，一個(gè)宏定義的修改，一個(gè)函數(shù)的修改等； ? 修改點(diǎn)也應(yīng)使用有意義的標(biāo)題，不要使用“修改點(diǎn) 1”等。 增強(qiáng)、移植設(shè)計(jì) 修改原因： ? 針對(duì)每個(gè)修改點(diǎn)，具體闡述為什么需要修改，如因?yàn)槟衬程幚砹鞒痰淖兓?，功能的擴(kuò)展，界面的變化，性能的優(yōu)化等； ? 不應(yīng)該描述修改什么，這是修改描述部分應(yīng)詳細(xì)介紹的內(nèi)容； ? 修改原因中的描述應(yīng)有助于對(duì)修改描述的理解。 修改 原因 影響分析 修改描述 增強(qiáng)、移植設(shè)計(jì) 影響分析： ? 應(yīng)評(píng)估修改對(duì)原模塊有無(wú)沖擊，從功能、性能、接口等多方面進(jìn)行評(píng)估； ? 應(yīng)評(píng)估修改對(duì)系統(tǒng)資源的消耗情況； ? 應(yīng)描述為了配合此修改點(diǎn)還需要作哪些修改，即將各修改點(diǎn)關(guān)聯(lián)起來(lái)。 ? 還應(yīng)考慮對(duì)測(cè)試的影響，即如何充分地驗(yàn)證這些修改。 影響 分析 修改原因 修改描述 80 增強(qiáng)、移植設(shè)計(jì) 修改描述： ? 使用合適的 標(biāo)注方式 描述修改，修改前后對(duì)比要明顯； 修改 描述 影響分析 修改原因 新增的代碼：用紅色表示 修改的代碼：用藍(lán)色表示 刪除的代碼：用刪除線(xiàn)表示 continue 增強(qiáng)、移植設(shè)計(jì) 修改描述 :(續(xù) ) ? 對(duì)原代碼的修改一定要將修改的具體位置體現(xiàn)出來(lái) —— 將合適的代碼 加在 合適的位置 ； ? 新增函數(shù)應(yīng)采用偽碼描述，與原有函數(shù)的調(diào)用關(guān)系應(yīng)該用函數(shù)調(diào)用關(guān)系圖的方式表示出來(lái)，便于理解； ? 對(duì)于修改函數(shù)，若改動(dòng)量很小或很分散，可以直接用代碼描述；對(duì)于大段集中的修改，建議還是采用偽碼描述。 修改 描述 影響分析 修改原因 練習(xí) struct crypto_xf transforms[] 1）修改原因 crypto_xf transforms[]結(jié)構(gòu)增加 AES； 2）影響分析 無(wú) 3）修改描述 struct crypto_xf transforms[] = { …… { AES_CBC, AES(CBCMode), 16, 32, 2 * BLOCKSIZE, NULL, IKE_AesInit, IKE_AesEncrypt, IKE_AesDecrypt } …… } 修改原因還是在描述如何修改，為什么修改卻沒(méi)有闡述。 影響分析“無(wú)”，是無(wú)影響，還是沒(méi)有分析？ 修改描述中沒(méi)有體現(xiàn)出修改在原代碼中的具體位置。 練習(xí) 2 數(shù)據(jù)結(jié)構(gòu)修改： ETHARP_ARPRTENTRY_S 1）修改原因 需要在 ARP表項(xiàng)節(jié)點(diǎn)紀(jì)錄授權(quán)表項(xiàng)標(biāo)志位。 2）影響分析 修改原有數(shù)據(jù)結(jié)構(gòu)，對(duì)其他模塊無(wú)影響。 3）修改描述 typedef struct tagARPRTENTRY { 。 if ( VRP_MODULE_LINK_ARP_AUTHORIZED == VRP_YES ) ULONG ulArpAuthTag。 /* 授權(quán)表項(xiàng)標(biāo)志位 * 0x1 授權(quán) ARP。 * 0x0 其他 。 */ endif }ETHARP_ARPRTENTRY_S。 修改原因還是在描述如何修改，沒(méi)有介紹增加該標(biāo)志是為了什么。 影響分析“對(duì)其他模塊無(wú)影響”，結(jié)構(gòu)體變大，有沒(méi)有評(píng)估對(duì)系統(tǒng)內(nèi)存資源的消耗？ 增強(qiáng)、移植設(shè)計(jì)范例 85 思考 對(duì)于開(kāi)發(fā)項(xiàng)目，在詳細(xì)設(shè)計(jì)階段，我們提倡在 C文件中寫(xiě)偽碼，這樣較之在 word文檔中寫(xiě)偽碼的好處有： 。偽碼在形式上很接近于代碼，而大家更習(xí)慣在 source insight中閱讀代碼； ，原因同上； 。 對(duì)于增強(qiáng)、移植項(xiàng)目，目前大家都是在 word文檔中寫(xiě)設(shè)計(jì)，是因?yàn)?word文檔中可以使用特殊的標(biāo)注，這樣能將修改前后的對(duì)比體現(xiàn)出來(lái)。 移植設(shè)計(jì)能否也在 C文件中寫(xiě)呢？ 請(qǐng)大家思考這個(gè)問(wèn)題，如果有好的想法，可以提出來(lái)討論。 內(nèi)容回顧 ?為什么要文檔化 ?文檔寫(xiě)作基本要求 ?需求設(shè)計(jì)文檔模板 ?需求文檔寫(xiě)作 ?設(shè)計(jì)文檔寫(xiě)作 答疑 Any question ? 謝 謝 ! 謝謝觀(guān)看 /歡迎下載 BY FAITH I MEAN A VISION OF GOOD ONE CHERISHES AND THE ENTHUSIASM THAT PUSHES ONE TO SEEK ITS FULFILLMENT REGARDLESS OF OBSTACLES. BY FAITH I BY FAITH