软件编程规范J A V A Document number【SA80SAB-SAA9SYT-SAATC-SA6UT-SA18】
1
范围
本标准规定了Java 语言的编程规范,主要包括基本原则、文件结构、注释、命名规则、声明、表达式与语句、类和接口等。
本标准适用于使用Java 语言编码的所有软件。
2
术语和定义
下列术语和定义适用于本标准。
2.1 原则
编程时应该坚持的指导思想。
2.2 规则
编程时必须遵守的约定。
2.3 建议
编程时必须加以考虑的约定。
2.4 说明
对此规则或建议的必要的解释。
2.5 正例
对此规则或建议给出的正确例子。
2.6 反例
对此规则或建议给出的反面例子。
3
基本原则
说明:
简单是最美。保持代码的简单化是软件工程化的基本要求。不要过分追求技巧,否则会降低程序的可读性。
说明:
编程首先考虑的是满足正确性、健壮性、可维护性、可移植性等质量因素,其次考虑程序的效率和资源占用。
说明:尽量选择可借用的代码,对其修改优化以达到自身要求。
说明:
事实上,我们无法做到完全消除错误,但通过不懈的努力,可以减少同样的错误出现的次数。
4文件结构
程序布局的目的是显示出程序良好的逻辑结构,提高程序的准确性、连续性、可读性、可维护性。更重要的是,统一的程序布局和编程风格,有助于提高整个项目的开发质量,提高开发效率,降低开发成本。同时,对于普通程序员来说,养成良好的编程习惯有助于提高自己的编程水平,提高编程效率。因此,统一的、良好的程序布局和编程风格不仅仅是个人主观美学上的或是形式上的问题,而且涉及到产品质量,涉及到个人编程能力的提高,必须引起大家重视。
4.1基本格式
正例:
package .**; (ati是自动化技术研究所的简写,不一定恰当)
import .*;
/**
*
文件名称: 题目名称
*
文件描述: 本类描述
*
版权所有: 版权所有(C)2001-2004
*
公司: 大连理工大学自动化研究所
*
内容摘要:
4.2
5
m yMethod()
{
if (condition)
{
count = 1;
}
}
正例:
class Test
{
public String name;
public Test()
{
…;
}
public void setName(String name)
{
…;
}
private void method()
{
…
}
}
说明:如接口中关系较紧密的的几个方法,类属性的get 和set 方法,有调用关系的方
法,重载的方法等有相近或相关的方法尽可能放在一起,方便阅读。
正例:
class Sample extends Object {
int ivar1; int ivar2; String name;
Sample(int i, int j) {
ivar1 = i; ivar2 = j; }
public void setName(String name) {
= name; }
public String getName() {
return ; }
int method1 () {
…
method2(); }
void method2() {
… }
}
说明:过多的函数参数会导致性能降低。