Java 程序書寫規(guī)范

cinc

[這個(gè)貼子最后由cinc在 2002/09/10 05:36pm 編輯]

Java 程序書寫規(guī)范
cinc 2002-09-10

任何一門語言都是用來交流的，都有自己的一套書寫規(guī)范，Java 也不例外。

好的命名規(guī)范可以讓你的程序更專業(yè)，更容易被別人理解，更好維護(hù)。
了解命名規(guī)范，可以更好的學(xué)習(xí)和記憶 Java 類庫中類和函數(shù)。

下面的幾個(gè)原則是編寫 Java 程序必須遵守的
如果沒有非常好的理由，永遠(yuǎn)不要違背他。

1.包
   由小寫字母和少量數(shù)字組成
   Java 自己的包以 java. 和 javax 開頭，比如：java.awt
   別的組織開發(fā)的包以 組織的 Internet 域名部分開頭，比如：com.sun, com.borland

2.類，接口
   由一個(gè)或幾個(gè)單詞組成，每個(gè)單詞的第一個(gè)字母大寫，比如：StringBuffer
   類：一般用名詞和名詞詞組命名
   接口：與類相同，可以使用形容詞詞綴，比如 Runnable, Comparable

3.方法
   除第一個(gè)字母小寫外，和類，接口的命名規(guī)則一樣。比如：getPersonInfo()
   對(duì)于取屬性值和設(shè)置屬性值的方法：
     不管是否是 Bean，都要遵循 JavaBean 命名規(guī)范：getXXX(), setXXX()
   轉(zhuǎn)換對(duì)象類型返回不同類型的方法：
     命名成 toType，比如：toString(), toArray()
   返回視圖的方法：
     命名成 asType() 形式，asList()
   返回與調(diào)用此方法的對(duì)象（Wrapper Class）同值的原始類型的方法：
     命名成 typeValue() 形式，比如 intValue(), floatValue()
  
4.域（屬性）
   普通域：
     除第一個(gè)字母小寫外，和類，接口的命名規(guī)則一樣。比如：personInfo
   常數(shù)域：
     由一個(gè)或多個(gè)被下劃線分開的單詞組成，比如：VALUES, NEGATIVE_INTINITY
     常數(shù)域是唯一允許使用下劃線的情況。

5.局部變量
   命名與域相同，可以使用簡寫，比如：i, j, temp, maxNumber


參考：
   Code Conventions for the JavaTM Programming Language
   http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html
   《Java高效編程指南》

eclipse

這個(gè)編碼規(guī)范的中文版請(qǐng)點(diǎn)擊這兒