《軟件編碼設(shè)計(jì)標(biāo)準(zhǔn)規(guī)范.doc》由會(huì)員分享，可在線閱讀，更多相關(guān)《軟件編碼設(shè)計(jì)標(biāo)準(zhǔn)規(guī)范.doc（4頁(yè)珍藏版）》請(qǐng)?jiān)趨R文網(wǎng)上搜索。

1、8a3f430f0dd3bef071a6c6aab20a949f.doc軟件編碼設(shè)計(jì)規(guī)范11編寫(xiě)目的：使用統(tǒng)一編碼約定集的主要原因，是使應(yīng)用程序的結(jié)構(gòu)和編碼風(fēng)格標(biāo)準(zhǔn)化，以便于閱讀和理解這段編碼。好的編碼約定可使源代碼嚴(yán)謹(jǐn)、可讀性強(qiáng)且意義清楚，與其它語(yǔ)言約定相一致，并且盡可能的直觀。一組通用目的的編碼約定應(yīng)該定義完成上述目的所必需的、能讓程序員自由地創(chuàng)建程序邏輯和功能流程的最小的要求。編碼約定的目的是使程序易于閱讀和理解，而不是用過(guò)份的約束和絕對(duì)的限制來(lái)束縛程序員本身的創(chuàng)造性。12內(nèi)容：程序設(shè)計(jì)語(yǔ)言的特性和風(fēng)格會(huì)直接影響到軟件的質(zhì)量和可維護(hù)性。編碼原則：應(yīng)盡量避免在系統(tǒng)初始化時(shí)運(yùn)行過(guò)多的代碼。（

2、此處加入詳細(xì)原則）（1） 選用控制結(jié)構(gòu)只準(zhǔn)許一個(gè)入口和一個(gè)出口。（2） 程序語(yǔ)句組成容易識(shí)別的塊，每塊只有一個(gè)入口和一個(gè)出口。（3） 復(fù)雜的結(jié)構(gòu)應(yīng)該用基本控制結(jié)構(gòu)進(jìn)行組合嵌套來(lái)實(shí)現(xiàn)。（4） 語(yǔ)句中沒(méi)有的控制結(jié)構(gòu)，可用一段等價(jià)的程序段模擬，但要求該程序段在整個(gè)系統(tǒng)應(yīng)前后一致。（5） 嚴(yán)格控制GOTO語(yǔ)句，僅在下列情形才可使用。u 用一個(gè)非結(jié)構(gòu)化的程序設(shè)計(jì)語(yǔ)言去實(shí)現(xiàn)一個(gè)結(jié)構(gòu)化的構(gòu)造。u 在某種可以改善而不是損害程序可讀性的情況下。121對(duì)象命名約定公式：對(duì)象名稱(chēng)=對(duì)象前綴+自定義名稱(chēng)（自定義名稱(chēng)要有一定的意義且第一個(gè)字母大寫(xiě)）說(shuō)明：如果是不需要對(duì)其編碼的對(duì)象，那么對(duì)象名用默認(rèn)對(duì)象名。應(yīng)該用一致的前

3、綴來(lái)命名對(duì)象，使人們?nèi)菀鬃R(shí)別對(duì)象的類(lèi)型。下面列出了 Delphi 支持的一些推薦使用的對(duì)象約定。（1） 推薦使用的項(xiàng)目前綴控件類(lèi)型前綴例子Class Modulecmdl cmdlCheckData Environment dev devPrints Data Report drtdrtEnglishFormfrmfrmEntryMDIForm mfrmmfrmSinoexportModulemdl mdlConnection ProjectpjtpjtCkmis（2）推薦使用的控件前綴控件類(lèi)型前綴例子3D PanelpnlpnlGroupADO DataadoadoBiblioAnimate

4、d buttonanianiMailBoxCheck boxchkchkReadOnlyCombo box drop-down list boxcbocboEnglishCommand buttoncmdcmdExitCommon dialogdlgdlgFileOpenCommunications comcomFaxControl（當(dāng)特定類(lèi)型未知時(shí)，在過(guò)程中所使用的）ctrctrCurrentDatadatdatBiblioData-bound combo boxdbcbodbcboLanguageData-bound griddbgrddbgrdQueryResultxxxxxxxxxxx

5、xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（3）推薦使用的數(shù)據(jù)訪問(wèn)對(duì)象的前綴用下列前綴來(lái)指示數(shù)據(jù)訪問(wèn)對(duì)象。數(shù)據(jù)庫(kù)對(duì)象前綴例子ConnectionconconReportsxxxdbdbAccounts一些例子：（此處加入例子）（4）推薦使用的菜單前綴應(yīng)用程序頻繁使用許多菜單控件，對(duì)于這些控件具備一組唯一的命名約定很實(shí)用。除了最前面 mnu 標(biāo)記以外，菜單控件的前綴應(yīng)該被擴(kuò)展：對(duì)每一級(jí)嵌套增加一個(gè)附加前綴，將最終的菜單的標(biāo)題放在名稱(chēng)字符串的最后。下表列出了一些例子。菜單標(biāo)題序列 菜單處理器名稱(chēng) （此處加入標(biāo)題序列及處理器名稱(chēng)）當(dāng)使用這種命名約定時(shí)，一個(gè)特定的菜單組的所有成員一個(gè)

