資源描述:
《編碼規(guī)范-Java-細則培訓教材》由會員上傳分享,免費在線閱讀,更多相關內(nèi)容在行業(yè)資料-天天文庫。
1、◎CopyrightZTECorporation5July20051編碼規(guī)范-Java-細則培訓教程[Java]◎CopyrightZTECorporation5July20052目錄表代碼布局基本格式對齊空行空格斷行注釋命名規(guī)則聲明表達式與語句類和接口命名空間附編程實例◎CopyrightZTECorporation5July20053代碼布局代碼布局的目的是顯示出程序良好的邏輯結構,提高程序的準確性、連續(xù)性、可讀性、可維護性。更重要的是,統(tǒng)一的程序布局和編程風格,有助于提高整個項目的開發(fā)質(zhì)量,提高開發(fā)效率,
2、降低開發(fā)成本。同時,對于普通程序員來說,養(yǎng)成良好的編程習慣有助于提高自己的編程水平,提高編程效率。因此,統(tǒng)一的、良好的程序布局和編程風格不僅僅是個人主觀美學上的或是形式上的問題,而且會涉及到產(chǎn)品質(zhì)量,涉及到個人編程能力的提高,必須要引起重視?!駽opyrightZTECorporation5July20054代碼布局-基本格式【規(guī)則3-1-1】源代碼文件(.java)的布局順序是:包、import語句、類。正例:packagecom.zte;importjava.awt.peer.CanvasPeer;impo
3、rtjava.io.File;importcom.zte.ums.uep.AbsPage;publicclassClassName{}◎CopyrightZTECorporation5July20055代碼布局-基本格式【規(guī)則3-1-2】遵循統(tǒng)一的布局順序來書寫import語句,不同類別的import語句之間用空行分隔。Import聲明必須到具體的對象,不能使用*。說明:package語句其后可跟import語句,而且與package間隔一個空行。import包的排列順序為java開頭的包在最前面,接下來是引自
4、外部的包,再接下來是應用程序自身的包,即import中標準的包名要在本地的包名之前,而且按照字母順序排列?!駽opyrightZTECorporation5July20056代碼布局-基本格式【規(guī)則3-1-3】if、else、elseif、for、while、do等語句獨占一行,執(zhí)行語句不得緊跟其后。不論執(zhí)行語句有多少都要加{}。說明:這樣可以防止書寫失誤,也易于閱讀。◎CopyrightZTECorporation5July20057代碼布局-基本格式〖建議3-1-1〗源程序中關系較為緊密的代碼應盡可能相鄰。
5、說明:這樣便于程序閱讀和查找。正例:length=10;width=5;//矩形的長與寬關系較密切,放在一起。strCaption=“Test”;◎CopyrightZTECorporation5July20058代碼布局-對齊【規(guī)則3-2-1】一般禁止使用制表符,必須使用空格進行縮排。縮進為4個空格。說明:對于利用JBuilder等編程工具的,可以設置TAB鍵為4個空格代替。消除不同編輯器對制表符處理的差異?!駽opyrightZTECorporation5July20059代碼布局-對齊【規(guī)則3-2-2】程
6、序的分界符‘{’和‘}’應獨占一行,‘}’同時與引用它們的語句左對齊。{}之內(nèi)的代碼塊使用縮進規(guī)則對齊。說明:這樣使代碼便于閱讀,并且方便注釋。do…while語句可以例外,while條件可與}在同一行?!駽opyrightZTECorporation5July200510代碼布局-對齊【規(guī)則3-2-3】多維的數(shù)組如果在定義時初始化,按照數(shù)組的矩陣結構分行書寫。正例:int[][]number={{1,1,1},{2,4,8},{3,9,27},{4,16,64}};◎CopyrightZTECorporati
7、on5July200511代碼布局-對齊【建議3-2-1】相關的賦值語句等號對齊。正例:width=50;length=20;height=40;◎CopyrightZTECorporation5July200512代碼布局-空行空格【規(guī)則3-3-1】不同邏輯程序塊之間要使用空行分隔。說明:空行起著分隔程序段落的作用。適當?shù)目招锌梢允钩绦虻牟季指忧逦?。◎CopyrightZTECorporation5July200513代碼布局-空行空格【規(guī)則3-3-2】一元操作符如“!”、“~”、“++”、“--”、“*”
8、、“&”等前后不加空格。“[]”、“.”這類操作符前后不加空格。正例:!bValue~iValue++iCount&fSumaiNumber[i]=5;tBox.dWidth◎CopyrightZTECorporation5July200514代碼布局-空行空格【規(guī)則3-3-3】多元運算符和它們的操作數(shù)之間至少需要一個空格。正例:fValue=fOldValue;fTotal+fVal