成都思迈信通科技有限公司 Java 编码规范(版本 1)
我们可以按照某些工具来自动缩进排版,如:JBuilder,Eclipse 等。
4.1 行长度
尽量避免一行的长度超过 80 个字符,最多 120 个字符,因为很多终端和工具不能很
好处理之。
注意:用于文档中的例子应该使用更短的行长,长度一般不超过 70 个字符。
如果使用 JBuilder 可以注意不要超过右边的灰色竖线,如果超过 JBuilder 在
Formate 的时候会打乱你的排版,使得程序不好阅读。灰色竖线的对应行的长度也就是
80 个字符。
4.2 换行
当一个表达式无法容纳在一行内时,可以依据如下一般规则断开之:
在一个逗号后面断开
在一个操作符前面断开
宁可选择较高级别(higher-level)的断开,而非较低级别(lower-level)的断开
新的一行应该与上一行同一级别表达式的开头处对齐
如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边,那就代之以缩进
8 个空格。
以下是断开方法调用的一些例子:
someMethod(longExpression1,longExpression2,longExpression3,
longExpression4,longExpression5);
var=someMethod1(longExpression1,
someMethod2(longExpression2,
longExpression3));
以下是两个断开算术表达式的例子。前者更好,因为断开处位于括号表达式的外边,
这是个较高级别的断开。
longName1=longName2*(longName3+longName4-longName5)
+4*longname6;//较好
longName1=longName2*(longName3+longName4
-longName5)+4*longname6;//避免
以下是两个缩进方法声明的例子。前者是常规情形。后者若使用常规的缩进方式将会使
第二行和第三行移得很靠右,所以代之以缩进 8 个空格
//通常的排版方式
someMethod(int anArg,Object anotherArg,String yetAnotherArg,
Object andStillAnother){
...
}
第 4 页 共 19 页