编码规范及其代码剖析.docVIP

项目编号 文档编号 4 密 级 内部 学生公寓管理系统编码规范及其代码说明 兰州理工大学 评 审 日 期： 2016年1月15日  目 录 1.导言 3 1.1目的 3 1.2范围 3 1.3缩写说明 3 1.4术语定义 4 1.5引用标准 4 1.6参考资料 4 2. 编码格式规范 4 2. 1缩进排版 4 2. 2行长度 4 2. 3断行规则： 5 2. 4空行 6 3.命名规范 6 3. 1包(Packages) 7 3. 2类(Classes) 7 3. 3接口(Interfaces) 7 3. 4方法(Methods) 7 3. 5变量(Variables) 7 3. 6实例变量(Instance Variables) 8 3. 7常量(Constants) 8 4．声明规范 8 4.1每行声明变量的数量 8 4.2初始化 8 4.3布局 8 4.4包的声明 9 4.5类和接口的声明 9 5．语句规范 9 5.1简单语句 9 5.2复合语句 10 6.注释规范 10 6. 1注释的方法 10 6. 2开头注释 11 6. 3类和接口的注释 12 7. 代码范例 12 8.目录规范 12 1.导言 1.1目的 该文档的目的是描述学生公寓管理系统项目的编码规范和对代码的说明，其主要内容包括： 编码规范 命名规范 注释规范 语句规范 声明规范 目录设置 代码说明 本文档的预期的读者是： 开发人员 项目管理人员 质量保证人员 1.2范围 该文档定义了本项目的代码编写规范，以及部分代码描述和所有代码的说明。 1.3缩写说明 MVC Ｍｏｄｅｌ－Ｖｉｅｗ－Ｃｏｎｔｒｏｌ（模式－视图－控制）的缩写，表示一个三层的结构体系。 EJB Ｅｎｔｅｒｐｒｉｓｅ　Ｊａｖａ　Ｂｅａｎ（企业级ＪａｖａＢｅａｎ）的缩写。 1.4术语定义 Class Java程序中的一个程序单位，可以生成很多的实例。 Packages 由很多的类组成的工作包。 1.5引用标准 [1] 《企业文档格式标准》 [2] 《Java语言编写规范》 1.6参考资料 [1] 《实战ｓｔｒｕｃｔ》 〔美〕Ｔｅｄ　Ｈｕｓｔｅｄ 机械工业出版社 [2] 《软件重构》 清华大学出版社 编码格式规范 2. 1缩进排版 4个空格作为缩进排版的一个单位。 2. 2行长度 尽量避免一行的长度超过80个字符，用于文档中的例子应该使用更短的行长，长度一般不超过70个字符。 2. 3断行规则： 当一个表达式无法容纳在一行内时，可以依据如下一般规则断开： 在一个逗号后面断开 在一个操作符前面断开 宁可选择较高级别(higher-level)的断开，而非较低级别(lower-level)的断开(见下面的例子) 新的一行应该与上一行同一级别表达式的开头处对齐 如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边，那就代之以缩进8个空格 以下是两个断开算术表达式的例子。前者属于更高级别的断开，因为断开处位于括号表达式的外边。 longName1 = longName2 * (longName3 + longName4 - longName5) + 4 * longname6; //推荐 longName1 = longName2 * (longName3 + longName4 -longName5) + 4 * longname6; //避免 以下是两个缩进方法声明的例子。前者是常规情形。后者若使用常规的缩进方式将会使第二行和第三行移得很靠右，所以代之以缩进8个空格。 //规范的缩进 someMethod ( int anArg, Object anotherArg, String yetAnotherArg, Object andStillAnother){ … } //以8个空格来缩进，以避免非常纵深的缩进 private static synchronized horkingLongMethodName(int anArg, Object anotherArg, String yetAnotherArg, Object andStillAnother) { … } if语句的换行通常使用8个空格的规则，因为常规缩进(4个空格)会使语句体看起来比较费劲。比如： //不可取的缩进方法 if ( ( condition1 condition2) || (condition3 condition4) || ( condition5 condition6)) { doSomethingAboutIt();