Java语言编码规范（2）

核心提示：6.3 布局(Placement)只在代码块的开始处声明变量，（一个块是指任何被包含在大括号"{"和"}"中间的代码，Java语言编码规范（2），）不要在首次用到该变量时才声明之，这会把注重力不集中的程序员搞糊涂，if else-if else语句(if, if-else, if

　　6.3 布局(Placement)

只在代码块的开始处声明变量。（一个块是指任何被包含在大括号"{"和"}"中间的代码。）不要在首次用到该变量时才声明之。这会把注重力不集中的程序员搞糊涂，同时会妨碍代码在该作用域内的可移植性。


void myMethod() {
int int1 = 0; // beginning of method block

if (condition) {
int int2 = 0; // beginning of "if" block
...
}
}


该规则的一个例外是for循环的索引变量


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


避免声明的局部变量覆盖上一级声明的变量。例如，不要在内部代码块中声明相同的变量名：


int count;
...
myMethod() {
if (condition) {
int count = 0; // AVOID!
...
}
...
}


6.4 类和接口的声明(Class and Interface Declarations)

当编写类和接口是，应该遵守以下格式规则：

- 在方法名与其参数列表之前的左括号"("间不要有空格
- 左大括号"{"位于声明语句同行的末尾
- 右大括号"}"另起一行，与相应的声明语句对齐，除非是一个空语句，"}"应紧跟在"{"之后

class Sample extends Object {
int ivar1;
int ivar2;

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

int emptyMethod() {}

...
}

- 方法与方法之间以空行分隔

7 语句(Statements)

7.1 简单语句(Simple Statements)

每行至多包含一条语句，例如：


argv++; // Correct
argc--; // Correct
argv++; argc--; // AVOID!


7.2 复合语句(Compound Statements)

复合语句是包含在大括号中的语句序列，形如"{ 语句 }"。例如下面各段。

- 被括其中的语句应该较之复合语句缩进一个层次
- 左大括号"{"应位于复合语句起始行的行尾；右大括号"}"应另起一行并与复合语句首行对齐。
- 大括号可以被用于所有语句，包括单个语句，只要这些语句是诸如if-else或for控制结构的一部分。这样便于添加语句而无需担心由于忘了加括号而引入bug。

7.3 返回语句(return Statements)

一个带返回值的return语句不使用小括号"()"，除非它们以某种方式使返回值更为显见。例如：


return;

return myDisk.size();

return (size ? size : defaultSize);


7.4 if，if-else，if else-if else语句(if, if-else, if else-if else Statements)

if-else语句应该具有如下格式：


if (condition) {
statements;
}

if (condition) {
statements;
} else {
statements;
}

if (condition) {
statements;
} else if (condition) {
statements;
} else{
statements;
}


注重：if语句总是用"{"和"}"括起来，避免使用如下轻易引起错误的格式：


if (condition) //AVOID! THIS OM99vS THE BRACES {}!
statement;


7.5 for语句(for Statements)

一个for语句应该具有如下格式：


for (initialization; condition; update) {
statements;
}


一个空的for语句(所有工作都在初始化，条件判定，更新子句中完成）应该具有如下格式：