一.基本原則

強(qiáng)制性原則：

1.字符串的拼加操作，必須使用StringBuilder；

2.try…catch的用法

try{
}catch{Exception e
e.printStackTrace();
}finally{
}//在最外層的Action中可以使用，其它地方一律禁止使用；
try{ //程序代碼 }catch(Exception e){ //為空，什么都不寫(xiě) }//在任何場(chǎng)景中都禁止使用
try{
}catch{Exception e throw new runtimeException(e)；//最優(yōu)先采用的寫(xiě)法 }finally{
}

1.對(duì)于捕獲后，不知道干什么事情或者也不知道怎樣處理的情況，就不要捕獲異常，留給外出層去捕獲處理；

2.返回類型為集合的,在方法聲明中必須使用泛型，必須在javadoc中注明什么情況下返回null，什么情況下返回空集合。

3.對(duì)于方法、變量聲明范圍要采用如下優(yōu)先級(jí)：private、protected、public，對(duì)于變量要采用如下的優(yōu)先級(jí)：局部變量、實(shí)例變量、類變量，如果必須要采用實(shí)例變量或類變量的情況下，要保證線程安全性，如有可能盡量采用ThreadLocal保存實(shí)例變量或類變量；

4.如果不是必須，不要在循環(huán)中去定義變量或者new 對(duì)象；盡量在需要的最后一刻才去new 對(duì)象；

5.如果不是必須，不要在循環(huán)中去用try…catch;

6.類中對(duì)于比較復(fù)雜的邏輯要采用行注釋的方式進(jìn)行注釋，java代碼中絕對(duì)不允許采用塊注釋（/**/）進(jìn)行注釋；

7.Java類的名稱第一個(gè)子母必須大寫(xiě)，有多個(gè)單詞組成的，每個(gè)單詞的首字母大寫(xiě)

8.jsp的文件名必須全部小寫(xiě)；

9.Spring的bean配置文件名必須小寫(xiě)，格式為xxx.bean.xml，xxx.bean.xml配置文件中的<bean id=”” ，此處的id，就是將類名的第一個(gè)字母小寫(xiě)放到此處。

10.xwork的配置文件名必須小寫(xiě)，且遵循xwork_xxx.xml的格式書(shū)寫(xiě)，其中XXX是業(yè)務(wù)名稱的縮寫(xiě)；

11.日志的處理;

if (log.isDebugEnabled())
ex.printStackTrace(); else log.error("從數(shù)據(jù)庫(kù)刪除: [" + entity.getClass().getName() + "] 實(shí)例失敗", daex);
throw new PersistenceException("從數(shù)據(jù)庫(kù)刪除: [" + entity.getClass().getName()+ "] 實(shí)例失敗", daex);

12.代碼中嚴(yán)禁使用System.out.println()進(jìn)行調(diào)試輸出，如果要使用調(diào)試信息，必須使用log.debug()。對(duì)于必要的信息使用log.info()進(jìn)行輸出；

13.類中不要出現(xiàn)無(wú)用import，可以采用IDE工具進(jìn)行優(yōu)化，類提交前進(jìn)行代碼的格式化；

14.有業(yè)務(wù)邏輯處理的類必須寫(xiě)junit單元測(cè)試類；

15.國(guó)際化的支持：ftl模板中不允許出現(xiàn)中文字符，要全部放到相應(yīng)的properties文件中，properties文件要放到和Action類同樣的目錄中；ftl的編碼要全部采用UTF-8的格式；properties文件的命名：中文：Action名稱+“_zh”+“_CN”.properties，英文：Action名稱+“_en”+“_US”.properties

16.一個(gè)程序文件最好不要超過(guò)２０００行

17.盡可能縮小對(duì)象的作用域，這樣對(duì)象的可見(jiàn)范圍和生存期也都會(huì)盡可能地小，盡所有可能優(yōu)先采用局部變量，實(shí)在沒(méi)有辦法用全局變量的，優(yōu)先采用ThreadLocal來(lái)處理。

18.一個(gè)方法所完成的功能要單一,不同的功能封裝為不同的方法.

19.盡可能的處理異?；蜣D(zhuǎn)換異常，不要一味的包裝異常

20.如果對(duì)象在某個(gè)特定范圍內(nèi)必須被清理（而不是作為垃圾被回收），請(qǐng)使用帶有finally子句的try塊，在finally子句中進(jìn)行清理。

21.對(duì)于把一些邏輯相關(guān)的類組織在一起，可以考慮把一個(gè)類的定義放在另一個(gè)類的定義中，這種情況推薦使用內(nèi)部類（比如界面層中的事件響應(yīng)等）。內(nèi)部類擁有所有外圍類所有成員的訪問(wèn)權(quán)。

22.對(duì)成員變量的訪問(wèn)最好通過(guò)getter/setter方法,這樣能夠保證訪問(wèn)的合法性,以及代碼調(diào)整

23.優(yōu)先選擇接口而不是抽象類或具體類。如果你知道某些東西將成為基類，你應(yīng)當(dāng)優(yōu)先把它們?cè)O(shè)計(jì)成接口；只有在必須放進(jìn)方法定義或成員變量時(shí)，才把它修改為具體或抽象類。接口只和客戶希望的動(dòng)作有關(guān)（協(xié)議），而類則傾向于關(guān)注實(shí)現(xiàn)細(xì)節(jié)。

