失效链接处理 |
java编程习惯 PDF 下载
本站整理下载:
相关截图:
![]()
主要内容:
(一)编程语言的通用规范
在详细介绍Java元素的命名规范之前我们首先来看一下所有语言通用的一些编码规则。
1.名称应该有实际意义
当我们为变量、方法、类或者常量命名的时候应该使用对阅读者来说是具有实际意义的名称,避免使用单个字母或者通用名。
我们首先来看下面这一段代码:
if (a < 65) {
y = 65 - a;
}
else {
y = 0;
}
在上面这段代码中,虽然我们能理清代码的执行过程,但是却不能判断出变量a和常数65的意义,这毫无疑问让我们很难理解这段代码的实际意义。
如果我们使用具有实际意义的名称来替换代码中的字母变量和常量,这段代码将十分容易理解。
if (age < RETIREMNT_AGE) {
yearsToRetirement = RETIREMNT_AGE - age;
}
else {
yearsToRetirement = 0;
}
这种命名规则有一个例外情况,就是临时变量的命名。
for (int i = 0; i < numberOfStudents; i++) {
enrollStudent(i);
}
临时变量的意义通过上下文的充足信息我们就可以判断出来,无需为其单独命名。
2.使用人们熟悉的名称
使用阅读者所熟悉的领域中的术语。如果阅读者习惯使用“customer”这个词,就不要使用“client”。当领域或者目标行业已经存在通用术语时,开发人员就不应该再采用非通用术语或者自己造新词。
3.谨慎使用过长的名称
如果类、接口、变量和方法的名称过长,那就说明这个实体的定义十分复杂。在给一个实体命名时,我们首先要考虑的是它的设计和用途,通过建立更具有针对性的类、接口、方法和变量来构成这些实体,并且给它们更简单有意义的名称。
4.不要使用只依赖大小写来区分的名字
虽然Java编译器可以区分那些大小写不同的名字,但是人在阅读时是很难注意到差别的,这就很容易对读者造成误导。
比如,变量theSQLInputStream和变量theSqlInputStream是不应该出现在同一个作用域的。
|