軟件編程規(guī)范培訓(xùn)實(shí)例與練習(xí)
軟件編程規(guī)范培訓(xùn)實(shí)例與練習(xí) o 問(wèn)題分類(lèi) 1 邏輯類(lèi)問(wèn)題（A類(lèi)）－指設(shè)計(jì)、編碼中出現(xiàn)的計(jì)算正確性和一致性、程序邏輯控制等方面 出現(xiàn)的問(wèn)題，在系統(tǒng)中起關(guān)鍵作用，將導(dǎo)致軟件死機(jī)、功能正常實(shí)現(xiàn)等嚴(yán)重問(wèn)題； 接口類(lèi)問(wèn)題（B類(lèi)）－指設(shè)計(jì)、編碼中出現(xiàn)的函數(shù)和環(huán)境、其他函數(shù)、全局/局部變量或 數(shù)據(jù)變量之間的數(shù)據(jù)/控制傳輸不匹配的問(wèn)題，在系統(tǒng)中起重要作用，將導(dǎo)致模塊間配合 失效等嚴(yán)重問(wèn)題； 維護(hù)類(lèi)問(wèn)題（C類(lèi)）－指設(shè)計(jì)、編碼中出現(xiàn)的對(duì)軟件系統(tǒng)的維護(hù)方便程度造成影響的問(wèn)題 ，在系統(tǒng)中不起關(guān)鍵作用，但對(duì)系統(tǒng)后期維護(hù)造成不便或?qū)е戮S護(hù)費(fèi)用上升； 可測(cè)試性問(wèn)題（D類(lèi)）－指設(shè)計(jì)、編碼中因考慮不周而導(dǎo)致后期系統(tǒng)可測(cè)試性差的問(wèn)題。 o 處罰辦法 問(wèn)題發(fā)生率： P=D/S D=DA+0.5DB+0.25DC 其中： P －問(wèn)題發(fā)生率 D －1個(gè)季度內(nèi)錯(cuò)誤總數(shù) DA －1個(gè)季度內(nèi)A類(lèi)錯(cuò)誤總數(shù) DB －1個(gè)季度內(nèi)B類(lèi)錯(cuò)誤總數(shù) DC －1個(gè)季度內(nèi)C類(lèi)錯(cuò)誤總數(shù) S －1個(gè)季度內(nèi)收到問(wèn)題報(bào)告單總數(shù) 1）當(dāng)D≥3時(shí)，如果P≥3％，將進(jìn)行警告處理，并予以公告； 2）當(dāng)D≥5時(shí)，如果P≥5％，將進(jìn)行罰款處理，并予以公告。 目 錄 |一、邏輯類(lèi)代碼問(wèn)題 |第5頁(yè) | |1、變量/指針在使用前就必須初始化 |第5頁(yè) | |【案例1.1.1】 |第5頁(yè) | |2、防止指針/數(shù)組操作越界 |第5頁(yè) | |【案例1.2.1】 |第5頁(yè) | |【案例1.2.2】 |第6頁(yè) | |【案例1.2.3】 |第7頁(yè) | |【案例1.2.4】 |第8頁(yè) | |3、避免指針的非法引用 |第9頁(yè) | |【案例1.3.1】 |第9頁(yè) | |4、變量類(lèi)型定義錯(cuò)誤 |第10頁(yè) | |【案例1.4.1】 |第10頁(yè) | |5、正確使用邏輯與&&、屏蔽&操作符 |第17頁(yè) | |【案例1.5.1】 |第17頁(yè) | |6、注意數(shù)據(jù)類(lèi)型的匹配 |第18頁(yè) | |【案例1.6.1】 |第18頁(yè) | |【案例1.6.2】 |第18頁(yè) | |7、用于控制條件轉(zhuǎn)移的表達(dá)式及取值范圍是否書(shū)寫(xiě)正確 |第20頁(yè) | |【案例1.7.1】 |第20頁(yè) | |【案例1.7.2】 |第21頁(yè) | |【案例1.7.3】 |第22頁(yè) | |8、條件分支處理是否有遺漏 |第24頁(yè) | |【案例1.8.1】 |第24頁(yè) | |9、引用已釋放的資源 |第26頁(yè) | |【案例1.9.1】 |第26頁(yè) | |10、分配資源是否已正確釋放 |第28頁(yè) | |【案例1.10.1】 |第28頁(yè) | |【案例1.10.2】 |第29頁(yè) | |【案例1.10.3】 |第30頁(yè) | |【案例1.10.4】 |第32頁(yè) | |【案例1.10.5】 |第33頁(yè) | |【案例1.10.6】 |第35頁(yè) | |【案例1.10.7】 |第38頁(yè) | |11、防止資源的重復(fù)釋放 |第39頁(yè) | |【案例1.11.1】 |第39頁(yè) | |12、公共資源的互斥性和競(jìng)用性 |第40頁(yè) | |【案例1.12.1】 |第40頁(yè) | |【案例1.12.2】 |第40頁(yè) | |二、接口類(lèi)代碼問(wèn)題 |第43頁(yè) | |1、對(duì)函數(shù)參數(shù)進(jìn)行有效性檢查 |第43頁(yè) | |【案例2.1.1】 |第43頁(yè) | |【案例2.1.2】 |第43頁(yè) | |【案例2.1.3】 |第44頁(yè) | |【案例2.1.4】 |第46頁(yè) | |【案例2.1.5】 |第47頁(yè) | |【案例2.1.6】 |第48頁(yè) | |2、注意多出口函數(shù)的處理 |第49頁(yè) | |【案例2.2.1】 |第49頁(yè) | |三、維護(hù)類(lèi)代碼問(wèn)題 |第51頁(yè) | |1、 統(tǒng)一枚舉類(lèi)型的使用 |第51頁(yè) | |【案例3.1.1】 |第51頁(yè) | |2、 注釋量至少占代碼總量的20％ |第51頁(yè) | |【案例3.2.1】對(duì)XXX產(chǎn)品BAM某版本部分代碼注釋量的統(tǒng)計(jì) |第51頁(yè) | |四、產(chǎn)品兼容性問(wèn)題 |第52頁(yè) | |1、系統(tǒng)配置、命令方式 |第52頁(yè) | |【案例4.1.1】 |第52頁(yè) | |【案例4.1.2】 |第53頁(yè) | |2、設(shè)備對(duì)接 |第54頁(yè) | |【案例4.2.1】 |第54頁(yè) | |3、其他 |第55頁(yè) | |【案例4.3.1】 |第55頁(yè) | |五、版本控制問(wèn)題 |第58頁(yè) | |1、新老代碼中同一全局變量不一致 |第58頁(yè) | |【案例5.1.1】 |第58頁(yè) | |六、可測(cè)試性代碼問(wèn)題 |第59頁(yè) | |1、調(diào)試信息/打印信息的正確性 |第59頁(yè) | |【案例6.1.1】 |第59頁(yè) | 一、邏輯類(lèi)代碼問(wèn)題 1、變量/指針在使用前就必須初始化 【案例1.1.1】 C語(yǔ)言中最大的特色就是指針。指針的使用具有很強(qiáng)的技巧性和靈活性，但同時(shí)也帶來(lái)了 很大的危險(xiǎn)性。在XXX的代碼中有如下一端對(duì)指針的靈活使用： ... ... _UC *puc_card_config_tab; ... ... Get_Config_Table( AMP_CPM_CARD_CONFIG_TABLE, &ul_card_config_num, &puc_card_config_tab, use_which_data_area ); ... ... b_middle_data_ok = generate_trans_middle_data_from_original_data( puc_card_config_tab, Ul_card_config_num) .... ... 其中紅色部分巧妙的利用指向指針的指針為指針puc_card_config_tab賦值,而在蘭色 部分使用該指針。但在Get_Config_Table函數(shù)中有可能失敗返回而不給該指針賦值。 因此，以后使用的可能是一個(gè)非法指針。 指針的使用是非常靈活的，同時(shí)也存在危險(xiǎn)性，必須小心使用。指針使用的危險(xiǎn)性舉 世共知。在新的編程思想中，指針基本上被禁止使用（JAVA中就是這樣），至少也是 被限制使用。而在我們交換機(jī)的程序中大量使用指針，并且有增無(wú)減。 2、防止指針/數(shù)組操作越界 【案例1.2.1】 在香港項(xiàng)目測(cè)試中，發(fā)現(xiàn)ISDN話(huà)機(jī)撥新業(yè)務(wù)號(hào)碼時(shí)，若一位一位的撥至18位，不會(huì)有問(wèn) 題。但若先撥完號(hào)碼再成組發(fā)送，會(huì)導(dǎo)致MPU死機(jī)。 處理過(guò)程： 查錯(cuò)過(guò)程很簡(jiǎn)單，按呼叫處理的過(guò)程檢查代碼，發(fā)現(xiàn)某一處的判斷有誤，本應(yīng)為小于18 的判斷，寫(xiě)成了小于等于18。 結(jié) 論： 代碼編寫(xiě)有誤。 思考與啟示： 1、極限測(cè)試必須注意，測(cè)試前應(yīng)對(duì)某項(xiàng)設(shè)計(jì)的極限做好充分測(cè)試規(guī)劃。 2、測(cè)試極限時(shí)還要注意多種業(yè)務(wù)接入點(diǎn)，本例為ISDN。對(duì)于交換機(jī)來(lái)說(shuō)，任何一種業(yè)務(wù) 都要分別在模擬話(huà)機(jī)、ISDN話(huà)機(jī)、V5話(huà)機(jī)、多種形式的話(huà)務(wù)臺(tái)上做測(cè)試。對(duì)于中繼的業(yè) 務(wù)，則要充分考慮各種信令：TUP、ISUP、PRA、NO1、V5等等。 【案例1.2.2】 對(duì)某交換類(lèi)進(jìn)行計(jì)費(fèi)測(cè)試，字冠011對(duì)應(yīng)1號(hào)路由、1號(hào)子路由，有4個(gè)中繼群11,12,13,1 4(都屬于1#模塊)，前后兩個(gè)群分別構(gòu)成自環(huán)。其中11,13群向?yàn)槌鲋欣^,12,14群向?yàn)槿?中繼，對(duì)這四個(gè)群分別進(jìn)行計(jì)費(fèi)設(shè)置，對(duì)出入中繼都計(jì)費(fèi)。電話(huà)60640001撥打01160010 001兩次，使四個(gè)群都有機(jī)會(huì)被計(jì)費(fèi)，取話(huà)單后瀏覽話(huà)單發(fā)現(xiàn)對(duì)11群計(jì)費(fèi)計(jì)次表話(huà)單出中 繼群號(hào)不正確，其它群的計(jì)次表中出中繼群號(hào)正常。 處理過(guò)程： 與開(kāi)發(fā)人員在測(cè)試組環(huán)境多次重復(fù)以上步驟，發(fā)現(xiàn)11群的計(jì)次表話(huà)單有時(shí)正常，有時(shí)其 出中繼群號(hào)就為一個(gè)隨機(jī)值，發(fā)生異常的頻率比較高。為什么其它群的話(huà)單正常，唯獨(dú) 11群不正常呢？11群是四個(gè)群中最小的群，其中繼計(jì)次表位于緩沖區(qū)的首位，打完電話(huà) 后查詢(xún)內(nèi)存發(fā)現(xiàn)出中繼群號(hào)在內(nèi)存中是正確的，取完話(huà)單后再查就不正確了。 結(jié) 論： 話(huà)單池的一個(gè)備份指針Pool_head_1和中繼計(jì)次表的頭指針重合，影響到第一個(gè)中繼計(jì)次 表的計(jì)費(fèi)。 思考與啟示： 隨機(jī)值的背后往往隱藏著指針問(wèn)題，兩塊內(nèi)存緩沖區(qū)的交界處比較容易出現(xiàn)問(wèn)題，在編 程時(shí)是應(yīng)該注意的地方。 【案例1.2.3】 【正 文】 在接入網(wǎng)產(chǎn)品A測(cè)試中，在內(nèi)存數(shù)據(jù)庫(kù)正常的情況下的各種數(shù)據(jù)庫(kù)方面的操作都是正常的 。為了進(jìn)行數(shù)據(jù)庫(kù)異常測(cè)試，于是將數(shù)據(jù)庫(kù)內(nèi)容人為地破壞了。發(fā)現(xiàn)在對(duì)數(shù)據(jù)庫(kù)進(jìn)行比 較操作時(shí)，出現(xiàn)程序跑死了現(xiàn)象。 經(jīng)過(guò)跟蹤調(diào)試發(fā)現(xiàn)問(wèn)題出現(xiàn)在如下一段代碼中: 1 for(i=0; idbf_count; i++) 2 { 3 pDBFat = (_NM_DBFAT_STRUC *)(NVDB_BASE + DBFAT_OFFSET + i*DBFAT_LEN); 4 if(fat_check(pDBFat) != 0) 5 { 6 pSysHead->system_flag = 0; 7 ...
軟件編程規(guī)范培訓(xùn)實(shí)例與練習(xí)