软件开发代码规范Java.docx
《软件开发代码规范Java.docx》由会员分享,可在线阅读,更多相关《软件开发代码规范Java.docx(13页珍藏版)》请在冰豆网上搜索。
软件开发代码规范Java
软件开发代码规范(C)
(仅通普信息技术股份有限公司供内部使用)
拟制:
杨超
日期:
2015-3-10
审核:
夏峰
日期:
2015-3-10
核准:
冯敬刚
日期:
2015-3-17
签发:
韩殿成
日期:
2015-3-21
文档版本:
V1.11
黑龙江通普信息技术股份有限公司
版本历史
日期
版本
说明
作者
第一章代码开发规范及其指南
一.1目的
定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加可读性,减少项目组中因为换人而带来的损失。
(这些规范并不是一定要绝对遵守,但是一定要让程序有良好的可读性)
一.2程序内命名规范
●Package的命名:
Package的名字应该都是由一个小写单词组成。
●Class的命名:
Class的名字必须由大写字母开头而其他字母都小写的单词组成
●Class变量的命名:
变量的名字必须用一个小写字母开头。
后面的单词用大写字母开头。
●StaticFinal变量的命名:
StaticFinal变量的名字应该都大写,并且指出完整含义。
●参数的命名:
参数的名字必须和变量的命名规范一致。
●数组的命名:
数组应该总是用下面的方式来命名:
byte[]buffer;而不是bytebuffer[];
●方法的参数:
使用有意义的参数命名,如果可能的话,使用和要赋值的字段一样的名字:
SetCounter(intsize){
this.size=size;
}
一.3文件命名规范
●文件名由英文单词组成,每个单词的首字母大写,不要超过4个单词,如ShipOrder.jsp。
●Java文件的文件名要与程序中的public类名相同。
●Servet文件要以Servlet做为结尾,如AddCompanyServlet.java
●业务处理组件JavaBean要以Bean为结尾,如ProcessBean.java
一.4Java文件样式
所有的Java(*.java)文件都必须遵守如下的样式规则
●头部
版权信息
版权信息必须在java文件的开头,比如:
/**
*Copyright2002SunMicrosystems,Inc.Allrightsreserved.
*/
其他不需要出现在javadoc的信息也可以包含在这里。
●Package/Imports
package行要在import行之前,import中标准的包名要在本地的包名之前,而且按照字母顺序排列。
如果import行中包含了同一个包中的不同子目录,则应该用*来处理。
package.stats;
importjava.io.*;
importjava.util.Observable;
importhotlava.util.Application;
这里java.io.*使用来代替InputStreamandOutputStream的。
●Class
接下来的是类的注释,一般是用来解释类的相关信息,包括标题、描述、。
/**
*
Title:
Example
*
Description:
AuditApplicationExample
*
Copyright:
Copyright(c)200x
*
Company:
xxxxx
*@authorxxxxxx
*@version1.0
*/
接下来是类定义,包含了在不同的行的extends和implements
publicclassCounterSetextendsObservableimplementsCloneable
●ClassFields
接下来是类的成员变量:
/**
*Packetcounters
*/
protectedint[]packets;
public的成员变量必须生成文档(JavaDoc)。
protected、private和package定义的成员变量如果名字含义明确的话,可以没有注释。
●存取方法
接下来是类变量的存取的方法。
它只是简单的用来将类的变量赋值获取值的话,可以简单的写在一行上。
/**
*Getthecounters
*@returnanarraycontainingthestatisticaldata.Thisarrayhasbeen
*freshlyallocatedandcanbemodifiedbythecaller.
*/
publicint[]getPackets(){returncopyArray(packets,offset);}
publicint[]getBytes(){returncopyArray(bytes,offset);}
publicint[]getPackets(){returnpackets;}
publicvoidsetPackets(int[]packets){this.packets=packets;}
其它的方法不要写在一行上
●构造函数
接下来是构造函数,它应该用递增的方式写(比如:
参数多的写在后面)。
访问类型("public","private"等.)和任何"static","final"或"synchronized"应该在一行中。
PublicCounterSet(intsize){
this.size=size;
}
●克隆方法
如果这个类是可以被克隆的,那么下一步就是clone方法:
publicObjectclone(){
try{
CounterSetobj=(CounterSet)super.clone();
obj.packets=(int[])packets.clone();
obj.size=size;
returnobj;
}catch(CloneNotSupportedExceptione){
thrownewInternalError("UnexpectedCloneNotSUpportedException:
"+e.getMessage());
}
}
●类方法
下面开始写类的方法:
/**
*Setthepacketcounters
*(suchaswhenrestoringfromadatabase)
*/
protectedfinal
voidsetArray(int[]r1,int[]r2,int[]r3,int[]r4)
throwsIllegalArgumentException
{
//
//Ensurethearraysareofequalsize
//
if(r1.length!
=r2.length||r1.length!
=r3.length||r1.length!
=r4.length)
thrownewIllegalArgumentException("Arraysmustbeofthesamesize");
System.arraycopy(r1,0,r3,0,r1.length);
System.arraycopy(r2,0,r4,0,r1.length);
}
●toString方法
无论如何,每一个类都应该定义toString方法:
public
StringtoString(){
Stringretval="CounterSet:
";
for(inti=0;iretval+=data.bytes.toString();
retval+=data.packets.toString();
}
returnretval;
}
}
●main方法
如果main(String[])方法已经定义了,那么它应该写在类的底部.
一.5代码编写格式
●代码样式
代码应该用unix的格式,而不是windows的(比如:
回车变成回车+换行)
●文档化
必须用javadoc来为类生成文档。
不仅因为它是标准,这也是被各种java编译器都认可的方法。
●缩进
缩进应该是每行4个空格.不要在源文件中保存Tab字符.在使用不同的源代码管理工具时Tab字符将因为用户设置的不同而扩展为不同的宽度.
如果你使用UltraEdit作为Java源代码编辑器的话,你可以通过如下操作来禁止保存Tab字符,方法是通过UltrEdit中先设定Tab使用的长度是4个空格,然后用Format|TabstoSpaces菜单将Tab转换为空格。
●页宽
页宽应该设置为80字符.源代码一般不会超过这个宽度,并导致无法完整显示,但这一设置也可以灵活调整.在任何情况下,超长的语句应该在一个逗号或者一个操作符后折行.一条语句折行后,应该比原来的语句再缩进2个字符.
●程序块
要有大括号,即使只有一句程序
{}中的语句应该单独作为一行.例如,下面的第1行是错误的,第2行是正确的:
if(i>0){i++};//错误,{和}在同一行
if(i>0){
i++
};//正确,{单独作为一行
}语句永远单独作为一行.
如果}语句应该缩进到与其相对应的{那一行相对齐的位置。
●括号
左括号和后一个字符之间不应该出现空格,同样,右括号和前一个字符之间也不应该出现空格.下面的例子说明括号和空格的错误及正确使用:
CallProc(AParameter);//错误
CallProc(AParameter);//正确
不要在语句中使用无意义的括号.括号只应该为达到某种目的而出现在源代码中。
下面的例子说明错误和正确的用法:
if((I)=42){//错误-括号毫无意义
if(I==42)or(J==42)then//正确-的确需要括号
●import
对于import语句,如果某一个包中引用的类不超过三个(包括三个),不允许用importxxx.*;格式。
●变量
定义及方法的返回值不允许使用全包名,如java.lang.String,除非在不同的包中有相同名字的类,必须用全名来区分。
对于类中属性的存取要用方法(getXXX/setXXX,boolean值用isXXX/setXXX),不要直接引用。
第二章程序编写规范方法
二.1权限修饰
Java中权限修饰符有三个:
public,private,protected,另外一种是不写这三种的任何一个,称为(default).
1)对于外部类,只能用public或(default),而且一个文件中最多只能有一个public类。
但是内部类这四种都可以使用。
2)如果对某些数据或方法只允许其所在类使用,用private修饰。
3)如果对某些数据或方法允许本类或同包类使用,用(default),即不写任何修饰符。
4)如果对某些数据或方法允许本类,同包类,或非同包子类使用,用protected.
如果对某些数据或方法允许任何类使用,用public修饰。
二.2其他规范
●exit()
exit除了在main中可以被调用外,其他的地方不应该调用。
因为这样做不给任何代码代码机会来截获退出。
一个类似后台服务的程序不应该因为某一个库模块决定了要退出就退出。
●异常
关键操作如涉及到数据库操作和多个关键处理步骤时应当采用try,catch语句,以便于捕获异常(各类Exception)和异常处理。
●垃圾收集
JAVA使用成熟的后台垃圾收集技术来代替引用计数。
但是这样会导致一个问题:
必须在使用完对象的实例以后进行清场工作。
除非输出流一出作用域就关闭,非引用计数的程序语言,比如JAVA,是不能自动完成变量的清场工作的。
必须象下面一样写:
FileOutputStreamfos=newFileOutputStream(projectFile);
project.save(fos,"IDEProjectFile");
fos.close();
●Clone
下面是一种有用的方法:
implementsCloneable
public
Objectclone()
{
try{
ThisClassobj=(ThisClass)super.clone();
obj.field1=(int[])field1.clone();
obj.field2=field2;
returnobj;
}catch(CloneNotSupportedExceptione){
thrownewInternalError("UnexpectedCloneNotSUpportedException:
"+e.getMessage());
}
}
●final类
绝对不要因为性能的原因将类定义为final的(除非程序的框架要求)
如果一个类还没有准备好被继承,最好在类文档中注明,而不要将她定义为final的。
这是因为没有人可以保证会不会由于什么原因需要继承她。
访问类的成员变量
大部分的类成员变量应该定义为protected的来防止继承类使用他们。
注意,要用"int[]packets",而不是"intpackets[]",后一种永远也不要用。
publicvoidsetPackets(int[]packets){this.packets=packets;}
CounterSet(intsize)
{
this.size=size;
}
二.3编程指南
1、byte数组转换到characters
为了将byte数组转换到characters,可以这么做:
"Helloworld!
".getBytes();
2、Utility类
Utility类(仅仅提供方法的类)应该被申明为抽象的来防止被继承或被初始化。
3、初始化
下面的代码是一种很好的初始化数组的方法:
objectArguments=newObject[]{arguments};
4、枚举类型
JAVA对枚举的支持不好,但是下面的代码是一种很有用的模板:
classColour{
publicstaticfinalColourBLACK=newColour(0,0,0);
publicstaticfinalColourRED=newColour(0xFF,0,0);
publicstaticfinalColourGREEN=newColour(0,0xFF,0);
publicstaticfinalColourBLUE=newColour(0,0,0xFF);
publicstaticfinalColourWHITE=newColour(0xFF,0xFF,0xFF);
}
这种技术实现了RED,GREEN,BLUE等可以象其他语言的枚举类型一样使用的常量。
他们可以用'=='操作符来比较。
但是这样使用有一个缺陷:
如果一个用户用这样的方法来创建颜色BLACK
newColour(0,0,0)
那么这就是另外一个对象,'=='操作符就会产生错误。
她的equal()方法仍然有效。
由于这个原因,这个技术的缺陷最好注明在文档中,或者只在自己的包中使用。
●性能
5、在写代码的时候,从头至尾都应该考虑性能问题,要注意代码的效率。
6、不必要的对象构造
7、不要在循环中构造和释放对象
8、使用StringBuffer对象
在处理String的时候要尽量使用StringBuffer类,StringBuffer类是构成String类的基础。
String类将StringBuffer类封装了起来,(以花费更多时间为代价)为开发人员提供了一个安全的接口。
当我们在构造字符串的时候,我们应该用StringBuffer来实现大部分的工作,当工作完成后将StringBuffer对象再转换为需要的String对象。
比如:
如果有一个字符串必须不断地在其后添加许多字符来完成构造,那么我们应该使用StringBuffer对象和她的append()方法。
如果我们用String对象代替StringBuffer对象的话,会花费许多不必要的创建和释放对象的CPU时间。
9、避免太多的使用synchronized关键字
避免不必要的使用关键字synchronized,应该在必要的时候再使用她,这是一个避免死锁的好方法。
10、可移植性
为了保证整个系统的可移植性,尽量避免使用synchronized关键字
11、PrintStream
PrintStream已经被不赞成(deprecated)使用,用PrintWrite来代替她。
第三章其他要求
●在controll层或该层之后关闭数据库连接,不能在页面里关闭
●不能用select*的查询语句
●数据的提取工作不在页面内完成
●若是中文参数值,尽量用post方式,不用url方式
●在将自己的代码提交到版本控制服务器之前一定要做好单元测试,不能提交含有单元测试就应该解决的bug的代码
●异常处理要得当,不允许任何异常都是Exception,要尽量处理可以预料到的异常。
●在使用了jdbc的事务时,处理结束后,一定要将事务提交
如:
Cmit();
如果中间出现了异常,要将事务回滚后再关闭连接。