java代码块流行风格 java代码块的用处( 十 )


public void aMethod(type parameter1, type parameter2,... ,
type parametern, type parameter n+1,... ,
type parameterm, type parameter m+1) {}
另外要注意类的左束括号应在方法的右束括号之后而非下一行:
public int aMethod() {
int i = 0;
if(i == 0)
System.out.println("success!");
}
为了文件可读性好,还要注意语句最好写在同一行 , 当然一行写不下是可以断行的 , 比如行字母超过80 。
fields
比如变量,如果不希望它永久有效,应设为private 。如果一个变量在类中不发生任何动作(比如数据结构中的node)则可以设置为public,常量一般声明为public 。如果不能确定一个变量到底该声明为什么,应暂且声明为private 。
field的名字一般使用小写字母,不要使用下横线或其他特殊字符 。如果变量包含两个字,那么第二个字的首字母大写 。比如:
int i, j, k;
Date date;
double myField;
常量一般全部大写,也可以包含下横线:
public static final int MAX_SIZE_OF_DATABASE
fields的名字通常为名词 。较重要的fields更应具备描述性,比如程序中包含一个游戏的得分 , 那可以用score来代表 。如果变量变化较频繁,那使用一个单一字符来代表就ok了:
i, j, k 通常代表整数
r, t, u, v, w 通常代表实数
x, y, z 通常是并列出现或代表浮点数
s, s1, s2, 通常代表字符串
c, ch 通常代表字符
f, file 通常代表文件
tmp, temp 通常代表临时变量
ctr, cnt, cntr 一般代表计数器(如果i, j, k这些变量已被使用)
dummy, foo, bar 一般代表哑元变量
args 是main-method的主参数名
缩排与换行
每行长度不得超过80字符 。如果需要可以折行时,也应当与上一行有共同的缩排距离 。代码应如何交错、如何建立新行、在哪里建立允许、哪里不允许都有一些一般约定,缩排空格一般为2个或4个空格 。
条件表达式
如果见到如下语法表达式:
if (expr)
statement1;
else
statement2;
代码行向右错排两个空格如上所示 。
如果在一个表达式中有超过一条的声明 , 则需要大括号:
if (expr){
statement1;
statement2;
} else{
statement3;
statement4;
}
有时我们会希望在表达式中使用表达式(比如条件嵌套) , 这时应注意else表达式,它的位置很容易出错!如例:
if (expr1) {
statement1;
statement2;
} else if (expr2)
statement3;
else if (expr3) {
statement4;
statement5;
} else {
statement6;
statement7;
}
注意大括号位置!
Loops
while-loop语法如下:
while (expr) {
statement1;
statement2;
}
for-loop语法如下:
for (expr1; expr2; expr3){
statement1;
statement2;
}
注意大括号位置!仅一条声明时大括号省略:
while (expr)
statement;
for (expr1; expr2; expr3)
statement;
例如,我们写一个procedure写出1到10这十个数字:
for (i = 1; i = 10; i++)
System.out.println(i);
try-catch语法形如:
try {
statements;
} catch (ExceptionClass e) {
statements;
}
如果try-catch语句后跟随finally子句则形如:
try {
statements;
} catch (ExceptionClass e) {
statements;
} finally {
statements;
}
新行
每一行最好只阐述一件事情 。比如,一行包含一个声明、一个条件语句、一个循环等 。不论多小 , 最好不要一行办两件事及以上 。例如不要把一个if表达式或循环语句的主体放置在同一行,这样的表达式断行的易读性会更高 。通常,互相协作的代码应放在一起,为保证代码美观可读 , 我们应将代码的不同代码段放置在不同的段落 。不过要牢记断行不要太过分!比如: