軟件詳細(xì)設(shè)計說明書

1、文檔編號廣品版本密級產(chǎn)品名稱：共 頁XX模塊軟件詳細(xì)設(shè)計說明書（僅供內(nèi)部使用）擬制：日期：yyyy-mm-dd審核：日期：yyyy-mm-dd核準(zhǔn)：日期：yyyy-mm-dd日期：yyyy-mm-dd文檔版本：版權(quán)所有 侵權(quán)必究文件修改記錄修改日期版本修改頁他、章節(jié)、條 款修改描述作者yyyy-mm-dd1目的 錯誤!未指定書簽。2代碼框架描述 錯誤!未指定書簽o2.1 目錄結(jié)構(gòu) 錯誤!未指定書簽。2.2 源文件說明 錯誤!未指定書簽。2.3 模塊配置文件說明 錯誤!未指定書簽。3數(shù)據(jù)2構(gòu) 錯誤!未指定書簽。3.1 數(shù)據(jù)結(jié)本勾定義錯誤!未指定書簽。3.2 數(shù)據(jù)結(jié)構(gòu)關(guān)系圖（可選） 錯誤!未指定書

2、簽。3.3 公共頭文件定義錯誤!未指定書簽。4子模塊（實體）1詳細(xì)設(shè)計說明 錯誤!未指定書簽。4.1 數(shù)據(jù)Z構(gòu) 錯誤!未指定書簽。4.2 處理流程詳細(xì)說明 錯誤!未指定書簽。4.3 編碼設(shè)計錯誤!未指定書簽。4.3.1 函數(shù)1 錯誤!未指定書簽。4.3.2 函數(shù)2 錯誤!未指定書簽。43n函數(shù)n 錯誤!未指定書簽。5子模塊（實體）2詳細(xì)設(shè)計說明 錯誤!未指定書簽。6附錄 子系統(tǒng)定義表 錯誤!未指定書簽。軟件詳細(xì)設(shè)計說明書關(guān)鍵詞：摘要：縮略語說明:縮略語英文全名中文解釋參考資料：列出本文檔的所有參考文獻(xiàn)（包括：正式/非正式出版物、公司/部門文檔等），格式如下: 作者+書名（或雜志、文獻(xiàn)、文檔）+

3、出版社（或期號、卷號、公司文檔編號）+出版日期 模板使用說明：1注明可選的部分，可以根據(jù)實際情況選擇是否填寫；如果不必說明，請務(wù)必保留相 關(guān)的章節(jié)標(biāo)題，同時在該可選章節(jié)的內(nèi)容中填入“無”；未注名可選的，則必須描述；如果 有些設(shè)計此模版中沒有合適的地方填寫，則補(bǔ)充在最后的其他欄目中2模版中斜體字相當(dāng)于撰寫指南，最后文稿請將本模板中所有的斜體字部分全部刪除。3模板里并不說明設(shè)計技術(shù)和方法，而只是說明應(yīng)包含哪些內(nèi)容，以及如何描述、組 織這些內(nèi)容。4對于移植的代碼，描述可以相對簡單一些，但以下這些章節(jié)不能省略：代碼框架描述、第3節(jié)可以簡寫，第4節(jié)可以根據(jù)項目實際情況簡寫1目的闡明編寫詳細(xì)設(shè)計說明書的目

4、的2代碼框架描述本部分描述系統(tǒng)的源代碼分布框架，說明源代碼存放的目錄結(jié)構(gòu)、各源文件的功能。 總體設(shè)計中有一個開發(fā)視圖，這一部分就是對總體設(shè)計中開發(fā)視圖的進(jìn)一步細(xì)化。2.1 目錄結(jié)構(gòu)說明系統(tǒng)源代碼文件存放的目錄、子目錄，及其包含的文件列表。如下：目錄名稱目錄說明包含源文件列表2.2 源文件說明如下表格式對系統(tǒng)包含的源代碼文件進(jìn)行大致說明:源文件名稱文件描述子模塊1文件1文件n子模塊2文件1文件n注：“目錄結(jié)構(gòu)”和“源文件說明”表格在詳細(xì)設(shè)計后期和編碼階段都可能被修改2.3 模塊配置文件說明該模塊在配置文件中的實現(xiàn)腳本代碼。3 數(shù)據(jù)結(jié)構(gòu)3.1 數(shù)據(jù)結(jié)構(gòu)定義實現(xiàn)該模塊的主要數(shù)據(jù)結(jié)構(gòu)定義?？梢允褂肅

