软件有限公司呼叫中心项目软件开发代码规范性标准

软件有限公司呼叫中心项目软件开发代码规范性标准概述目的制定规范，约束开发人员在开发过程中随意性、不规范性，减少开发后期带来的不必要的成本浪费。要求开发人员开发之前，必须通读开发规范中的内容（理解规范中的要求）。在开发过程中，必须严格执行规范中制定的规范内容，如果检查过程中发现没有按规范执行的，按《呼叫中心项目软件开发代码规范性检查办法》执行。规范细则详述注释所有的注释文字一律使用简体中文。类注释在import语句和class声明语句之间必须加类的注释，格式如下：要有功能说明、创建人、创建日期、修改人（如果修改了部分代码）、修改日期、修改说明、版本号。方法注释在方法前必须添加注释。对于设置(Set方法)与获取(Get方法)成员的方法，在成员变量已有说明的情况下，可以不加注释。对于类似stuts的ACTION方法，其输入输出参数固定、格式统一的，参数说明可以省略。属性注释注释格式：//注释内容。写明该属性的含义。代码内注释主要变量定义、引用及复杂的算法需注释。代码段落注释，说明以下代码段在该方法中具体实现的功能；注释格式：//注释内容或以“/*”开始，“*/”结尾注释。修改注释当创建人与修改人不是同一个的情况下，需加修改注释。在增加的代码前添加注释，内容包括增加部分功能说明、增加人、增加日期、增加部分开始声明。结束部分添加注释，注释内容包括增加部分功能说明、增加人、增加日期、增加部分结束声明。以上包括增加、修改和删除的注释。命名包命名包的名字应该能够说明包的用途，通常应是名词或名词短语。包的名字应该全部由小写字母构成.；如果包的用途必须由两个或多个单词才能描述清楚，可以直接将这些单词连接作为包名.”；如果连接后的包名太长，可以使用单词的缩写（缩写必须不会引起歧义）或取每个单词的首字母。类命名首字母大写；类的名字应该能够说明类的用途，通常应是名词或名词短语。类的名字由若干单词连接而成，每个单词的首字母应大写，其他字母小写；如果某个词是一个缩写形式，则这个词应全部大写.。方法命名所有的方法（构造函数除外）名都应能说明方法的用途，通常取动词或动词短语，也可能是名词或名词短语。方法名由若干单词连接而成，第一个单词应全部小写，其余单词的首字母大写。对于以名词或名词短语命名的方法，建议改成动词或动词短语形式。变量命名通常由1—3个英文单词/简写组成，尽量不能超过4个单词；通常组成形式是：形容词+名词，名词+名词，动词+名词；如：nUserNum，AddUser.jsp每个变量首字母必须小写，每个单词首字母大写（数据库除外）；可以添加数字或下划线的组合；避免使用类似的名字如变量名persistentObject与persistentObjects不能同用；绝对禁止包含汉字、拼音、无含义字母、空格和特殊字符；常量命名变量的名字应该都大写，并且指出完整含义。JSP命名Jsp的文件的开头都以小写开头，其他单词第一字母要大写，其余小写。同一个业务建立一个意义相同单词的目录，且相同的jsp都在相同的目录下。SSH命名Package的命名及应用包的最上层规定为com.order.cc在每次增加一个业务功能时，就要增加一个新包，新包下的结构包括：action、form、entity、dao、idao、svc。action：jsp提交时对应的方法入口。form：jsp与后台数据的缓冲。entity：相关数据对象的实体文件。dao：所有的数据库操作都要在此类中完成，禁止数据库sql在其他类中出现。idao：dao的接口类。svc：业务逻辑在此类中实现，与dao挂钩。注：此包在命名可以根据具体的功能来灵活命名，一般业务可以参照此包的结构来实现Class的命名及应用Class的名字必须由大写字母开头并且每个独立的单词第一个字母也必须以大写开头，其他字母都小写的单词组成。Action类名形式：描述性名称+Action.javaForm类名形式：描述性名称+Form.javaEntity类名形式：描述性名称+Entity.javaDao类类名形式：描述性名称+DAO.javaIDao类类名形式：I+描述性名称+DAO.javasvc类类名形式：描述性名称+Serivce.java注：此类的命名是对上面包命名的一个规定，如包不属于上述结构，class完全可以不依照上面的命名在struts-config.xml命名path时，不要带路径，防止路径混乱。正确的命名如下：path="/menuAction"格式缩进规范类中的成分，使用缩进；方法体或语句块中的成分，使用缩进；换行时的非起始行，使用缩进；缩减量一般为在上一级成分的基础上再缩进四个空格。空行规范包语句与import语句间空两行；Import语句与class定义之间空两行；方法与方法之间以空行分隔；函数内部数据与代码之间应空至少一行，代码中适当处应以空行空开，建议在代码中出现变量声明时，在其前空一行；在