JAVA开发编码规范12

《JAVA开发编码规范12》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、江苏亿科达科技发展有限公司JAVA开发编码规范版本说明版本制订人制订日期主要内容VI.0夏霆2008-09-11JAVA开发编码规范初稿VI.1m路2008-10-31JAVA开发编码规范修改VI.2夏霆2008-10-31确认发布一、前言41.1、目的41.2、范围4二、格式规范52.1缩进52.2换行52.3间隔52.4对齐52.5括号5三、注释规范63.1基本原则63.2文件注释63.3JavaDoc注释73.4失效代码注释73.5代码细节注释83.6注释的格式83.7注释的内容83.8Null规约94命名规范(NamingConventions)104.1基本约定

2、1()4.2文件、包104.3类、接口104.4字段115编程规范(ProgrammingConventions)125.1基本规范125.2类与接口125.3方法135.4错误与异常135.5JDK5.0及后续版本145.6性能与安全146自动代码检杏和修正166」为了编码的一致性，统一将Workspace'P的编码方式设置为UTF-8编码..…166.2便用统一的代码模板16刖舌1.1>目的本规范的目的是通过建立编码规范统一每个开发人员的编码习惯，捉高程序的可靠性、可读性、可修改性、可维护性及一致性，增加团队合作开发效率，为各项目纟R之间或项目组内成员Z间的技术交流提

3、供一个方便统一的方式。1-2＞范围本规范适用于公司内所有运用JAVA技术的软件项目、产品等的设计、开发以及维护、升级等。本规范适用于公司所有JAVA软件开发人员。本规范建议的开发环境与工具如下：IDE:Eclipse3.3.2以示版木插件:MyEclipse6.0以后版本JDK:SunJDK1.5二、格式规范对于代码，首要要求是它必须正确，能够按照设计预定功能去运行；第二是要求代码必须清晰易懂，使软件开发团队中的程序员能够很容易地理解代码。代码的组织和风格的基本原则是：便于自己的开发，易于与他人的交流。因个人习惯和编辑器等可以设置和形成自己的风格，但必须前后一致，并符合本

4、规范的基木要求和原则。2.1缩进使用TAB缩进，而不是空格键一一将缩进2,4,8字符的选择权留给阅读者。子功能块当在其父功能块后缩进。当功能块过多阳导致缩进过深时当将子功能块提取出來做为子函数。2.2换行页宽应该设置为80字符。-•般不要超过这个宽度，这会导致在某些机器屮或打印（A4）时无法以一屏来完整显示，但这一设置也可以灵活调整。在任何情况下，超长的语句丿应该在一个逗号后或一个操作符。前折行。一条语句折行后，应该比原来的语句再缩进一个TAB,以便于阅读。2.3间隔类、方法及功能块间等应以空行相隔，以增加可读性，但不得有无规则的大片空行。操作符两端应当各空一个字符以增加

5、可读性。相应独立的功能模块Z间可使用注释行间隔，并标明相应内容。2.4对齐关系密切的行应对齐，对齐包括类型、修饰、名称、参数等各部分对齐。连续赋值时应当对齐操作符。当方法参数过多时在适当的参数后（逗号后）换行并对齐。当控制或循环中的条件比较长时当换行（操作符前）、对齐并注释各条件。2.5括号括号屮的语句应该单独作为一行，左括号十当紧跟其语句后，右括号丁永远单独作为一行n与英匹配行对齐，并尽虽在其后说明其匹配的功能模块。较长的方法以及类、接口等的右括号后应使用//end...等标识其结束。如：类的结束符：｝//endClassName,方法结束符：｝//endmethodN

6、ame（）,功能块结束:)//cndif...userNameisnull?循环快结束：)//endfor...everyuserinuserList不要在程序中出现不必要的括号，但有时为了增加可读性和便于理解，当用括号限定相应项。If,for,while语句只有单句时，如果该句可能引起阅读混淆，需要用“{”和'丁括起来,否则可以省略。三、注释规范3.1基本原则基本原则：注释应该增加代码的清晰度。代码注释的目的是要使代码更易于被其他开发人员等理解。注释信息不仅要包括代码的功能，还应给出原因。除变量定义等较短语句的注释对用行尾注释外，其他注釋当避免使用行尾注释。3.2文件注

7、释在每个文件、包的头部都应该包含该文件的功能、作用、作者、版权以及创建、修改记录等。并在其屮使用版本仓库标记自动跟踪版木变化及修改记录等信息。注意是标准的C-Styl引*...*/注释而不是...*/形式的JavaDoc注释，在ECLIPS中使用CODETEMPLATES会口动添加，如下。/**@(#)Testi.java*CreatedDate:Sep11,2008**Copyright(c)JiangsuEcodeCo./Ltd*Thissoftwareistheconfidentialandproprietaryinfo