kooyee ‘s blog

1.10  方法、變量與常量的命名規則

關于包、類及接口的命名規則，在上面的章節中已經講解過，在此就不再贅述了，本節講解在Java程序設計中，有關方法、變量與常量的命名規則相關的知識。

1.10.1  方法的命名規則

方法一般來說都是動詞，第一個字母應該小寫，在多個單詞混合的情況下，第一個單詞后的所有單詞的第一個字母大寫，其余字母小寫，例如下面的代碼：

     run();   

runFast();

getBackground();

在方法的聲明部分，通常要提供對方法功能的描述，以及方法中返回值與參數的說明，例如下面的代碼：

/**

 * 顯示系統信息方法

 * @param message 系統信息參數

 * @return message 返回系統信息

 */

 public String showMessage (String message) {

         …

                  // statements;

         …

         return message;

 }

如果該方法在軟件產品的不斷升級中已經不被建議使用了，可以通過在方法聲明注釋部分添加關鍵字@deprecated實現。

1.10.2  變量的命名規則

變量的命名規則是，除了變量（variable），所有對象的實例（instance），類（class）與類的常量（constant）的第一個字母應該小寫，在多個單詞混合的情況下第一個單詞后的所有單詞的第一個字母大寫，其余字母小寫的規則之外。變量的第一個字母即使系統允許，也不要為_或者$。變量名字因該緊湊而有意義。變量的名字應該是易記憶、易于理解的，即使間隔較長的時間也可以依其名而知其意。另外單字符的變量名應該盡量避免，除非臨時變量，例如，一些整數單字符臨時變量：i,j,k,m,n等以及單字符變量：c,d,e等，如下所示的代碼：

int  i;

char  c;

float imageWidth;

1.10.3  常量的命名規則

Java中的常量一般采用大寫字母單詞命名，單詞與單詞之間用下劃線（_）加以分割，這符合ANSI的常量命名規則，如下所示的代碼：

static final int MIN_WIDTH = 14;

static final int MAX_WIDTH = 1000;

static final int GET_THE_MEMORY = 128;

上面討論了Java語言中的代碼編寫風格及相關格式與書寫規則，下面做一個簡單Java程序設計的實踐，從中掌握所學過的知識。