資源描述:
《華為Java語(yǔ)言編碼規(guī)范.doc》由會(huì)員上傳分享,免費(fèi)在線(xiàn)閱讀,更多相關(guān)內(nèi)容在行業(yè)資料-天天文庫(kù)。
1、Java編碼規(guī)范Documentnumber文檔編號(hào)Confidentialitylevel密級(jí)內(nèi)部公開(kāi)Documentversion文檔版本Total28pages共28頁(yè)V1.00Java語(yǔ)言編碼規(guī)范Preparedby擬制Date日期yyyy-mm-ddReviewedby評(píng)審人Date日期yyyy-mm-ddApprovedby批準(zhǔn)Date日期yyyy-mm-dd.Page28,Total28Java編碼規(guī)范RevisionRecord修訂記錄Date日期RevisionVersion修訂版本SecNo.修改章節(jié)ChangeDescription修改描述Author作者yyyy-mm
2、-ddVx.xx.Page28,Total28Java編碼規(guī)范TableofContents目錄1.范圍42.規(guī)范性引用文件43.術(shù)語(yǔ)和定義44.排版規(guī)范54.1.規(guī)則54.2.建議75.注釋規(guī)范85.1.規(guī)則85.2.建議136.命名規(guī)范166.1.規(guī)則166.2.建議177.編碼規(guī)范197.1.規(guī)則197.2.建議238.JTEST規(guī)范258.1.規(guī)則258.2.建議26.Page28,Total28Java編碼規(guī)范1.范圍本規(guī)范規(guī)定了使用Java語(yǔ)言編程時(shí)排版、注釋、命名、編碼和JTEST的規(guī)則和建議。本規(guī)范適用于使用Java語(yǔ)言編程的產(chǎn)品和項(xiàng)目。2.規(guī)范性引用文件下列文件中的條款通過(guò)
3、本規(guī)范的引用而成為本規(guī)范的條款。凡是注日期的引用文件,其隨后所有的修改單(不包括勘誤的內(nèi)容)或修訂版均不適用于本規(guī)范,然而,鼓勵(lì)根據(jù)本規(guī)范達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件,其最新版本適用于本規(guī)范。序號(hào)編號(hào)名稱(chēng)1公司-DKBA1040-2001.12《Java語(yǔ)言編程規(guī)范》3.術(shù)語(yǔ)和定義規(guī)則:編程時(shí)強(qiáng)制必須遵守的原則。建議:編程時(shí)必須加以考慮的原則。格式:對(duì)此規(guī)范格式的說(shuō)明。說(shuō)明:對(duì)此規(guī)范或建議進(jìn)行必要的解釋。示例:對(duì)此規(guī)范或建議從正、反兩個(gè)方面給出例子。.Page28,Total28Java編碼規(guī)范1.排版規(guī)范1.1.規(guī)則1.1.1.*程序塊要采用縮進(jìn)風(fēng)
4、格編寫(xiě),縮進(jìn)的空格數(shù)為4個(gè)。說(shuō)明:對(duì)于由開(kāi)發(fā)工具自動(dòng)生成的代碼可以有不一致。1.1.2.*分界符(如大括號(hào)‘{’和‘}’)應(yīng)各獨(dú)占一行并且位于同一列,同時(shí)與引用它們的語(yǔ)句左對(duì)齊。在函數(shù)體的開(kāi)始、類(lèi)和接口的定義、以及if、for、do、while、switch、case語(yǔ)句中的程序都要采用如上的縮進(jìn)方式。示例:如下例子不符合規(guī)范。for(...){...//programcode}if(...){...//programcode}voidexample_fun(void){...//programcode}應(yīng)如下書(shū)寫(xiě):for(...){...//programcode}if(...){.../
5、/programcode}voidexample_fun(void){...//programcode}1.1.3.*較長(zhǎng)的語(yǔ)句、表達(dá)式或參數(shù)(>80字符)要分成多行書(shū)寫(xiě),長(zhǎng)表達(dá)式要在低優(yōu)先級(jí)操作符處劃分新行,操作符放在新行之首,劃分出的新行要進(jìn)行適當(dāng)?shù)目s進(jìn),使排版整齊,語(yǔ)句可讀。示例:if(filename!=null&&newFile(logPath+filename).length()6、eendTime,intlogLevel,StringuserName,intbufferNum).Page28,Total28Java編碼規(guī)范1.1.1.*不允許把多個(gè)短語(yǔ)句寫(xiě)在一行中,即一行只寫(xiě)一條語(yǔ)句示例:如下例子不符合規(guī)范。LogFilenamenow=null;LogFilenamethat=null;應(yīng)如下書(shū)寫(xiě):LogFilenamenow=null;LogFilenamethat=null;1.1.2.*if,for,do,while,case,switch,default等語(yǔ)句自占一行,且if,for,do,while等語(yǔ)句的執(zhí)行語(yǔ)句無(wú)論多少都要加括號(hào){}。示例:如下例子不符
7、合規(guī)范。if(writeToFile)writeFileThread.interrupt();應(yīng)如下書(shū)寫(xiě):if(writeToFile){writeFileThread.interrupt();}1.1.3.*相對(duì)獨(dú)立的程序塊之間、變量說(shuō)明之后必須加空行。示例:如下例子不符合規(guī)范。if(log.getLevel()