java组件开发规范_JAVA 代码开发规范

this.size = size;

}

7. 方法内变量的命名

Class 中成员变量的命名。

8. 数组的命名

数组应该总是用下面的方式来命名: byte[] buffer;而不是: byte buffer[];

9. 分页中每页列表数量的变量使用 pageSize，当前的所在的页号为 pageNumber。

四.注释规范:

1. 注释要简单明了。

2. 边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。

3. 在必要的地方注释，注释量要适中。注释的内容要清楚、明了，含义准确，防止注释二

义性。保持注释与其描述的代码相邻，即注释的就近原则。

4. 变量、常量的注释应放在其上方相邻位置或右方，不可放在下面。

5. 全局变量要有较详细的注释，包括对其功能、取值范围、哪些函数或过程存取它以及存

取时注意事项等的说明。

6. 类，方法的注释采用 eclipse 自动生成方法。

当把一个类，或方法的声明写完整后，在类，方法的正上方(不许有空格)在英文输入

法状态下输入:/** 后，系统会自动生成他们的注释模板，我们只需要填写相应的说明文字

即可，注意:/**的下一行一定要写功能说明。

7. 具体要求说明:

n 声明性(变量定义类)一定要有注释。例如:String myName; //用户名

n 类定义必须生成文档(JavaDoc)注释。

n 方法必须生成文档(JavaDoc)注释(包括实体类的set，get方法)。

n 成员变量必须生成文档(JavaDoc)注释。

n 方法中的逻辑部分由程序编写人根据复杂情况自行书写。

8. 类定义的注释信息，包括:作者;日期;模块功能描述(如功能、主要算法、内部各部

分之间的关系、该文件与其它文件关系等);本文件历史修改记录;版本信息等。

/**

* 干什么用的(描述信息)