Java编程规范(三)

在上一篇的java编程风格学习(二)中我们学习了一些在Java编码过程中的格式规范,遵循这些规范毋庸置疑是我们的书写高质量代码的前提与基础。今天我们更进一步,一起来学习Java编程的命名规范,向着编写高质量代码的终极目标进发。

(一)编程语言的通用规范

在详细介绍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是不应该出现在同一个作用域的。

(二)Java语言编程规范

1.常量命名

常量的每个单词均大写,单词之间使用下划线连接。用大写字母命名常量可以和其他非final型变量相区分开。

class Byte {
  public static final byte MAX_VALUE = 255;
  public static final byte MIN_VALUE = 0;
}

2.变量命名

(1)使用名词来命名变量,变量名中的第一个单词小写,其后的每一个单词的第一个字母大写。

变量就是一个对象、事物,我们使用名称表示。大写能区分名词中的每一个单词,首字母小写则可以区分变量名和类名。

(2)集合引用名要使用复数形式

对象集合的字段和变量的名字要使用集合里包含的对象类型的复数形式,这便于区分多值变量和单值变量。

Customer[] customers = new Customer[MAX_CUSTOMERS];

void addCustomer(int index,Customer customer) {
  this.customer[index] = customer;
}

Vector orderItems = new Vector();

void addOrderItems(OrdetItem orderItem) {
  this.orderItems.addElement(orderItem);
}

(3)为不重要的临时变量建立一套标准名称

大多数变量的名字要使用完整的表述,但是也有很多经常出现的变量使用简写形式。
下面是几个比较常用的例子:

  • 字符--------c,d,e
  • 坐标--------x,y,z
  • 异常--------e
  • 图形--------g
  • 对象--------o
  • 流 ----------in,out
  • 字符串-----s

(4)字段、参数命名

我们在使用构造方法或者set方法给字段赋值时,应该为参数名和字段使用相同名称,在方法内部使用this关键字来区分局部变量和字段变量。

class Student {
  private String name;
  
  public Student(String name) {
    this.name = name;
  }
  
  public void setName(String name) {
    this.name = name;
  }
}

3.方法命名

(1)使用动词命名方法,方法名中的第一个单词小写,其后的每个单词的第一个字母大写。

方法表示动作,采用动词命名。大写可以把名字里的各个单词很明确的区分开,首字母小写则可以将方法调用和构造方法区分开。

class Account {
  private int balance;
  
  public Account(int balance) {
    this.balance = balance;
  }
  
  public void withdraw(int amount) {
    deposit(-1 * amount);
  }
  
  public void deposit(int amount) {
    this.balance += amount;
  }
}

(2)遵循JavaBeans中属性访问函数的方法的命名规范

JavaBeans规范为方法建立了一套命名规范,用来访问JavaBeans实现的属性。在任何类中定义方法都应该使用这些规范,无论是否实现了Bean。
JavaBean用is开头的方法公开boolean属性:

boolean isValid() {
  return this.isValid;
}

JavaBean用get开头的方法对其他属性进行访问:

string getName() {
  return this.name;
}

JavaBean用set开头的方法对属性进行写入操作:

void setName() {
  this.name = name;
}

4.类命名

采用名词命名类,类名中的每个单词的第一个字母大写。

类用来定义对象或者事物,应该采用名词形式。大写可以明显地区分名字中各个单词,首字母大写则可以区分变量名以及类名或者接口名。

class CustomerAccount {
  ···
}

5.接口命名

采用名词或者形容词命名接口,接口中的每个单词的第一个字母大写。

接口描述一个对象的能力或者使声明对象能够提供的服务。

a.使用名词给作为服务声明的接口命名:

public interface ActionListener {
  public void actionPerformed(ActionEvent e);
}

b.使用形容词来为描述某种能力的接口命名:

public interface Runnable {
  public void run();
}

大多数的接口命名都是采用形容词,这些形容词由动词加上able或者ible后缀得来。更能表示接口是表示一种能力的本质含义。

6.包命名

(1)使用单独的小写动词作为每个包的根名

包名里必须包含一个单独的小写词,能够清晰体现包的用途。包名也可以包含一个有实际意义的缩写,例如Java标准包的java.io

(2)用你所在组织的域名的倒序小写的形式作为包名字的根限定词

例如,一个公司的域名为 weikanwave.com,该公司发布了一款名为server的服务器应用程序,那么该公司将该包命名为com.weikanwave.server。
以上内容就是本篇文章的全部内容,如果有补充或者不妥之处还请各位不吝赐教,下一篇我们将学习Java的文档规范。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,319评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,801评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,567评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,156评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,019评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,090评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,500评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,192评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,474评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,566评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,338评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,212评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,572评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,890评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,169评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,478评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,661评论 2 335

推荐阅读更多精彩内容