文档介绍：Chinapay技术部Java编码规范(Version:)版本变迁记录:-06--07--07-07增加对大括号换行的说明。-07-08增加对jar包的说明。-07-08修改jar包的发布说明目录Chinapay技术部Java编码规范 11. 概述 42. 源程序编程规范 . 命名规范 . 类和接口的命名 . 方法的命名 . 变量的命名 . 静态常量的命名 . 枚举的命名 . 普通变量的命名 . 包的命名 . Jsp文件及变量的命名 . 注释及空白规范 . 注释规范 . Javadoc规范 . 空白的规范 . 空行的规范 . 空格的规范 . 缩进的规范 . 折行、换行规范 83. 日志规范 94. 异常处理的规范 95 单元测试规范 96 其他禁忌 10概述本标准定义了chinapay技术部java语言开发的编程格式规范,主要包括命名规范、代码注释、日志、以及常用语句的书写要求和约束等。统一规范的格式有利于代码标准化、提高代码的可读性,从而方便后面维护人员对系统业务流程的理解,便于对系统的进行改造和功能扩展。适用对象包括java源程序和jsp代码。源程序编程规范命名规范所有的标识符的命名力求做到统一、达意和简洁。如下为标识符的总原则,本章节的所有不同类型的标识符都必须首先符合本原则:统一:对于同一个概念,在程序中用同一种表示方法。比如对于金额,如果定义了amt,则不要再变成其他名称。达意:标识符能准确的表达出它所代表的意义,比如:BaseOperDBDAO,GenBankFileProcess等。切忌用tmp,server1,server2等之类的命名。简洁:在统一和达意的前提下,用尽量少的标识符。如果不能达意,宁愿不要简洁。骆驼法则:Java中,除了包名,静态常量等特殊情况,大部分情况下标识符使用骆驼法则,即单词之间不使用特殊符号分割,而是通过首字母大写来分割。比如:SupplierName,addNewContract,而不是supplier_name,add_new_contract命名尽量使用通俗易懂的英文单词,如果不会可以向同事求助,不可使用拼音。对于chinapay的业务流程相关的标识符,建议加上cp前缀。类和接口的命名类名首字母必须大写。例如:。一定集合的类定义了统一的后缀。如下是常见的类的后缀,如果属于如下集合,请务必按清单中的后缀给类命名。请注意后缀的大小写。Action:Struts的action类,mit3015Action。不同的项目对action要求不一样,如果需要权限控制,则通常在类中需要有权限id,用来过滤url的请求权限。每个action必须加action后缀,但是struts-。例:,。Form:Struts的form类,例:Perform3013Form。跟action一一对应。也可多个action公用一个form。命名通常跟action配套,mit3015Action,mit3015Form。Bean:数据库对象,例:CardBinBean。类名通常跟数据库表一一对应,如表名为card_bin,则对应的bean名称为CardBinBean。。目前已经实现了一个根据表结构生成bean的工具,可用此来生成。DAO:数据库操作对象,例:CardBinDAO。所有的数据库操作必须在DAO中进行。后缀统一为DAO,不可写成Dao。如果DAO为小表,建议用不要每次都访问数据库,.。需要在控制台可以手动更新内存。Servlet:servlet类,例:LoginServiceServlet。Servlet类必须加此后缀。理论上,如果采用struts框架或者其他mvc框架,尽量少用servlet。BO:复杂业务逻辑类。例:UserBO。对于复杂的业务逻辑,需要独