读书笔记 (2005.10.10)
1.阅读CodeConventions(SUN)
主要有如下收获:
1. 空行与空格的用法:
l 类之间用两行空行隔开
l 源代码中的片段也用两行隔开
l 方法之间用一行隔开
l 方法内的局部变量声明与第一条语句之间用一行隔开
l 块注释和单行注释之前用一行隔开
l 方法内的逻辑段用一行隔开
l 关键字与括号用空格隔开,注意方法与其参数括号之间不加
l 二元运算符两边均加上空格,一元的不加
l 强制转型的括号后加空格
l For语句中的表达式应用空格隔开
2. 缩排风格确定
l 阶层缩进以四个空格,不用tab
l 一般断行按照传统断行的规则,如果函数名太长或者前面修饰符太多,则以8个空格缩进,注意不用四个空格。
3. 语句风格
l if语句总是用"{"和"}"括起来
l 当在for语句的初始化或更新子句中使用逗号时,避免因使用三个以上变量,而导致复杂度提高。若需要,可以在for循环之前(为初始化子句)或for循环末尾(为更新子句)使用单独的语句。
l 每当一个case顺着往下执行时(因为没有break语句),通常应在break语句的位置添加注释。上面的示例代码中就包含注释/* falls through */。
l return 语句一般直接跟上所返回的对象,除非有利于阅读,一般不用括号
4. 编程惯例
l 位于for循环中作为计数器值的数字常量,除了-1,0和1之外,不应被直接写入代码