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