5、語言描述數(shù)據(jù)結(jié)構(gòu)定義，對于每個成員變量必須進(jìn)行說明。如果涉及到配置描述，也請在這里說明。因為有的宏定義可能是通過makeconfig 文件生成的，所以這里需要描述涉及到哪些宏。3.2 數(shù)據(jù)結(jié)構(gòu)關(guān)系圖（可選）畫出模塊內(nèi)部數(shù)據(jù)結(jié)構(gòu)之間以及和外部基礎(chǔ)結(jié)構(gòu)之間的關(guān)系圖，并文字描述其關(guān)系。數(shù)據(jù)結(jié)構(gòu)之間的關(guān)聯(lián)關(guān)系對應(yīng)關(guān)系是如何的。如果圖中還不足以描述清楚的部分，必須附加文字說明3.3 公共頭文件定義將所有開放給外部模塊可以訪問的數(shù)據(jù)結(jié)構(gòu)和函數(shù)定義保存在公共頭文件中，這個公共頭文件在include 下的特定目錄中。需要羅列出公共頭文件名，保存路徑，以及公共頭文件的內(nèi)容。比如 : Xxx.h （ 路徑： in

6、clude/net/xxx）如果在 include 下有多個頭文件，那么必須制定一個主文件，也就是說，只要include了這個主文件，就可以得到這個模塊對外提供的所有服務(wù)功能的聲明了。4 子模塊（實體）1 詳細(xì)設(shè)計說明主要從數(shù)據(jù)結(jié)構(gòu)和函數(shù)（算法）兩個方面進(jìn)行詳細(xì)設(shè)計說明。對于詳細(xì)設(shè)計，如果你覺得還有一些要素的描述可以幫助理解本設(shè)計文檔，則可以增加一個或多個小節(jié)進(jìn)行描述，這個由設(shè)計人員自行把握，不做強(qiáng)制約定。注：因為詳細(xì)設(shè)計的目的是為了編碼，所以其設(shè)計輸出應(yīng)當(dāng)盡可能地使后面的編碼工作變得方便快捷，同時達(dá)到設(shè)計目標(biāo)要求?？梢哉f， 前面的總體設(shè)計工作主要在于闡述設(shè)計思想，目的是為了使項目的審核者、維

7、護(hù)者、編碼者更好地理解設(shè)計原理，也為了他們在必要的時候更好地理解代碼。而詳細(xì)設(shè)計則詳細(xì)具體地描述了設(shè)計目標(biāo)的實現(xiàn)方法和步驟。所以，本節(jié)是編碼的直接依據(jù)（編碼的輸入）， 是對前面總體設(shè)計工作的具體實現(xiàn)（設(shè)計的輸出）。4.1 數(shù)據(jù)結(jié)構(gòu)具體定義模塊1 相關(guān)的數(shù)據(jù)結(jié)構(gòu)，并加以解釋說明。4.2 處理流程詳細(xì)說明各模塊的函數(shù)之間是存在關(guān)聯(lián)關(guān)系的，為了增加可讀性，子模塊的每個功能實現(xiàn)流程在 這里說明。（1）功能1這里描述實現(xiàn)這個子模塊功能有幾個步驟（2）功能2簡單的步驟可以用文字描述，復(fù)雜的必須使用流程圖表示（可以使用函數(shù)間的調(diào)用 關(guān)系或流程來表示）。這個要和前面的總體設(shè)計模板中的5.3.1節(jié)關(guān)聯(lián)起來，是對

8、該節(jié) 的進(jìn)一步細(xì)化設(shè)計和說明。4.3 編碼設(shè)計本節(jié)須說明模塊1涉及的源文件，主要函數(shù)（或稱子模塊、子程序）名稱和說明，并 用程序描述語言（如偽代碼）實現(xiàn)主要函數(shù)主要函數(shù)列表格式如下:主要函數(shù)名稱函數(shù)簡要說明文件一函數(shù)1簡要描述函數(shù)的功能O O O ,O O O函數(shù)n文件二函數(shù)1O O O ,O O O函數(shù)n4.3.1 函數(shù)1【功能】簡要描述函數(shù)的功能【參數(shù)】列出此函數(shù)的各輸入項，說明其類型、名稱、含義、取值范圍等【返回值】列出此函數(shù)的各輸出項，說明其類型、名稱、含義、取值范圍等【算法】用程序描述語言描述此函數(shù)的處理過程、 算法邏輯。對于邏輯比較簡單的函數(shù)，可以概 括地說一下算法，或者略去此項。對于數(shù)據(jù)結(jié)構(gòu)訪問需要上鎖、關(guān)中斷等操作必須在這里說明 需要提供調(diào)試內(nèi)容的，需要在這里說明?！臼褂谜f明】說明該函數(shù)的外部定義包含在哪個頭文件里。說明調(diào)用此函數(shù)時的注意事項，以及設(shè)計者認(rèn)為應(yīng)當(dāng)交待的其它事項 。4.3.2 函數(shù)2o O O O43n 函數(shù)no O O O5子模塊（實體）2詳細(xì)設(shè)計說明用類似方式，說明第2個模塊乃至第N個模塊的設(shè)計考慮。6附錄子系統(tǒng)定義表如果本詳細(xì)設(shè)計所對應(yīng)的最后實現(xiàn)代碼并未組織成一個子系統(tǒng)的話，就不需要填下面的 表格。填表說明：表格項填寫說明Name該子系統(tǒng)的名字Class