Java编程风格学习（三）

CoderDock 发布于2019-08-14 17:39 / 1472人阅读

摘要：在上一篇的编程风格学习二中我们学习了一些在编码过程中的格式规范，遵循这些规范毋庸置疑是我们的书写高质量代码的前提与基础。二语言编程规范常量命名常量的每个单词均大写，单词之间使用下划线连接。方法表示动作，采用动词命名。

在上一篇的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的文档规范。

超融合服务器私有云编程风格 php 编程风格 java学习编程学习java编程

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/66724.html

Java编程规范（一）

摘要：最近在看一本有关编程规范的书，书中精炼阐述了使用语言时应该遵循的一些原则。所以拥有良好一致的编程规范对于一个团队至关重要。二坚持最小惊奇原则在编码过程中尽量避免可能让软件用户感到意外的做法。最近在看一本有关Java编程规范的书，书中精炼阐述了使用java语言时应该遵循的一些原则。接下来的一段时间我将在这里总结我的学习内容，也希望这一系列文章能够对有需要的人有所帮助。不考虑任何编码规...

Godtoy 2019-08-16 10:29 评论0 收藏0
几个数据持久化框架Hibernate、JPA、Mybatis、JOOQ和JDBC Template的

摘要：不管是还是，表之间的连接查询，被映射为实体类之间的关联关系，这样，如果两个实体类之间没有实现关联关系，你就不能把两个实体或者表起来查询。因为项目需要选择数据持久化框架，看了一下主要几个流行的和不流行的框架，对于复杂业务系统，最终的结论是，JOOQ是总体上最好的，可惜不是完全免费，最终选择JDBC Template。 Hibernate和Mybatis是使用最多的两个主流框架，而JOO...

xietao3 2019-08-16 15:44 评论0 收藏0
我的2016年Java书单

摘要：相对于电子书，我更喜欢纸质版的书籍。过去的年一共阅读过本技术书，下面对这些书做一个小结。源码深度解析这本书是年购买的，年是第四次阅读。必知必会数据库的复习书籍，内容浅显易懂。相对于电子书，我更喜欢纸质版的书籍。我喜欢在拿到新书时记录购买时间、地点、开始阅读的时间、第一次看完的时间，算是一种学习的记录。过去的2016年一共阅读过15本技术书，下面对这些书做一个小结。《深入理解Java...

Scholer 2019-08-15 12:06 评论0 收藏0
Java 学习资料总结

摘要：三进阶阶段这个阶段主要是靠我们自己学习总结，可以通过前辈们的博客或者自己研究源码，这些非常有利于我们快速的成长。让自己保持永远学习的精神。五零基础学习资料最后给大家准备了一份不错的学习资源，里面有很多学习视频和资料，后台回复资源，即可获取。 showImg(https://segmentfault.com/img/bVbauV8?w=1212&h=816); 前两次给大家分享了关于 j...

FleyX 2019-08-15 17:42 评论0 收藏0