【正文】 能需求分解不合理，所描述的功能根本就不成為需求。 處理 遍歷所有的全局 DDR控制塊鏈表 是 Dialer接口和物理接口 取 DDR的 if 取所有的撥號口屬性 返回鏈表頭指針 輸出 撥號口屬性鏈表頭指針。 ?95%的事務(wù)應(yīng)在 1秒內(nèi)被處理。 * 輸 入 : 無 * 輸 出 : 無 * 返 回 值 : VOS_OK： 表示登錄成功； VOS_ERR：表示登錄失敗。 例如： –使用特定的加密技術(shù) –保存詳細的日志或歷史數(shù)據(jù) –對不同模塊分配特定的功能 –限制程序某些區(qū)域間進行通信 –對重要的數(shù)據(jù)計算校驗和 55 軟件質(zhì)量屬性 總體概述 具體需求 設(shè)計約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 ?可移植性 描述把軟件從一個環(huán)境轉(zhuǎn)換到另一個環(huán)境時，所需要的用戶程序、用戶接口兼容性限制等需求。 “函數(shù)”、“數(shù)據(jù)結(jié)構(gòu)”、“指針”、 buildrun之類的表述； ，而不是站在開發(fā)人員的立場上。 PPP協(xié)商從對端得到協(xié)商的 DNS地址 在接口視圖下通過以下命令來配置取消要求通過 PPP主動協(xié)商從對端得到 DNS地址： undo ppp ipcp dns request 下一頁 需求文檔寫作要點 輸入 用戶在某一封裝了 PPP協(xié)議的接口視圖下，輸入 ： undo ppp ipcp dns request 處理 路由器解析此命令輸入正確后，將修改 PPP協(xié)議中的協(xié)商參數(shù)，使的路由器在進行 PPP協(xié)商的時候不會要求對端分配協(xié)商的 DNS地址。 輸入 取出協(xié)商得到的 DNS地址 處理 路由器保存協(xié)商得到的 DNS地址，并將其添加到接口信息中 輸出 操作成功后，協(xié)商得到的 DNS地址保存 GotOptions里，并被添加到接口信息中，否則顯示出錯提示，不會顯示在接口信息中。 一條接口需求（ [undo] ppp ipcp dns request ） 需求文檔寫作要點 唐僧：唉唉唉！大家不要生氣，生氣會犯了嗔戒的！悟空你也太調(diào)皮了，我跟你說過，叫你不要亂扔?xùn)|西。例如“系統(tǒng)必須 …… ”或者“用戶必須 …… ”，并緊跟一個行為動作和 可觀察 的結(jié)果。 例如：也許、大概、可能、界面友好、容易、簡單、美觀、迅速、有效、支持、許多、最新技術(shù)、優(yōu)越的、可接受的和健壯的。 伙計 2 伙計 3 伙計 1 伙計需求文檔寫作要點 ?不應(yīng)該把多個需求集中在一個冗長的敘述段落中。 ?CC08交換機應(yīng)該提供三方通話功能。 單元模塊函數(shù)總數(shù)也不超過 7個； ?HLD階段將所有函數(shù)全部分解出來， LLD階段不再關(guān)注模塊分解； ?HLD使用 結(jié)構(gòu)圖 描述函數(shù)的調(diào)用關(guān)系； ?函數(shù)分解規(guī)模以 30~50行 (非空非注釋 )為宜，最大不超過200行。用概括性的語句來描述具體的處理，要求在每個邏輯處理分支用簡練、概括性的語言描述處理，而不要局限于處理的細節(jié)。 偽碼寫作說明： 75 設(shè)計樣例 設(shè)計文檔大綱 (增強、移植項目 ) 移植或增強項目： 修改分類 1 修改原因 影響分析 修改描述 修改點 1 修改點 n …… …… 修改分類 N 增強、移植設(shè)計 修改分類： ? 對所有需要的修改點進行分類，一個修改分類包含一個或多個修改點，實現(xiàn)一相對獨立的功能； ? 每個修改分類都應(yīng)使用有明確含義的標題，如：“關(guān)于 XXX的修改”。 ? 還應(yīng)考慮對測試的影響，即如何充分地驗證這些修改。 練習 2 數(shù)據(jù)結(jié)構(gòu)修改： ETHARP_ARPRTENTRY_S 1）修改原因 需要在 ARP表項節(jié)點紀錄授權(quán)表項標志位。 /* 授權(quán)表項標志位 * 0x1 授權(quán) ARP。 影響分析“對其他模塊無影響”，結(jié)構(gòu)體變大，有沒有評估對系統(tǒng)內(nèi)存資源的消耗？ 增強、移植設(shè)計范例 85 思考 對于開發(fā)項目，在詳細設(shè)計階段，我們提倡在 C文件中寫偽碼，這樣較之在 word文檔中寫偽碼的好處有： 。 內(nèi)容回顧 ?為什么要文檔化 ?文檔寫作基本要求 ?需求設(shè)計文檔模板 ?需求文檔寫作 ?設(shè)計文檔寫作 答疑 Any question ? 謝 謝 ! 謝謝觀看 /歡迎下載 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 。 對于增強、移植項目，目前大家都是在 word文檔中寫設(shè)計，是因為 word文檔中可以使用特殊的標注，這樣能將修改前后的對比體現(xiàn)出來。 */ endif }ETHARP_ARPRTENTRY_S。 3）修改描述 typedef struct tagARPRTENTRY { 。 修改 描述 影響分析 修改原因 練習 struct crypto_xf transforms[] 1）修改原因 crypto_xf transforms[]結(jié)構(gòu)增加 AES； 2）影響分析 無 3）修改描述 struct crypto_xf transforms[] = { …… { AES_CBC, AES(CBCMode), 16, 32, 2 * BLOCKSIZE, NULL, IKE_AesInit, IKE_AesEncrypt, IKE_AesDecrypt } …… } 修改原因還是在描述如何修改，為什么修改卻沒有闡述。 增強、移植設(shè)計 修改原因： ? 針對每個修改點，具體闡述為什么需要修改，如因為某某處理流程的變化，功能的擴展，界面的變化，性能的優(yōu)化等； ? 不應(yīng)該描述修改什么，這是修改描述部分應(yīng)詳細介紹的內(nèi)容； ? 修改原因中的描述應(yīng)有助于對修改描述的理解。 用收到報文的源地址來設(shè)置發(fā)送報文的目的地址 。偽碼的粗細程度以適宜作注釋為標準； 設(shè)計文檔寫作要點 結(jié)構(gòu)圖 (structure chart)描述了一個系統(tǒng)的模塊劃分，體現(xiàn)了模塊之間的層次、組織和通信關(guān)系 示例： 結(jié)構(gòu)圖 偽碼 又叫 PDL(Program Design Language)，是一種混合語言，用自然語言（如英語、漢語等）描述程序的處理邏輯，用一定的關(guān)鍵字語法（如 if、 else等）定義控制結(jié)構(gòu)和數(shù)據(jù)結(jié)構(gòu)。 ?CC08交換機應(yīng)該提供鬧鐘服務(wù)功能。 ?CC08交換機應(yīng)該提供呼叫等待和三方通話等新業(yè)務(wù)。定量地說明所需要提高的程度或者說清一些參數(shù)可接受的最大值和最小值。 ?舉例： 計算過程中出現(xiàn)除零錯誤時，系統(tǒng)必須給出提示信息。唉，要是砸到小朋友呢，怎么辦？就算沒有砸到小朋友，砸到那些花花草草也是不對的呀！ ?保持語句和段落的簡短。 用戶的需求是什么？是這兩條命令行嗎？ 命令行只是我們提供的用戶界面，隱藏其后的功能需求是什么？ “支持通過 PPP協(xié)商獲取 DNS地址”，就這一條。否則顯示出錯提示。 輸出 操作成功后，可以通過在當前視圖下輸入 display this 命令來查看配置是否成功。 總體概述 具體需求 設(shè)計約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 60 需求文檔寫作要點 ?僅關(guān)注“ What to do”，即系統(tǒng)需提供什么功能。 ?可恢復(fù)性 在出現(xiàn)故障時的恢復(fù)能力和重新建立某種層次性能的