6、接一個(gè)地列在 Visual Basic 的“屬性”窗口中。而且，菜單控件的名字清楚地表示出它們所屬的菜單項(xiàng)。（5）為其它控件選擇前綴對(duì)于上面沒(méi)有列出的控件，應(yīng)該用唯一的由兩個(gè)或三個(gè)字符組成的前綴使它們標(biāo)準(zhǔn)化，以保持一致性。只有當(dāng)需要澄清時(shí)，才使用多于三個(gè)字符的前綴。例如，（此處加入例子）122常量和變量命名約定 公式：常量或變量名稱(chēng)=常量或變量范圍前綴+常量或變量類(lèi)型前綴+自定義名稱(chēng)（自定義名稱(chēng)要有一定的意義且第一個(gè)字母大寫(xiě)）除了對(duì)象之外，常量和變量也需要良好格式的命名約定。本節(jié)列出了（此處加入變量列表）。變量應(yīng)該總是被定義在盡可能小的范圍內(nèi)。全局 (Public) 變量可以導(dǎo)致極其復(fù)雜的狀態(tài)

7、機(jī)構(gòu)，并且使一個(gè)應(yīng)用程序的邏輯非常難于理解。全局變量也使代碼的重用和維護(hù)更加困難。Delphi中的變量可以有下列范圍：范圍 聲明位置 可見(jiàn)位置 過(guò)程級(jí)（此處加入名稱(chēng)） 模塊級(jí)（此處加入名稱(chēng)）全局（此處加入名稱(chēng)）。較好的編碼習(xí)慣是盡可能寫(xiě)模塊化的代碼。例如，如果應(yīng)用程序顯示一個(gè)對(duì)話框，就把要完成這一對(duì)話任務(wù)所需要的所有控件和代碼放在單一的窗體中。這有助于將應(yīng)用程序的代碼組織在有用的組件中，并減小它運(yùn)行時(shí)的開(kāi)銷(xiāo)。除了全局變量（應(yīng)該是不被傳遞的），過(guò)程和函數(shù)應(yīng)該僅對(duì)傳遞給它們的對(duì)象操作。在過(guò)程中使用的全局變量應(yīng)該在過(guò)程起始處的聲明部分中標(biāo)識(shí)出來(lái)。變量范圍前綴隨著工程大小的增長(zhǎng)，劃分變量范圍的工作也迅

8、速增加。在類(lèi)型前綴的前面放置單字母范圍前綴標(biāo)明了這種增長(zhǎng)，但變量名的長(zhǎng)度并沒(méi)有增加很多。范圍前綴例子全局gGstrUserName模塊級(jí)mMblnCalcInProgress本地到過(guò)程無(wú)DblVelocity（此處加入說(shuō)明）變量聲明所有的變量將會(huì)（此處加入說(shuō)明）。應(yīng)該給變量加前綴來(lái)指明它們的數(shù)據(jù)類(lèi)型。而且前綴可以被擴(kuò)展，用來(lái)指明變量范圍，特別是對(duì)大型程序。變量數(shù)據(jù)類(lèi)型用下列前綴來(lái)指明一個(gè)變量的數(shù)據(jù)類(lèi)型。（此處加入說(shuō)明）描述變量和過(guò)程名變量或過(guò)程名的主體應(yīng)該使用大小寫(xiě)混合形式，并且應(yīng)該足夠長(zhǎng)以描述它的作用。而且，函數(shù)名（此處加入函數(shù)名稱(chēng)）。對(duì)于頻繁使用的或長(zhǎng)的項(xiàng)，推薦使用標(biāo)準(zhǔn)縮略語(yǔ)以使名稱(chēng)的長(zhǎng)度

9、合理化。一般來(lái)說(shuō)，（此處加入特例說(shuō)明）就困難了。當(dāng)使用縮略語(yǔ)時(shí)，要確保它們?cè)谡麄€(gè)應(yīng)用程序中的一致性。在一個(gè)工程中，如果一會(huì)兒使用（此處加入說(shuō)明問(wèn)題），將導(dǎo)致不必要的混淆。用戶定義的類(lèi)型在一項(xiàng)有許多用戶定義類(lèi)型的大工程中，常常有必要給每種類(lèi)型一個(gè)它自己的三個(gè)字符的前綴。如果這些前綴是（此處加入前綴名稱(chēng)）。123結(jié)構(gòu)化編碼約定（此處加入約定說(shuō)明）記住下列幾點(diǎn)： 每一個(gè)重要變量的聲明應(yīng)該包括（此處加入變量名稱(chēng)）。 （2）格式化代碼因?yàn)樵S多程序員（此處加入問(wèn)題） （此處加入解決問(wèn)題的說(shuō)明）（3）給常量分組變量和定義的常量應(yīng)該按功能分組，而不是分散到單獨(dú)區(qū)域或特定文件中。（4）運(yùn)算符（此處加入運(yùn)算符列表及說(shuō)明）（5）為（此處加入問(wèn)題） 查詢(xún)創(chuàng)建字符串（此處加入說(shuō)明）124數(shù)據(jù)源的約定（此處加入數(shù)據(jù)源的約定）125數(shù)據(jù)庫(kù)訪問(wèn)約定訪問(wèn)數(shù)據(jù)庫(kù)用ODBC drivers/ADO，但如果在有的技術(shù)ADO解決不了的情況下可用其他方法。數(shù)據(jù)庫(kù)訪問(wèn)技術(shù)有：（此處加入說(shuō)明）126其他約定（1）當(dāng)日期、時(shí)間型數(shù)據(jù)要求嚴(yán)格時(shí)，（此處加入說(shuō)明） （2）記錄集應(yīng)用約束（此處加入約束）利用記錄集（此處加入記錄集說(shuō)明）（3）文件命名約定工程文件和各模塊文件以漢字命名保存，這樣可方便管理和查找。參考文獻(xiàn)：（此處加入?yún)⒖嘉墨I(xiàn)）第 4 頁(yè) 共 9頁(yè)