Java: 命名的講究

1、類名
類名通常以名詞結(jié)尾。而且在類名中要體現(xiàn)它是以保存數(shù)據(jù)為主還是提供功能為主。例如 ConnectionBuilder 這個類我們都可以猜到它的主要功能是創(chuàng)建 Connection 對象，

以動詞-er/or 結(jié)尾的類名，至少應(yīng)該包含一個以該動詞開頭的方法。例如 ConnectionBuilder 這個類，它至少應(yīng)該包含一個以 build- 開頭的方法。有了這種默契，別人就能更方便的使用這個類。

2、增刪改查方法的命名
以對 Person 類的增刪改查為例——
創(chuàng)建一個 Person對象的方法一般命名為 createPerson()/newPerson()，
添加方法命名為 addPerson()，修改方法命名為 updatePerson()，
刪除方法命名為 deletePerson()/removePerson()，
根據(jù)主鍵查詢的方法命名為 getPerson()/queryPerson()。
根據(jù)其他條件來查詢，要指出具體的條件類型，例如 getPersonByName() 或 getPersonByAge()。

方法的名稱要統(tǒng)一。例如一開始用的是 deleteXXX 而不是 removeXXX，那么整個項目都應(yīng)該這樣用下去。

3、計數(shù)方法
計數(shù)方法通常命名為 getNumberOfXXX()/getXXXCount()。例如 getNumberOfRows()，getQuestionCount()。

4、返回 boolean 值的方法
在 JavaBean 中，返回 boolean 屬性必須用 isXXX() 命名。

檢查某個屬性是否為空或者某條記錄是否存在的方法，通常命名為 hasXXX()，例如 hasResult()。

檢查對象狀態(tài)的方法通常以 is+形容詞 命名。例如 isClosed()，isReady()

5、返回集合對象的方法
返回集合對象的方法應(yīng)該體現(xiàn)出復(fù)數(shù)形式，例如 getPersons()，也可以體現(xiàn)容器類型，例如 getPersonList()。

6、不要簡化單詞
不要寫 getHisList()，而要寫 getHistoryList()；不要寫 usrno，而要寫 userNumber。一個簡單的原則是要能夠把這個名字讀出來。

7、參數(shù)命名應(yīng)該精確
createUser(String str1, String str2) 看起來很難懂，但要是寫成 createUser(String userName, String password) 就很好懂了。

8、返回值命名為 result
在一個方法中將返回值命名為 result，能夠讓方法的脈絡(luò)更清晰。

9、接口
接口命名沒有什么專門的原則，和類名一樣要能夠準(zhǔn)確體現(xiàn)接口的功能。
 
有人喜歡在接口名字前面加 I。完全可以。不管加不加，都要保證整個項目的統(tǒng)一性。

Java: 變量的值和引用
廣義的說，在 Java 中，凡是可以指向一個對象或包含一個值的標(biāo)識符，都可以稱為變量。

變量的內(nèi)容，有可能是一個值，也有可能是指向一個對象的引用。

當(dāng)變量的類型為基本型別（short, byte, int, long, float, double, boolean, char）時，變量的內(nèi)容是一個值；當(dāng)變量的類型為 Object 及其子類時，變量的內(nèi)容是指向一個對象的引用。例如：

int a = 3; 
String s1 = "Hello!"; 
String s2 = s1; 

這時變量 a 的內(nèi)容就是 3，變量 s1 的內(nèi)容就是指向一個字符串對象的引用，s2 則和 s1 一樣指向該對象。如果執(zhí)行了下面的語句：

a = 4; 
s1 = "Hello again!"; 

這時變量 a 的內(nèi)容被改成了 4，s1 的內(nèi)容改成了指向另一個字符串對象（"Hello again!"）的引用。s2 則還是指向原先的那個字符串（"Hello!"）。

接下來談方法的調(diào)用。方法的調(diào)用是傳值的。例如下面這個方法：

void f(int i, String s) { 
  i = 100;   // i 的值改成了 100 
  s = "Hi!";  // s 現(xiàn)在指向字符串 "Hi!" 
} 

當(dāng)調(diào)用 f(a, s1) 時，變量 a 和 s1 的值被賦給參數(shù) i 和 s，然后才執(zhí)行 f 方法。也就是說，無論 i 和 s 怎么變，都不會影響 a 和 s1 的值。

接下來是一個稍微復(fù)雜的例子。首先定義一個方法：

void f(int i, List list) { 
  i = 10; 
  list.add("Hello!"); 
} 

假設(shè)再執(zhí)行下面的句子：

int a = 3; 
List l = new ArrayList(); 
f(a, l); 

那么執(zhí)行之后是什么結(jié)果呢？
i 和 a 是兩個不同的變量，i 的值變了不會影響 a，所以 a 的值還是 3；
list 和 l 是兩個不同的變量，但它們指向同一個 List 對象。f 的執(zhí)行過程中給這個 List 對象添加了一個元素，那么執(zhí)行完之后，通過 l 變量我們可以取到這個元素：

l.get(0); // "Hello!" 

但如果 f 這樣寫：

void f(int i, List list) { 
  i = 10; 
  list = new ArrayList(); 
  list.add("Hello!"); 
} 

那么 list 首先引用到另一個 List 對象去了，改變的是另一個 List 對象的內(nèi)容，所以變量 l 指向的 List 對象沒有改變，l.size() 仍然是 0。

像這樣的概念，初學(xué)者可能容易混淆；但只要多練習(xí)，很快就能熟悉了。

最新評論