华为Java语言编码规范.docx

1、华为Java语言编码规范Document number 文档编号 Confidentiality level 密级 内部公开Document version 文档版本 Total 29 pages 共 29 页V1.00Java语言编码标准Prepared by 拟制Date日期yyyy-mm-ddReviewed by 评审人Date日期yyyy-mm-ddApproved by批准Date日期yyyy-mm-ddRevision Record 修订记录Date日期Revision Version修订版本Sec No. 修改章节Change Description修改描述Author作者yy

2、yy-mm-ddVx.xxTable of Contents 目录 1.范围本标准规定了使用Java语言编程时排版、注释、命名、编码和JTEST的规那么和建议。本标准适用于使用Java语言编程的产品和工程。2.标准性引用文件以下文件中的条款通过本标准的引用而成为本标准的条款。但凡注日期的引用文件，其随后所有的修改单不包括订正的内容或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。但凡不注日期的引用文件，其最新版本适用于本标准。序号编号名称1公司- DKBA1040-2001.12?Java语言编程标准?3.术语和定义规那么：编程时强制必须遵守的原那么

3、。建议：编程时必须加以考虑的原那么。格式：对此标准格式的说明。说明：对此标准或建议进展必要的解释。例如：对此标准或建议从正、反两个方面给出例子。4.排版标准4.1.规那么4.1.1.*程序块要采用缩进风格编写，缩进的空格数为4个。说明：对于由开发工具自动生成的代码可以有不一致。4.1.2.*分界符如大括号和应各独占一行并且位于同一列，同时与引用它们的语句左对齐。在函数体的开场、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。例如：如下例子不符合标准。for (.) . / program codeif (.) . / program

