Java 程式碼慣例 -- 第六章 宣告

6. 宣告


6.1 每一行的數目

建議每一行一個宣告，因為他可以支援註解。換句話說，

int level; // 縮排層級
int size; // 表格大小

比下列好

int level, size;

不要將不同的型態放在同一行，例如：

int foo, fooarray[]; //錯誤

注意：上面的範例在型態和變數名稱之間使用一個空白。另一個可以接受的
替代方法是用 Tabs，例如：

int level; // 縮排層級
int size; // 表格大小
Object currentEntry; // 目前選擇的表格項目



6.2 初始化
12
試著在區域變數宣告的地方初始化它們。唯一不在他們宣告的地方初始化它
們的理由是初始值要先根據某些計算才能獲得。



6.3 佈置

只將宣告放在區塊開始的地方。(區塊是被大括號 "{" 和 "}" 圍起來的任何程
式碼。)不要等到它們第一次被使用時才宣告變數，這可能會困擾不夠小心的程
式設計師並阻礙程式碼在這個視野中的移植性。

void myMethod() {
int int1 = 0; // 方法區塊的起始位置

if (條件) {
int int2 = 0; // "if" 區塊的起始位置
...
}
}

這個規則的例外是 for 迴圈的索引值，Java 可以在 for 的敘述中宣告：

for ( int i = 0; i < maxLoops; i++) { ... }

避免將宣告藏在高層級的區域宣告。例如，不要在一個內部區塊中宣告同名
的變數名稱：

int count;
...
myMethod() {
if (條件) {
int count; // 避免
...
}
...
}



6.4 類別和介面宣告

當寫 Java 類別和介面程式碼時，應該遵循下列格式規則：
* 不要在方法名稱和它的引數起始的小括號"("之間使用空白
* 左大括號 "{" 放在宣告敘述同一行的末端
* 右大括號 "}" 自己放在一行，縮排到符合他的左括號敘述的位置，
除了空敘述的 "}" 應該緊接著 "{" 之後出現之外。

class Sample extends Object {
int ivar1;
int ivar2;

Sample(int i, int j) {
ivar1 = i;
ivar2 = j;
}

int emptyMethod() {}
...
}

* 方法以一行空白行隔開