《java语言程序设计编程规范》由会员分享，可在线阅读，更多相关《java语言程序设计编程规范（27页珍藏版）》请在金锄头文库上搜索。
1、JAVA语言程序设计第九章 编程规范08数媒技术一班 郭慧莹 081001351.1 Java编程规范本编程规范建立在标准的Java编程 规范的基础上，如和标准的Java编程 规范有冲突，以本编程规范为准。1.1.1 程序结构 包名 引入包/类名 类注释 类 常量/常量注释 构造器注释 构造器 构造器注释 构造器 方法注释 方法 方法注释 方法 1.1.2 命名规范 命名规范使得程序更易理解，可读性更强。并且能够提供 函数和标识符的信息。 文件命名规范java程序使用如下的文件名后缀： 对系统的文件命名方式有待于根据实际业务决定。文件类型后缀 Java 源文件.java Java 字节码文件.
2、class 包命名规范包名应该唯一，它的前缀可以为任何小写的ASCII字符但必须是顶级 域名，目前包括com, edu, gov, mil, net, org,或者ISO标准3166,1981 中两个字符的国别代码。包名接下来的部分按照公司内部的命名规范 ，这些规范指出了某种目录名，主要包括部门，项目，机器，或者登 录名。 命名规则为： com.sinosoft.系统名.模块名.xxx.xxx 具体参错误！未找到引用源。 包命名举例： com.sinosoft.platform.bl.facade com.sinosoft.platform.dto.domain 类命名规范类名应该是名词，并且
3、是大小写混合的。首字母要大写。尽量保证类 名简单并且描述性强。避免使用只取单词首字母的简写或者单词的缩 写形式，除非缩写形式比单词的完整形式更常用（例如：URL或者 HTML）。文件名必须和public的类名保持一致，注意大小写（JBuilder等一 些编译器可以忽略大小写，要特别注意）. 类命名举例： class PolicyOverviewDto; class DBPrpDuser.java; 接口命名规范 接口命名方式与类命名方式相同。 接口命名举例： interface PolicyOverview; interface PolicyOverviewSessionHome; 方法命名规
4、范 方法名应该为动词，并且是大小写混合的。首字母要小写 ，方法名的第 二个单词的第一个字母大写。 方法命名举例： String getNoticeNo(); Collection findByCondition(String) 变量命名规范变量，以及所有的类实例应为首字母小写的大小写混合形式。变量名 的第二个单词的首字母大写。变量名的首字母不能为下划线或者$符 。 变量名应该尽可能的短小，但要有意义。变量名应该便于记忆，也就 是说变量名应该尽可能的做到见名知意。除了暂时使用的变量外（一 般用于循环变量），应该避免使用只有一个字母的变量名。对于临时 变量一般说来：i，j，k，m，n代表整型变量。
5、c，d，e代表字符型变 量。 变量命名举例： String dataType; String name; int i; char c; 常量命名规范 声明为类常量的变量或者ANSI常量应该全 部为大写字母，并且每个单词间用下划线 “_”隔开。为了便于调试，应避免使用ANSI 常量。 常量命名举例： static final int MIN_WIDTH = 4; 1.1.3 注释规范 Java 提供了两种类型的注释：程序注释和文档注释。程序注释是由分隔符/*/，和/ 隔开的部分，这些注释和C+ 中的注释一样。文档注释（即“doc 注释”）是Java 独有的。由分隔符/*/隔开。使用javadoc
6、工具能够将文档注释抽取出来形成HTML文件。程序注释主要是对程序的某部分具体实现方式的注释。文档注释是对程序的描述性注释，主要是提供给不需要了解程序具体实现的开发者使用。注释应该是代码的概括性描述，提供不易直接从代码中得到的信息，并且只包含对阅读和理解程序有用的信息。例如注释中包含相应的包如何编译或者在哪个目录下，而不应该包括这个包驻留在哪儿的信息。注释中可以描述一些精妙的算法和一些不易理解的设计思想，但应该避免那些在程序代码中很清楚的表达出来的信息。尽可能的避免过时的信息。错误的注释比没有注释更有害。经常性的注释有时也反映出代码质量的低下。程序注释 程序注释有四种格式：块注释格式，单行注释，
7、跟随注释，行尾注释 块注释格式块注释主要用于描述：文件、方法、数据结构和算法。一般在文 件或者方法定义的之前使用。也可以用在方法定义里面，如果块注释 放在函数或者方法定义里，它必须与它所描述的代码具有相同的缩进 形式。块注释应该用一个空行开头，以便于代码部分区分开来。 块注释举例： /* * Here is a block comment. */ 程序注释 单行注释 比较短的注释可以放在一行中，但必须与它所跟随的代码有相同的缩进。如果注释不 可以放在一行，那么必须按照块注释的格式来写。单行的注释会被解释为一空行。单行注释举例： if (condition) /* Handle the cond
8、ition. */ . 跟随注释 非常短的注释可以和它所描述的代码放在同一行。但要保证代码和注释之间有足够的 间隔。在同一块代码中不止一个这样的注释时它们应该对齐。 跟随注释举例： if (a = 2) return TRUE; /* special case */ else return isPrime(a); /* works only for odd a */ 程序注释 行尾注释注释标记“/”能够注释一行或者该行由“/”开始直到行尾的部分。行尾注释不能用在多行文本注释中。但它可以将多行代码注释掉。这三种注释方法举例如下。if (foo 1) / Do a double-flip. . e
9、lse return false; / Explain why here. /if (bar 1) / / / Do a triple-flip. / . / /else / return false; / 程序注释 文档注释 文档注释描述了Java类，接口，构造函数，方法和属性。每个文档注释放在文档注释符/*/中。 每个类、接口或者成员只在声明的地方之前有一个文档注释。 例如： /* * The Example class provides . */ public class Example . 注意：最外层的类或者接口的文档注释不用缩进。但它的成员的文档注释与成员的声明具有相同的 缩进格式
10、。 文档注释从第二行开始与第一行相比缩进一个字符。即注释的每一行的星号要对齐。 如果关于类、接口、变量或者方法的注释信息不是为文档信息提供的，就应该使用块注释或者单行 注释（这两类注释应该使用在声明之后）。关于类实现方法的详细信息应该放在类语句后的块注释 中，而不应该放在类的文档注释中。 文档注释方法或者构造函数的定义块内。Java会将文档注释后的第一个声明于文档注释关联起来。 方法类型为protected、public的必须提供方法注释1.1.4 构造方法规范 工具类不允许有public或default构造方法。这可以避免不 必要的创建实例。 一个类里面的所有public方法都是static
11、的，则这个类就可 以作为工具类。其它类使用工具类的方法时，无需创建其 实例，直接使用其方法即可。 例：在sysframework包中存在着的一个典型的工具类的例 子： mon.util.StringUtils，它的 所有public方法都是static的，里面只有一个private构造方 法。 1.1.5 修饰符规范 按照Java语言规范，修饰符按如下顺序组织： public protected private abstract static final transient volatile synchronized native strictfp 例： public static final
12、 int NOT_FOUND = 100; /正确的顺序 final static private String policyNo; /不正确的顺序。1.1.6 声明规范 变量声明 每行定义变量数目每行定义的变量数目必须有且只有一个。例如：int level; / indentation levelint size; / size of table变量初始化在声明局部变量的时候就要初始化变量。变量定义位置在for循环里的循环变量可以在for语句里面定义。for (int i = 0; i maxLoops; i+) . 注意：应避免局部变量屏蔽了外层变量的作用范围。也就是说不要在内部块中声明一
13、个与外部块某个变量同名的变 量。例如类似下面的情况应避免：int count;.myMethod() if (condition) int count; / 与外部的count变量重名，应该避免!.1.1.6 声明规范 数组的定义数组的应该放在类型名的后面，而不是变量名的后面。例： String dangerNo; /正确的顺序 String bigArray; /正确的顺序 String dangerAddress;/错误的顺序 类和接口声明 类和接口声明类和接口的声明应该遵循以下规范： 1. 在方法名和参数列表的圆括号以及括号后的第一个参数间都没有空格。 2. 开括号“”必须与声明语句放在
14、同一行。 3. 闭括号“”必须与声明语句有相同的缩进格式。 4. 如果类或者接口实现内容为空，则可以将“”放在“”后面。 5. 方法之间要用一个空行隔开。 class Sample extends Object int ivar1; int ivar2; Sample(int i, int j) ivar1 = i; ivar2 = j; int emptyMethod() . 1.1.7 语句规范 不允许出现空语句的情况，典型的错误案例是： 一行里只有一个分号 一个语句后面连续出现几个分号 不允许出现无意义语句，如 policyNo = policyNo; 简单语句 每行最多包含一个语句。
15、例如： argv+; / 正确argc+; / 正确argv+; argc-; / 错误，应该避免这样写 组合语句 组合语句使用大括号括起来的一串语句。 1. 大括号中的语句比组合语句多一级缩进。 2. 开括号“”应该放在组合语句前的语句末尾。闭括号“”应该放在新的一行并与组合语句开始 前的第一个语句有相同的缩进。 3. 如果语句是控制语句的一部分时，所有的语句都要用大括号围起来，即使只有一个语句也 要用括号，例如在if-else或者for语句中。这样避免在添加语句时忘记添加括号而导致程序产生 bug。1.1.7 语句规范 return语句return语句在有返回值时不需要使用圆括号，除非使用圆括号在某些特定的情况下能够提高代码的可读性。return语句举例： return; return myDisk.size(); return (size ? size : defaultSize); if语句 if语句使用格式如下： if (condition