4、 code void example_fun( void ) . / program code 应如下书写：for (.) . / program codeif (.) . / program code void example_fun( void ) . / program code 4.1.3.*较长的语句、表达式或参数80字符要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进展适当的缩进，使排版整齐，语句可读。 例如：if (filename != null & new File(logPath + filename).length() LogCo

5、nfig.getFileSize() . / program code public static LogIterator read(String logType, Date startTime, Date endTime, int logLevel, String userName, int bufferNum) 4.1.4.*不允许把多个短语句写在一行中，即一行只写一条语句例如：如下例子不符合标准。LogFilename now = null; LogFilename that = null;应如下书写：LogFilename now = null;LogFilename that = n

6、ull; 4.1.5.*if, for, do, while, case, switch, default 等语句自占一行，且if, for, do, while等语句的执行语句无论多少都要加括号。例如：如下例子不符合标准。if(writeToFile) writeFileThread.interrupt(); 应如下书写：if(writeToFile)writeFileThread.interrupt(); 4.1.6.*相对独立的程序块之间、变量说明之后必须加空行。例如：如下例子不符合标准。if(log.getLevel() LogConfig.getRecordLevel() retur

7、n;LogWriter writer; 应如下书写：if(log.getLevel() LogConfig.getRecordLevel()return;LogWriter writer;int index; 4.1.7.*对齐只使用空格键，不使用TAB键。说明：以免用不同的编辑器阅读程序时，因TAB键所设置的空格数目不同而造成程序布局不整齐。JBuilder、UltraEdit等编辑环境，支持行首TAB替换成空格，应将该选项翻开。4.1.8.*在两个以上的关键字、变量、常量进展对等操作时，它们之间的操作符之前、之后或者前后要加空格；进展非对等操作时，如果是关系密切的立即操作符如.，后不应加空

8、格。说明：采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性是相对的，所以，在已经非常清晰的语句中没有必要再留空格，如果语句已足够清晰那么括号内侧(即左括号后面和右括号前面)不需要加空格，多重括号间不必加空格，因为在Java语言中括号已经是最清晰的标志了。在长语句中，如果需要加的空格非常多，那么应该保持整体清晰，而在局部不加空格。给操作符留空格时不要连续留两个以上空格。例如：（1）逗号、分号只在后面加空格。int a, b, c; （2）比拟操作符, 赋值操作符=、 +=，算术操作符+、%，逻辑操作符&、&，位域操作符= MAX_TIME_VALUE) a = b + c

9、;a *= 2;a = b 2; （3）!、+、-、&地址运算符等单目操作符前后不加空格。flag = !isEmpty; / 非操作!与内容之间i+; / +,-与内容之间 （4）.前后不加空格。p.id = pid; / .前后不加空格 （5）if、for、while、switch等与后面的括号间应加空格，使if等关键字更为突出、明显。if (a = b & c d)4.2.建议类属性和类方法不要穿插放置，不同存取范围的属性或者方法也尽量不要穿插放置。格式：类定义类的公有属性定义类的保护属性定义类的私有属性定义类的公有方法定义类的保护方法定义类的私有方法定义5.注释标准5.1.规那么5.1

10、.1.一般情况下，源程序有效注释量必须在30以上。说明：注释的原那么是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。可以用注释统计工具来统计。5.1.2.包的注释：包的注释写入一名为 package.html 的HTML格式说明文件放入当前路径。说明：方便JavaDoc收集例如：/huawei/msg/relay/comm/package.html5.1.3.包的注释内容：简述本包的作用、详细描述本包的内容、产品模块名称和版本、公司版权。说明：在详细描述中应该说明这个包的作用以及在整个工程中的位置。格式：一句话简述。详细描述。产品模块名称和版

11、本公司版权信息 例如：为 Relay 提供通信类，上层业务使用本包的通信类与SP进展通信。详细描述。MMSC V100R002 Relay(C) 版权所有 2002-2007 文思创新技术 5.1.4.文件注释：文件注释写入文件头部，包名之前的位置。说明：注意以 /* 开场防止被 JavaDoc 收集例如：/* * 注释内容 */package .huawei.msg.relay m; 5.1.5.文件注释内容：版权说明、描述信息、生成日期、修改历史。说明：文件名可选。格式：/* * 文件名：文件名 * ： * 描述：描述 * 修改人：修改人 * 修改时间：YYYY-MM-DD * 修改单号：

12、修改单号 * 修改内容：修改内容 */ 说明：每次修改后在文件头部写明修改信息，CheckIn的时候可以直接把蓝色字体信息粘贴到VSS的注释上。在代码受控之前可以免去。例如：/* * 文件名：LogManager.java * ：Copyright 2002-2007 Huawei Tech. Co. Ltd. All Rights Reserved. * 描述： MMSC V100R002 Relay 通用日志系统 * 修改人： 张三 * 修改时间：2001-02-16 * 修改内容：新增 * 修改人： 李四 * 修改时间：2001-02-26 * 修改单号：WSS368 * 修改内容：。

13、* 修改人： 王五 * 修改时间：2001-03-25 * 修改单号：WSS498 * 修改内容：。 */ 5.1.6.类和接口的注释：该注释放在 package 关键字之后，class 或者 interface 关键字之前。说明：方便JavaDoc收集。例如：package .huawei.msg.relay m;/* * 注释内容 */public class CommManager 5.1.7.类和接口的注释内容：类的注释主要是一句话功能简述、功能详细描述。说明：可根据需要列出：版本号、生成日期、作者、内容、功能、与其它类的关系等。 如果一个类存在Bug，请如实说明这些Bug。格式：/*

14、 * 一句话功能简述 * 功能详细描述 * author 作者 * version 版本号, YYYY-MM-DD * see 相关类/方法 * since 产品/模块版本 * deprecated */说明：描述局部说明该类或者接口的功能、作用、使用方法和考前须知，每次修改后增加作者和更新版本号和日期，since 表示从那个版本开场就有这个类或者接口，deprecated 表示不建议使用该类或者接口。例如：/* * LogManager 类集中控制对日志读写的操作。 * 全部为静态变量和静态方法，对外提供统一接口。分配对应日志类型的读写器， * 读取或写入符合条件的日志纪录。 * autho

15、r 张三，李四，王五 * version 1.2, 2001-03-25 * see LogIteraotor * see BasicLog * since CommonLog1.0 */ 5.1.8.类属性、公有和保护方法注释：写在类属性、公有和保护方法上面。例如：/* * 注释内容 */private String logType;/* * 注释内容 */public void write() 5.1.9.成员变量注释内容：成员变量的意义、目的、功能，可能被用到的地方。 5.1.10.公有和保护方法注释内容：列出方法的一句话功能简述、功能详细描述、输入参数、输出参数、返回值、违例等。格式：

16、/* * 一句话功能简述 * 功能详细描述 * param 参数1 参数1说明 * param 参数2 参数2说明 * return 返回类型说明 * exception/throws 违例类型 违例说明 * see 类、类#方法、类#成员 * deprecated */说明：since 表示从那个版本开场就有这个方法；exception或throws 列出可能仍出的异常；deprecated 表示不建议使用该方法。例如：/* * 根据日志类型和时间读取日志。 * 分配对应日志类型的LogReader， 指定类型、查询时间段、条件和反复器缓冲数， * 读取日志记录。查询条件为null或0表示无

17、限制，反复器缓冲数为0读不到日志。 * 查询时间为左包含原那么，即 startTime, endTime) 。 * param logTypeName 日志类型名在配置文件中定义的 * param startTime 查询日志的开场时间 * param endTime 查询日志的完毕时间 * param logLevel 查询日志的级别 * param userName 查询该用户的日志 * param bufferNum 日志反复器缓冲记录数 * return 结果集，日志反复器 * since CommonLog1.0 */public static LogIterator read(St

18、ring logType, Date startTime, Date endTime, int logLevel, String userName, int bufferNum) 5.1.11.对于方法内部用throw语句抛出的异常，必须在方法的注释中标明，对于所调用的其他方法所抛出的异常，选择主要的在注释中说明。 对于非RuntimeException，即throws子句声明会抛出的异常，必须在方法的注释中标明。说明：异常注释用exception或throws表示，在JavaDoc中两者等价，但推荐用exception标注Runtime异常，throws标注非Runtime异常。异常的注释必

19、须说明该异常的含义及什么条件下抛出该异常。 5.1.12.*注释应与其描述的代码相近，对代码的注释应放在其上方或右方对单条语句的注释相邻位置，不可放在下面，如放于上方那么需与其上面的代码用空行隔开。5.1.13.*注释与所描述内容进展同样的缩排。说明：可使程序排版整齐，并方便注释的阅读与理解。例如：如下例子，排版不整齐，阅读稍感不方便。public void example( )/ 注释 CodeBlock One / 注释 CodeBlock Two应改为如下布局。public void example( ) / 注释 CodeBlock One / 注释 CodeBlock Two 5.1

20、.14.*将注释与其上面的代码用空行隔开。例如：如下例子，显得代码过于紧凑。/注释program code one/注释program code two 应如下书写：/注释program code one /注释program code two 5.1.15.*对变量的定义和分支语句条件分支、循环语句等必须编写注释。说明：这些语句往往是程序实现某一特定功能的关键，对于维护人员来说，良好的注释帮助更好的理解程序，有时甚至优于看设计文档。 5.1.16.*对于switch语句下的case语句，如果因为特殊情况需要处理完一个case后进入下一个case处理，必须在该case语句处理完、下一个case

21、语句前加上明确的注释。说明：这样比拟清楚程序编写者的意图，有效防止无故遗漏break语句。 5.1.17.*边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。不再有用的注释要删除。 5.1.18.*注释的内容要清楚、明了，含义准确，防止注释二义性。说明：错误的注释不但无益反而有害。 5.1.19.*防止在注释中使用缩写，特别是不常用缩写。说明：在使用缩写时或之前，应对缩写进展必要的说明。 5.2.建议5.2.1.*防止在一行代码或表达式的中间插入注释。说明：除非必要，不应在代码或表达中间插入注释，否那么容易使代码可理解性变差。 5.2.2.*通过对函数或过程、变量、构造等正

22、确的命名以及合理地组织代码的构造，使代码成为自注释的。说明：清晰准确的函数、变量等的命名，可增加代码可读性，并减少不必要的注释。 5.2.3.*在代码的功能、意图层次上进展注释，提供有用、额外的信息。说明：注释的目的是解释代码的目的、功能和采用的方法，提供代码以外的信息，帮助读者理解代码，防止没必要的重复注释信息。例如：如下注释意义不大。/ 如果 receiveFlag 为真if (receiveFlag) 而如下的注释那么给出了额外有用的信息。 / 如果从连结收到消息 if (receiveFlag) 5.2.4.*在程序块的完毕行右方加注释标记，以说明某程序块的完毕。说明：当代码段较长，特

23、别是多重嵌套时，这样做可以使代码更清晰，更便于阅读。例如：参见如下例子。if (.) program code1 while (index MAX_INDEX) program code2 / end of while (index MAX_INDEX) / 指明该条while语句完毕 / end of if (.) / 指明是哪条if语句完毕 5.2.5.*注释应考虑程序易读及外观排版的因素，使用的语言假设是中、英兼有的，建议多使用中文，除非能用非常流利准确的英文表达。说明：注释语言不统一，影响程序易读性和外观排版，出于维护的考虑，建议使用中文。 5.2.6.方法内的单行注释使用 /。说明：

24、调试程序的时候可以方便的使用 /* 。*/ 注释掉一长段程序。5.2.7.注释尽量使用中文注释和中文标点。方法和类描述的第一句话尽量使用简洁明了的话概括一下功能，然后加以句号。接下来的局部可以详细描述。说明：JavaDoc工具收集简介的时候使用选取第一句话。 5.2.8.顺序实现流程的说明使用1、2、3、4在每个实现步骤局部的代码前面进展注释。例如：如下是对设置属性的流程注释 /1、 判断输入参数是否有效。 。 / 2、设置本地变量。 。 5.2.9.一些复杂的代码需要说明。例如：这里主要是对闰年算法的说明。 /1. 如果能被4整除，是闰年； /2. 如果能被100整除，不是闰年.； /3.

25、如果能被400整除，是闰年.。6.命名标准6.1.规那么6.1.1.包名采用域后缀倒置的加上自定义的包名，采用小写字母。在部门内部应该规划好包名的范围，防止产生冲突。部门内部产品使用部门的名称加上模块名称。产品线的产品使用产品的名称加上模块的名称。格式：.huawei.产品名.模块名称.huawei.部门名称. 工程名称例如：Relay模块包名 .huawei.msg.relay通用日志模块包名 .huawei.msg.log 6.1.2.类名和接口使用类意义完整的英文描述，每个英文单词的首字母使用大写、其余字母使用小写的大小写混合法。例如：OrderInformation, Customer

26、List, LogManager, LogConfig 6.1.3.方法名使用类意义完整的英文描述：第一个单词的字母使用小写、剩余单词首字母大写其余字母小写的大小写混合法。例如：private void calculateRate();public void addNewOrder(); 6.1.4.方法中，存取属性的方法采用setter 和 getter方法，动作方法采用动词和动宾构造。格式：get + 非布尔属性名()is + 布尔属性名()set + 属性名()动词()动词 + 宾语()例如：public String getType();public boolean isFinishe

27、d();public void setVisible(boolean);public void show();public void addKeyListener(Listener); 6.1.5.属性名使用意义完整的英文描述：第一个单词的字母使用小写、剩余单词首字母大写其余字母小写的大小写混合法。属性名不能与方法名一样。例如： private customerName;private orderNumber;private smpSession; 6.1.6.常量名使用全大写的英文描述，英文单词之间用下划线分隔开，并且使用 final static 修饰。例如： public final s

28、tatic int MAX_VALUE = 1000;public final static String DEFAULT_START_DATE = 2001-12-08; 6.1.7.属性名可以和公有方法参数一样，不能和局部变量一样，引用非静态成员变量时使用 this 引用，引用静态成员变量时使用类名引用。例如：public class Person private String name; private static List properties; public void setName (String name) this.name = name; public void setProperties (List properties) Person.properties = properties; 6.2.建议6.2.1.常用组件类的命名以组件名加上组件类型名结尾。例如：Applicati