1命名规范
命名规范是一种约定,也是程序员之间良好沟通的桥梁,下面是Java语言中标识符的命名规范。
(1)标识符严格区分大小写。
(2)标识符是由字母、数字、下画线(-)和美元符号$组成的字符序列。
(3)标识符必须以字母、下画线(_)或美元符号$开头而不能以数字开头。
(4)标识符不能是关键字或保留字。
(5)对变量和方法总是使用小写。如果名称由多个单词组成,将它们连接在一起,第一个单词的首字母小写,其他单词的首字母大写。
(6)类名中每一个单词的首字母大写。
(7)常量中的毎一个字母大写,单词之间使用下画线。
标识符命名时,不能以数字开头,也不能使用任何的Java关键字。
2.声明规范
声明规范有助于代码的阅读和理解,在Java语言中声明规范可以参照下面几点。
(1)变量在声明时,同时进行初始化。
(2)同一行只声明一个变量。
(3)勿把不同类型的变量声明放在同一行。
(4)方法和方法之间空一行。
3.语句规范
语句规范使整个程序的思路比较清晰,同时有助于代码的的阅读和理解。
java语言中语句规范可以参照下面几点。
(1)每行至多包含一条语句。
(2)复合语句是包含在大括号中的语句序列,如(语句)
(3)带返回值的return语句,返回值不使用小括号括起来。
(4)if语句总是用大括号括起来。
(5)在for语句的初始化或更新子句中,避免使用3个以上变量,而导致程序复
杂度提高。
4.注释规范
定义注释规范的目的是增强程序的可读性,让项目中所有的文档都看起来像是同一个程序员写的。在Java语言中注释规范可以参照下面几点。
(1)注释尽可能使用//。对于所有的javadoc注释,则使用“/** 解释语句*/”。;而临时代码进行注释尽量使用。/**/。
(2)注释用中文。
(3)在局部变量的右侧添加注释。
(4)在代码逻辑块前加上功能说明。
(5)在判断条件的上面加上说明注释。
(6)代码中建议有20%行的注释,20%行的空行,以便于阅读。
5.编程规范
编程规范可以减少对内存的需求量,加快代码的执行速度,同时降低程序的出错率。在Java语言中,编程规范可参照下面几点。
(1)提供对类的对象及类变量的访问控制,尽可能不使用默认(default)的访问控制。
(2)避免用一个对象访问类的静态变量和静态方法,应使用类名代替。
(3)避免在一个语句中给多个变量赋相同的值。
(4)在含有多种运算符的表达式中,使用圆括号括起来,避免运算符优先级的问题。
(5)如果使用JDBC,考虑使用java.sql.Preparestatement,而不是java.sql.Statement.
6.文件内客规范
文件内容规范有助于减少运行时产生不必要的麻烦。在Java语言中,文件内容规范可参照下面几点。
(1)每个源文件的代码行数不超过500行。
(2)每个源文件中都含有一个单一的公共类或接口。
(3)在多数Java源文件中,第一个非注释行是包语句。
(4)文件名和类名相同。
(5)对于关键的方法要多加注释。
7.缩进排版规范
1)行长度
避免一行的长度超过70个字符,因为这会导致很多终端和工具不能很好地处理。
2)换行
当一个表达式无法容纳在一行内时,可以依据如下规则断开。
(1)在一个逗号后面断开。
(2)在一个操作符前面断开。
(3)选择较高级别(higher-level)的断开,而非较低级别(lower-level)的断开。
(4)新的一行应该与上一行同一级别表达式的开头处对齐。
(5)如果以上规则导致代码混乱或者使代码都堆积在右边,那就代之以缩进8个空格。
#摘自java程序开发案例课堂
552

被折叠的 条评论
为什么被折叠?



