转载

《JAVA代码规范》(五)通用代码格式 - 声明(2.8)

2.8       声明

2.8.1        每行声明变量的数量

推荐一行一个声明,因为这样以利于写注释。亦即,

  int level;  // indentation level

  int size;   // size of table

        

要优于,

int level, size;

不要将不同类型变量的声明放在同一行,例如:

  int foo,  fooarray[];   //避免!

        

注意:上面的例子中,在类型和标识符之间放了一个空格

2.8.2        初始化

在声明局部变量的同时初始化。唯一不这么做的理由是变量的初始值依赖于某些先前发生的计算。

2.8.3        布局

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

  void myMethod() {

      int int1 = 0;         // 在方法的开始处

 

      if (condition) {

          int int2 = 0;     //”if ”块的开始处

          ...

      }

  }

      

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

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

      

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

  int count;

  ...

  myMethod() {

      if (condition) {

          int count = 0;     // 避免!

          ...

      }

      ...

  }

        

2.8.4        类和接口的声明

当编写类和接口时,应该遵守以下格式规则:

Ø        在方法名与其参数列表之前的左括号"("间不要有空格。

Ø        左大括号"{"位于声明语句同行的末尾。

Ø        右大括号"}"另起一行,与相应的声明语句对齐,除非是一个空语句,"}"应紧跟在"{"之后

 

  class Sample extends Object {

      int ivar1;

      int ivar2;

 

      Sample(int i, int j) {

          ivar1 = i;

          ivar2 = j;

      }

 

      int emptyMethod() {}

 

      ...

  }    


版权:《JAVA代码规范》是我以前在学校跟同学、老师一起编写的,参考了一些网上资料,有少部分内容可能会有相同。本文仅在ajava.org发布,各位转载必须注明出处。-苦力工
正文到此结束
Loading...