24.使用java標(biāo)準(zhǔn)庫(kù)提供的容器。精通他們的用法，將極大地提高工作效率。優(yōu)先選擇ArrayList來(lái)處理順序結(jié)構(gòu)，選擇HashSet來(lái)處理集合，選擇HashMap來(lái)處理關(guān)聯(lián)數(shù)組，選擇linkedList來(lái)處理堆棧和隊(duì)列，它對(duì)順序訪問(wèn)進(jìn)行了優(yōu)化，向List中間插入與刪除的開(kāi)銷小，但隨機(jī)訪問(wèn)則較慢。當(dāng)使用前三個(gè)的時(shí)候，應(yīng)該把他們向上轉(zhuǎn)型為L(zhǎng)ist、Set和Map,這樣就可以在必要的時(shí)候以其它方式實(shí)現(xiàn)

25.數(shù)組是一種效率最高的存儲(chǔ)和隨機(jī)訪問(wèn)對(duì)象引用序列的方式，但是當(dāng)創(chuàng)建了一個(gè)數(shù)組對(duì)象，數(shù)組的大小就被固定了，如果在空間不足時(shí)再創(chuàng)建新的數(shù)組進(jìn)行復(fù)制，這樣效率就比ArrayList開(kāi)銷大了。所以必須明確使用場(chǎng)景。

26.盡量使用”private”、”protected”關(guān)鍵字。一旦你把庫(kù)的特征（包括類、方法、字段）標(biāo)記為public,你就再也不可能去掉他們。在這種方式下，實(shí)現(xiàn)的變動(dòng)對(duì)派生類造成的影響最小，在處理多線程問(wèn)題的時(shí)候，保持私有性尤其重要，因?yàn)橹挥蠵rivate的字段才會(huì)受到保護(hù)，而不用擔(dān)心被未受同步控制的使用所破壞。

27.禁止后臺(tái)業(yè)務(wù)代碼使用如下代碼

try{
something()
}catch(Exception ex)
{} new Exception()

二.類編寫(xiě)規(guī)范

類的結(jié)構(gòu)組織，一般按照如下的順序：

1．常量聲明

2．靜態(tài)變量聲明

3．成員變量聲明

4．構(gòu)造函數(shù)部分

5．Finalize部分

6．成員方法部分

7．靜態(tài)方法部分

8.這種順序是推薦的，在實(shí)際開(kāi)發(fā)中可以按照一定的尺度修改，原則是程序更易讀。如對(duì)方法的排序按照重要性，或按照字母順序排列或按照方法之間的關(guān)系排列。

9.每個(gè)方法（包括構(gòu)造與finalize）都是一個(gè)段。多個(gè)變量聲明按照邏輯共同組成一個(gè)段，段與段之間以空行分隔。

10.類聲明時(shí)，要指出其訪問(wèn)控制，一般為沒(méi)有修飾符，public，和private。

11.方法與方法之間，大的部分之間都需要以空行隔離。

12.編寫(xiě)通用性的類時(shí)，請(qǐng)遵守標(biāo)準(zhǔn)形式。包括定義equals()、hasCode()、toString()、Clone(實(shí)現(xiàn)Cloneable接口)，并實(shí)現(xiàn)Comparable和Serialiable接口

13.對(duì)于設(shè)計(jì)期間不需要繼承的類，盡量使用final

三.變量編寫(xiě)規(guī)范

1.對(duì)成員變量, 盡量采用private

2.每一個(gè)變量聲明/定義占一行（參數(shù)變量除外），如

int a; int b;

比int a,b; 更容易讀, 更容易查找bug

3.局部變量在使用前必須初始化，一般在聲明時(shí)初始化

4.變量的聲明要放在程序塊的開(kāi)始位置

如

public void myMethod() { int int1 = 0; // beginning of method block if (condition) { int int2 = 0; // beginning of "if" block ...
}
}

一種例外情況是在for語(yǔ)句中，定義聲明不僅不占一行，還在表達(dá)式內(nèi)部，完全采用Eclips生成,如：

for(int i = 0; i<100; i++)

5.數(shù)組的申明采用 <數(shù)據(jù)類型[] + 變量名>方式如

char[] buffer;

而不是

char buffer[];

四.方法編寫(xiě)規(guī)范

1.對(duì)成員方法,不要輕易的采用public的成員變量。主要的修飾符有public, private, protected, 無(wú)

2.空方法中方法聲明和函數(shù)體可都在一行。如：　void func(){}

3.方法和方法之間空一行

4.方法的文檔注釋放在方法的緊前面，不能空一行。

5.避免過(guò)多的參數(shù)列表，盡量控制在５個(gè)以內(nèi)，若需要傳遞多個(gè)參數(shù)時(shí)，當(dāng)使用一個(gè)容納這些參數(shù)的對(duì)象進(jìn)行傳遞，以提高程序的可讀性和可擴(kuò)展性

6.方法中的循環(huán)潛套不能超過(guò)２層

7.對(duì)于設(shè)計(jì)期間不需要子類來(lái)重載的類，盡量使用final

8.每個(gè)方法盡量代碼行數(shù)盡量不要超過(guò)100行（有效代碼行，不包括注釋），但必須保證邏輯的完整性

9.接口中的方法默認(rèn)級(jí)別為protected，只有很確認(rèn)其它子系統(tǒng)的包會(huì)調(diào)用自己子系統(tǒng)的接口中的方法時(shí)，才將方法暴露為public.

五.語(yǔ)言使用及書(shū)寫(xiě)規(guī)范

1.避免變量的定義與上一層作用域的變量同名。

2.方法與方法之間用需要用一空行隔開(kāi)

3.局部變量在使用時(shí)刻聲明，局部變量/靜態(tài)變量在聲明時(shí)同時(shí)初始化

4.在與常數(shù)作比較時(shí)常數(shù)放在比較表達(dá)式的前面如：

if(“simpleCase”.equals(obj))… if(null == obj)….

5.return語(yǔ)句中，不要有復(fù)雜的運(yùn)算。

6.switch語(yǔ)句，需要一個(gè)缺省的分支

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論