1. 程式人生 > >java進階(一)------java程式設計規範---命名約定

java進階(一)------java程式設計規範---命名約定

 除了部分傳統用法的命名例如 sin,cos等,建議在java語言編寫的所有程式中使用這些約定。

包的名稱

為了使包的名稱廣泛可用,它的第一個識別符號包含兩個或三個小寫字母,它們指定了一個Internet域,如com、edu、gov、mil、net、org;或者是兩個字母的ISO國家程式碼,如uk或jp。

例子:

com.JavaSoft.jag.Oak

org.npr.pledge.driver

uk.ac.city.rugby.game

僅打算供本地使用的包的名稱應該具有以小寫祖母開頭的第一個識別符號,但是第一個不能用java(sun公司保留)。 

類和介面型別名稱

類和介面的名稱應該是說明性的名詞或者名詞短語,名稱不要過長,大寫每個單詞的首字母。

例子:

ClassLoader

SecurityManager

Thread

型別變數名稱

型別變數名稱應該簡練(如果可能的話,使用單個字元),並且不應該包括小寫字母。

例如:

public class HashSet<E> extends AbstractSet<E> {..} //E為容器型別

public class HashMap<K,V> extends AbstractMap<K,V>{...} //K為key,V為value

public class ThreadLocal<T> (...) //T為泛型

ps:不屬於以上型別時 不建議使用同名稱呼

方法名稱

方法名稱應該是動詞或者動詞短語,首字母小寫,任何後續單詞的首字母大寫。

例如:

getPriority()

setPriority()

欄位名稱

不是final的欄位名稱應該是名詞、名詞短語或者名詞的簡寫,首字母小寫,任何後續單詞的首字母大寫。

良好設計的類極少有public或者protected欄位。

常量名稱

應該是一個或多個單詞、縮寫詞或簡寫詞的序列,全大寫,各個成分之間用下劃線“_”字元隔開。

final變數也可採用這種命名方式。

例如:

MIN_VALUE

MAX_VALUE

區域性變數

區域性變數和引數應該比較短,但有意義。它們通常是小寫字母的較短序列(而不是單詞)。

例如:

1.單詞的首字母縮寫詞,如cp,用於儲存指向ColoredPoint的引用的變數。

2.簡寫詞,如buf,用於儲存指向某種buffer的指標

3.助記詞,in和out表示輸入 輸出,off和len表示偏移量和長度

4.約定單字元名稱:

b,用於byte

c,用於char

d,用於double

e,用於Exception

f,用於float

i、j和k,用於整數

l,用於long

o,用於Object

s,用於String

v,用於某種型別的任意值