JAVA编程规范.docx
- 文档编号:26305105
- 上传时间:2023-06-17
- 格式:DOCX
- 页数:25
- 大小:31.86KB
JAVA编程规范.docx
《JAVA编程规范.docx》由会员分享,可在线阅读,更多相关《JAVA编程规范.docx(25页珍藏版)》请在冰豆网上搜索。
JAVA编程规范
汇丰智力产业组织
Java开发规范
目录
汇丰智力产业组织1
Java开发规范1
1.1排版3
1.1.1规则3
1.1.2建议4
1.2注释5
1.2.1规则5
1.2.2建议7
1.3命名8
1.3.1规则8
1.3.2建议9
1.4编码10
1.4.1规则10
1.4.2建议14
1.5性能与可靠性16
1.5.1规则16
1.5.2建议17
1.1排版
1.1.1规则
规则1程序块要采用缩进风格编写,缩进的空格数为4个,不允许使用TAB缩进。
说明:
缩进使程序更易阅读,使用空格缩进可以适应不同操作系统与不同开发工具。
规则2分界符(如大括号‘{’和‘}’)应各独占一行,同时与引用它们的语句左对齐。
在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序或者static、,synchronized等语句块中都要采用如上的缩进方式。
示例:
if(a>b)
{
doStart();
}
规则3较长的语句、表达式或参数(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。
示例:
if(logger.isDebugEnabled())
{
logger.debug("Sessiondestroyed,call-id"
+event.getSession().getCallId());
}
规则4不允许把多个短语句写在一行中,即一行只写一条语句
说明:
阅读代码更加清晰
示例:
如下例子不符合规范。
Objecto=newObject();Objectb=null;
规则5if,for,do,while,case,switch,default等语句自占一行,且if,for,do,while,switch等语句的执行语句无论多少都要加括号{},case的执行语句中如果定义变量必须加括号{}。
说明:
阅读代码更加清晰,减少错误产生
示例:
if(a>b)
{
doStart();
}
casex:
{
inti=9;
}
规则6相对独立的程序块之间、变量说明之后必须加空行。
说明:
阅读代码更加清晰
示例:
if(a>b)
{
doStart();
}
//此处是空行
return;
规则7在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如.),后不应加空格。
说明:
阅读代码更加清晰
示例:
if(a==b)
{
objectA.doStart();
}
a*=2;
1.1.2建议
建议1类属性和类方法不要交叉放置,不同存取范围的属性或者方法也尽量不要交叉放置。
格式:
类定义
{
类的公有属性定义
类的保护属性定义
类的私有属性定义
类的公有方法定义
类的保护方法定义
类的私有方法定义
}
建议2修饰词按照指定顺序书写:
[访问权限][static][final]。
示例:
publicstaticfinalStringstr=“abc”;
1.2注释
1.2.1规则
规则8每个方法和定义内部都需要加注释代码。
说明:
由于每个文件的代码注释情况都不一样,建议以一个系统内部模块作为单位进行检查
规则9类和接口的注释放在class或者interface关键字之前,import关键字之后。
注释主要是一句话功能简述与功能详细描述。
类注释使用“/***/”注释方式
说明:
方便JavaDoc收集,没有import可放在package之后。
注释可根据需要列出:
作者、内容、功能、与其它类的关系等。
功能详细描述部分说明该类或者接口的功能、作用、使用方法和注意事项,每次修改后增加作者和更新版本号和日期
/**
*<功能模块名称>
*<功能模块简单描述>
*${tags}
*@author:
${user}
*@date:
${date}
*@version:
1.0
*/
示例:
packagem;
importjava.util.*;
/**
*LogManager类集中控制对日志读写的操作。
*全部为静态变量和静态方法,对外提供统一接口。
分配对应日志类型的读写器,
*读取或写入符合条件的日志纪录。
*@author张三,李四,王五
*@dateLogIteraotor
*@versionBasicLog
*/
publicclassLogManager
规则10类属性(成员变量)、公有和保护方法注释:
写在类属性、公有和保护方法上面,注释方式为“/***/”.
示例:
/**
*注释内容
*/
privateStringlogType;
/**
*注释内容
*/
publicvoidwrite()
规则11注释应与其描述的代码相近,对代码的注释应放在其上方,并与其上面的代码用空行隔开,注释与所描述内容进行同样的缩排。
说明:
可使程序排版整齐,并方便注释的阅读与理解。
示例:
/*
*注释
*/
publicvoidexample2()
{
//注释
CodeBlockOne
//注释
CodeBlockTwo
}
/*
*注释
*/
publicvoidexample()
{
//注释
CodeBlockOne
//注释
CodeBlockTwo
}
规则12对于switch语句下的case语句,必须在每个case分支结束前加上break语句。
说明:
break才能真正表示该switch执行结束,不然可能会进入该case以后的分支。
至于语法上合法的场景“一个case后进入下一个case处理”,应该在编码设计上就避免。
规则13修改代码同时修改相应的注释,以保证注释与代码的一致性。
不再有用的注释要删除。
规则14注释的内容要清楚、明了,含义准确,防止注释二义性。
说明:
错误的注释不但无益反而有害。
规则15避免在注释中使用缩写,特别是不常用缩写。
说明:
在使用缩写时或之前,应对缩写进行必要的说明。
1.2.2建议
建议3避免在一行代码或表达式的中间插入注释。
说明:
除非必要,不应在代码或表达中间插入注释,否则容易使代码可理解性变差。
建议4在代码的功能、意图层次上进行注释,提供有用、额外的信息。
说明:
注释的目的是解释代码的目的、功能和采用的方法,提供代码以外的信息,帮助读者理解代码,防止没必要的重复注释信息。
示例:
如下注释意义不大。
//如果receiveFlag为真
if(receiveFlag)
而如下的注释则给出了额外有用的信息。
//如果从连结收到消息
if(receiveFlag)
建议5对关键变量的定义和分支语句(条件分支、循环语句等)必须编写注释。
说明:
这些语句往往是程序实现某一特定功能的关键,对于维护人员来说,良好的注释帮助更好的理解程序,有时甚至优于看设计文档。
建议6注释应考虑程序易读及外观排版的因素,使用的语言若是中、英兼有的,建议多使用中文,除非能用非常流利准确的英文表达。
中文注释中需使用中文标点。
方法和类描述的第一句话尽量使用简洁明了的话概括一下功能,然后加以句号。
接下来的部分可以详细描述。
说明:
注释语言不统一,影响程序易读性和外观排版,出于对维护人员的考虑,建议使用中文。
JavaDoc工具收集简介的时候使用选取第一句话。
建议7方法内的单行注释使用//。
说明:
调试程序的时候可以方便的使用/*。
。
。
*/注释掉一长段程序。
建议8一些复杂的代码需要说明。
示例:
这里主要是对闰年算法的说明。
//1.如果能被4整除,是闰年;
//2.如果能被100整除,不是闰年;
//3.如果能被400整除,是闰年。
建议9使用Html标签使JavaDoc生成更加美观。
示例:
/**
*Returnsahashcodeforthisstring.Thehashcodefora
*String
objectiscomputedas
*
*s[0]*31^(n-1)+s[1]*31^(n-2)+...+s[n-1]
*
*usingint
arithmetic,wheres[i]
isthe
*ithcharacterofthestring,n
isthelength*of
*thestring,and^
indicatesexponentiation.
*(Thehashvalueoftheemptystringiszero.)
*
*@returnahashcodevalueforthisobject.
*/
publicinthashCode()
生成后的JavaDoc
图1生成后的JavaDoc
1.3命名
1.3.1规则
命名规则采用驼峰命名方式。
规则16类名和接口使用类意义完整的英文描述,每个英文单词的首字母使用大写、其余字母使用小写的大小写混合法。
示例:
TCustomerCareerHifoDao,CollectionBaseinfoDaoImpl
规则17方法名使用类意义完整的英文描述:
第一个单词的字母使用小写、剩余单词首字母大写其余字母小写的大小写混合法。
示例:
privatevoidsaveTCustomerSocResHifo();
publicvoidgetCustomerTreeNoPhoneByUnitId();
规则18方法中,存取属性的方法采用setter和getter方法,动作方法采用动词和动宾结构。
格式:
get+非布尔属性名()
is+布尔属性名()
set+属性名()
动词()
动词+宾语()
示例:
publicStringgetType();
publicbooleanisFinished();
publicvoidsetVisible(boolean);
publicvoidshow();
publicvoidaddKeyListener(Listener);
规则19属性名使用意义完整的英文描述,第一个单词的字母使用小写,剩余单词首字母大写其余字母小写的大小写混合法。
属性名不能与方法名相同。
示例:
privatecustomerName;
privateorderNumber;
privatesmpSession;
规则20常量名使用全大写的英文描述,英文单词之间用下划线分隔开,并且使用staticfinal修饰。
示例:
publicstaticfinalintMAX_VALUE=1000;
publicstaticfinalStringDEFAULT_START_DATE="2001-12-08";
1.3.2建议
建议10包名采用域后缀倒置的加上自定义的包名,采用小写字母,都应该以com.hifo开头(不包括一些特殊原因)。
在部门内部应该规划好包名的范围,防止产生冲突。
部门内部产品使用部门的名称加上模块名称。
产品线的产品使用产品的名称加上模块的名称。
说明:
除特殊原因包结构都必须以com.hifo开头,如果因为OEM合作等关系,可以不做要求。
格式:
com.hifo.产品名.模块名称
示例:
融合WEBSMAP包名com.hifo.iin.websmap
建议11通过对函数或过程、变量、结构等正确的命名以及合理地组织代码的结构,使代码成为自注释的。
说明:
清晰准确的函数、变量等的命名,可增加代码可读性,并减少不必要的注释。
建议12常用组件类的命名以组件名加上组件类型名结尾。
建议13如果函数名超过15个字母,可采用以去掉元音字母的方法或者以行业内约定俗成的缩写方式缩写函数名。
示例:
getCustomerInformation()改为getCustomerInfo()
建议14准确地确定成员函数的存取控制符号:
只是该类内部调用的函数使用private属性,继承类可以使用的使用protected属性,同包类可以调用的使用默认属性(不加属性控制符号),对外公开的函数使用public属性
示例:
protectedvoidgetUserName()
{
。
。
。
。
。
。
}
privatevoidcalculateRate()
{
。
。
。
。
。
。
}
建议15含有集合意义的属性命名,尽量包含其复数的意义。
示例:
customers,orderItems
1.4编码
1.4.1规则
规则21数据库操作、IO操作等需要使用结束close()的对象必须在try-catch-finally的finally中close(),如果有多个IO对象需要close(),需要分别对每个对象的close()方法进行try-catch,防止一个IO对象关闭失败其他IO对象都未关闭。
示例:
try
{
//......
}
catch(IOExceptionioe)
{
//......
}
finally
{
try
{
out.close();
}
catch(IOExceptionioe)
{
//......
}
try
{
in.close();
}
catch(IOExceptionioe)
{
//......
}
}
规则22系统非正常运行产生的异常捕获后,如果不对该异常进行处理,则应该记录日志。
说明:
此规则指通常的系统非正常运行产生的异常,不包括一些基于异常的设计。
若有特殊原因必须用注释加以说明。
示例:
try
{
//.......
}
catch(IOExceptionioe)
{
logger.error(ioe);
}
规则23自己抛出的异常必须要填写详细的描述信息。
说明:
便于问题定位。
示例:
thrownewIOException("Writingdataerror!
Data:
"+data.toString());
规则24运行时异常使用RuntimeException的子类来表示,不用在可能抛出异常的方法声明上加throws子句。
非运行期异常是从Exception继承而来的,必须在方法声明上加throws子句。
说明:
非运行期异常是由外界运行环境决定异常抛出条件的异常,例如文件操作,可能受权限、磁盘空间大小的影响而失败,这种异常是程序本身无法避免的,需要调用者明确考虑该异常出现时该如何处理方法,因此非运行期异常必须有throws子句标出,不标出或者调用者不捕获该类型异常都会导致编译失败,从而防止程序员本身疏忽。
运行期异常是程序在运行过程中本身考虑不周导致的异常,例如传入错误的参数等。
抛出运行期异常的目的是防止异常扩散,导致定位困难。
因此在做异常体系设计时要根据错误的性质合理选择自定义异常的继承关系。
还有一种异常是Error继承而来的,这种异常由虚拟机自己维护,表示发生了致命错误,程序无法继续运行例如内存不足。
我们自己的程序不应该捕获这种异常,并且也不应该创建该种类型的异常。
规则25在程序中使用异常处理还是使用错误返回码处理,根据是否有利于程序结构来确定,并且异常和错误码不应该混合使用,推荐使用异常。
说明:
一个系统或者模块应该统一规划异常类型和返回码的含义。
但是不能用异常来做一般流程处理的方式,不要过多地使用异常,异常的处理效率比条件分支低,而且异常的跳转流程难以预测。
注意:
Java5.0程序内部的错误码可以使用枚举来表示。
规则26注意运算符的优先级,并用括号明确表达式的操作顺序,避免使用默认优先级。
说明:
防止阅读程序时产生误解,防止因默认的优先级与设计思想不符而导致程序出错。
示例:
下列语句中的表达式
word=(high<<8)|low
(1)
if((a|b)&&(a&c))
(2)
if((a|b)<(c&d))(3)
如果书写为
high<<8|low
a|b&&a&c
a|b (1) (2)虽然不会出错,但语句不易理解;(3)造成了判断条件出错。 规则27避免使用不易理解的数字,用有意义的标识来替代。 涉及物理状态或者含有物理意义的常量,不应直接使用数字,必须用有意义的静态变量或者枚举来代替。 使用异常来表示方法执行错误,而不是使用C++的错误返回码方式。 示例: 如下的程序可读性差。 if(state==0) { state=1; ...//programcode } 应改为如下形式: privatefinalstaticintTRUNK_IDLE=0; privatefinalstaticintTRUNK_BUSY=1; privatefinalstaticintTRUNK_UNKNOWN=-1; if(state==TRUNK_IDLE) { state=TRUNK_BUSY; ...//programcode } 注意: Java5.0下建议使用枚举来表示。 异常: publicvoidfunction() { ... thrownewRuntimeException(“。 。 。 ”); } 规则28数组声明的时候使用int[]index,而不要使用intindex[]。 说明: 使用intindex[]格式使程序的可读性较差,int[]index表示声明了一个int数组(int[])叫做index 示例: 如下程序可读性差: publicintgetIndex()[] { .... } 如下程序可读性好: publicint[]getIndex() { .... } 规则29不要使用System.out与System.err进行控制台打印,应该使用工具类(如: 日志工具)进行统一记录或者打印。 说明: 代码发布的时候可以统一关闭控制台打印,代码调试的时候又可以打开控制台打印,方便调试。 规则30用调测开关来切换软件的DEBUG版和正式版,而不要同时存在正式版本和DEBUG版本的不同源文件,以减少维护的难度。 规则31集合必须指定模板类型(5.0+) 说明: 方便程序阅读,除去强制转换代码 示例: Map 规则32一个文件不要定义两个类(并非指内部类)。 说明: 方便程序的阅读与代码的维护 规则33所有的数据类必须覆写toString()、hashCode()、equals()方法,toString()方法返回该类有意义的内容。 说明: 方便数据类的比较,父类如果实现了比较合理的toString(),子类可以继承不必再重写。 hashCode与equals可以使用eclipse自动生成。 示例: publicTopoNode { privateStringnodeName; publicStringtoString() { return"NodeName: "+nodeName; } } 规则34判断语句不要使用”*==true”来判断为真 说明: 方便阅读,减少没有必要的计算 以下错误: if(ok==true) { …… } 以下正确: if(ok) { …… } 规则35不要写没有必要的向上强制转型。 说明: 没必要写的向上强制转型会浪费性能,增加代码阅读难度 示例: 以下错误: FileInputStreamfis=newFileInputStream(f); InputStreamis=(InputStream)fis; 1.4.2建议 建议16记录异常不要保存exception.getMessage(),而要记录exception.toString(),一般可通过日志工具记录完整的异常堆栈信息。 说明: NullPointException抛出时常常描述为空,这样往往看不出是出了什么错。 示例: try { ... } catch(FileNotFoundExceptione) { logger.error(e); } 建议17一个方法不应抛出太多类型的异常。 说明: 如果程序中需要分类处理,则将异常根据分类组织成继承关系。 如果确实有很多异常类型首先考虑用异常描述来区别,throws/exception子句标明的异常最好不要超过三个。 建议18异常捕获尽量不要直接catch(Exceptionex),应该把异常细分处理。 说明: 可以设计更合理异常处理分支 建议19如果多段代码重复做同一件事情,那么在方法的划分上可能存在问题。 说明: 若此段代码各语句之间有实质性关联并且是完成同一件功能的,那么可考虑把此段代码构造成一个新的方法。 建议20集合中的数据如果不使用了应该及时释放,尤其是可重复使用的集合。 说明: 由于集合保存了对象的引用,虚拟机的垃圾收集器就不会回收。 建议21源程序中关系较为紧密的代码应尽可能相邻。 说明: 便于程序阅读和查找。 示例: 矩形的长与宽关系较密切,放在一起。 rect.length=10; rect.width=5; 建议22不要使用难懂的技巧性很高的语句,除非很有必要时。 说明: 高技巧语句不等于高效率的程序,实际上程序的效率关键在于设计与算法。 建议23明确方法功能,精确(而不是近似)地实现方法设计。 一个函数仅完成一件功能,即使简单功能也编写方法实现。 说明: 虽然为仅用一两行就可完成的功能去编方法好象没有必要,但用方法可使功能明确化,增加程序可读性,亦可方便维护、测试。 建议24应明确规定对接口方法参数的合法性检查应由方法的调用者负责还是由接口方法本身负责,缺省是由方法调用者负责。 说明: 对于模
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- JAVA 编程 规范