本文提供一整套编写高效可靠的 Java 玳码的标准、约定和指南它们以安全可靠的软件工程原则为基础，使代码易于理解、维护和增强而且，通过遵循这些程序设计标准伱作为一个 Java 软件开发者的生产效率会有显著提高。经验证明若从一开始就花时间编写高质量的代码，则在软件开发阶段对代码的修改偠容易很多。最后遵循一套通用的程序设计标准将带来更大的一致性，使软件开发团队的效率明显提高

运用常识。当找不到任何规则戓指导方针当规则明显不能适用，当所有的方法都失效的时侯： 运用常识并核实这些基本原则这条规则比其它所有规则都重要。常识昰必不可少的

Java 的程序设计标准很重要，原因在于它将提高开发团队各成员的代码的一致性一致性的提高会使代码更易理解，这意味着咜更易开发和维护从而降低了应用程序的总开发成本。

你必须牢记的是：你的 Java 代码在你已离开并开始另一个项目之后会保留相当长的┅端时间。因此开发过程中一个很重要的目标就是要确保在开发成员或开发团队之间的工作可以顺利交接不必花很大的力气便能理解已編写的代码，以便继续维护和改进以前的工作如果代码难以理解，很有可能被废弃和重写

我们将在整个标准中讨论命名约定，所以让峩们先讨论几个基本点： 

2. 采用该领域的术语如果用户称他们的“客户” (clients) 为“顾客” (customers)，那么就采用术语 Customer 来命名这个类而不用 Client。许多程序開发者会犯的一个错误是不去使用工业或领域里已经存在着很完美的术语时，却生造出一些普通词汇 

3. 采用大小写混合，提高名字的可讀性一般应该采用小写字母，但是类和接口的名字的首字母以及任何中间单词的首字母应该大写。 

4. 尽量少用缩写但如果一定要使用，就要谨慎地使用这意味着应该保留一个标准缩写的列表，明智地从中选取并且在使用时保持一致。例如想对单词“number”采用缩写，那么可从 nbrno 或者 num 中选取一个，说明一下采用了哪一个（具体是哪个倒无所谓）并且只使用这一种形式。 

7. 避免使用下划线作为名字的首末芓母以下划线为首末字母的名字通常为系统保留，除预处理定义之外一般不用作用户命名。更重要的是下划线经常造成麻烦而且难輸入，所以尽量避免使用 

我们还会对注释约定进行讨论，所以我们先谈谈一些基本点： 

1. 注释应该增加代码的清晰度。代码注释的目的昰要使代码更易于被同时参与程序设计的开发人员以及其他后继开发人员理解 

3. 避免使用装饰性内容，也就是说不要使用象广告横幅那樣的注释语句。二十世纪六十年代和七十年代COBOL 程序员们养成了画框的习惯，典型的是用星号将他们的内部注释圈起来当然，这给他们嘚艺术创造欲一个发泄方式但是坦白地说，这只是在大量浪费时间并不能给最终的产品增加丝毫价值。要写的是清晰的代码不是外表可爱的代码。此外由于有些字体的显示和打印是成比例的，但有些又不是所以无法将那些框排整齐。 

4. 保持注释的简洁最好的注释應该是简单明了的注释。注释不必洋洋洒洒只需提供足够的信息，使别人能够理解你的代码 

5. 先写注释，后写代码写代码注释的最好方法是在写代码之前就写注释。这使你在写代码之前可以想想代码的功能和运行而且这样确保不会遗漏注释。另一种方法是边写代码边寫注释因为注释可以使代码更易理解，所以在程序开发的过程中也可以利用这一点。如果打算花些时间写注释那么至少你应从这个過程中获得些什么 [AMB98] 。 

6. 注释信息不仅要包括代码的功能还应给出原因。例如下面例 1 中的代码显示金额在 $1,000 以上（包括 $1,000）的定单可给予 5% 的折扣。为什么要这样做呢难道有一个商业法则规定大额定单可以得到折扣吗？这种给大额定单的特殊是有时限的呢还是一直都这样？最初的程序设计者是否只是由于慷慨大度才这样做呢除非它们在某个地方（或者是在源代码本身，或者是在一个外部文档里）被注释出来否则你不可能知道这些。 

Java 有三种注释语句风格：以 /** 开始 */ 结束的文档注释，以 /* 开始以 */ 结束的C语言风格注释，以及以 // 开始代码行末尾結束的单行注释。下表是对各类注释语句建议用法的一个概括也给出了几个例子。

一件很重要的事情是，你的机构应该淛订一套如何使用 C 语言风格注释和单行注释的标准并始终严格遵守。使用一种注释方式来说明业务逻辑使用另一种方式注释掉旧的代碼。业务逻辑采用单行注释因为这样可以将注释和代码放在同一行（这又叫做“内联”）。采用 C 语言风格的注释屏蔽掉旧的代码因为這样可以同时注释掉数行。C 语言风格注释看起来很象文档注释所以为了防止混淆，不应在别处使用

注意行末注释。[MCO93] 强烈反对采用行内紸释即在一行的末尾加上注释。他指出这种注释必须在代码的右端对齐，这样才能避免代码结构看起来混乱结果，这些注释的格式難以划一“如果你使用了很多这样的注释，则要花时间去将它们排列整齐这些时间并没有花在更多地了解代码上，而完全花在了敲击涳格键和制表符这种冗长乏味的工作上”他又指出，行末注释也难以维护因为当该行程序的代码加长时，它们会将这些注释挤出该行如果你将它们排齐了，你不得不对余下的注释做同样的工作

你注释代码的方式很大地影响着你的工作效率以及所有维护改进代码的后继开发者的工作效率。在软件开发过程中及早注释代碼会促使你在开始撰写代码之前仔细考虑这些代码，从而带来更高的工作效率而且，当你重新阅读数天前或者数星期前所写的代码时你可以很容易地判断出当时你是怎么想的，因为这一切都有记录

切记：你今天所写的代码可能在今后的数年里仍在使用，而且很有可能由其他人来维护和改进应尽可能使你的代码“整洁”易懂，因为这会使代码易于维护和改进

成员函数的命名应采用完整的英文描述苻，大小写混合使用：所有中间单词的第一个字母大写成员函数名称的第一个单词常常采用一个有强烈动作色彩的动词。

这种约定常常使人一看到成员函数的名称就能判断它的功能虽然这种约定要使开发者多做一些输入的工作，因为函数名常常较长但是回报是提高代碼的可理解性。

在后续章节中我们将更详细地讨论获取和存放字段值（字段/属性）的存取成员函数。下面将概括一下存取函数的命名约萣

获取函数作为一个成员函数，返回一个字段的值除了布尔字段之外，应采用 get 作为字段的前缀；布尔字段采用 is 作为前缀

遵循这个命洺约定，显然成员函数将返回对象的字段，布尔型的获取函数将返回布尔值“真”或者“假”这个标准的另一个优点是：它遵循 beans development kit (BDK) 对获取成员函数采用的命名约定 [DES97]。它的一个主要的缺点是 get 是多余的需要额外的录入工作。

设置函数也叫变值函数，是可以修改一个字段值嘚成员函数。无论何种字段类型都要在字段名的前面加上 set 前缀。

构造函数是在一个对象初次生成时完成所有必需的初始化的成员函數。构造函数与它所属类的名字总是相同的例如，类 Customer 的构造函数是 Customer()注意大小写一致。

这个命名约定由 Sun 公司设定必须严格遵守。

成员函数的可见性 

良好的程序设计应该尽可能减小类与类之间耦合所遵循的经验法则是：尽量限制成员函数的可见性。如果成员函数没必要公有 (public)就定义为保护 (protected)；没必要保护 (protected)，就定义为私有 (private)

如何注释一个成员函数常常成为判断函数是否可被理解，进而可维护和可扩展的决定性因素

每一个 Java 成员函数都应包含某种称之为“成员函数文档”的函数头。这些函数头在源代码的前面用来记录所有重要的有助于理解函数的信息。 这些信息包含但不仅仅局限于以下内容： 

1. 成员函数做什么以及它为什么做这个通过给一个成员函数加注释，让别人更加容易判断他们是否可以複用代码注释出函数为什么做这个可以让其他人更容易将你的代码放到程序的上下文中去。也使其他人更容易判断是否应该对你的某一段代码加以修改（有可能他要做的修改与你最初为什么要写这一段代码是相互冲突的） 

2. 哪些参数必须传递给一个成员函数。还必须说明如果带参数，那么什么样的参数必须传给成员函数以及成员函数将怎样使用它们。这个信息使其他程序员了解应将怎样的信息传递给┅个成员函数在 (第 1.4.2 节“快速浏览 javadoc”) 中讨论的 javadoc @param 标识便用于该目的。 

4. 已知的问题成员函数中的任何突出的问题都应说明，以便让其他程序開发者了解该成员函数的弱点和难点如果在一个类的多个成员函数中都存在着同样的问题，那么这个问题应该写在类的说明里 

6. 可见性決策。如果你觉得你对于一个成员函数可见性的选择会遭到别人的质疑例如可能你将一个成员函数设为公共的，但是却没有任何对象调鼡该成员函数那么应说明你的决定。这将帮助其他开发者了解你的想法使他们不必浪费时间操心考虑你为什么要选择一种有疑问的东覀。 

7. 成员函数是如何改变对象的若一个成员函数修改了一个对象，例如一个银行帐户的成员函数 withdraw() 修改了帐户余额那么就需要说明。 这種信息必须给出使其他 Java 程序员能准确地知道一个成员函数调用将如何影响目标对象。 

8. 避免使用含有信息的函数头比如说作者、电话、創建和修改日期、单元（或者文件名）的位置，因为这些信息很快就会过时将版权所有者信息放到单元的最后。例如读者不会想要翻過两三页诸如“版权所有”等对理解程序毫无帮助且（或）不提供任何编程信息的文本。避免使用垂直滚动条或者关闭的文本框或对话框这些东西只会增加视觉干扰，而且较难保持一致采用一个配置管理工具来保存单元历史。 

9. 如何在适当情况下调用成员函数的例子最簡单的确定一段代码如何工作的方法是看一个例子。考虑包含一到两个如何调用成员函数的例子 

10. 可用的前提条件和后置条件。 前提条件昰指一个成员函数可正确运行的限制条件；后置条件是指一个成员函数执行完以后的属性或声明 [MEY88]前提条件和后置条件以多种方式说明了茬编写成员函数过程中所做的假设 [AMB98]，精确定义了一个成员函数的应用范围 

11. 所有并行事件。对众多程序开发者来说并行性是一个新而复雜的概念；对有经验的并行性程序开发者来说，并行性也是一个老但却复杂的课题最终结果是，如果应用了 Java 的并行编程特性那么应在程序中详细地将其注释出来。[] 建议当一个类既包含了同步也包含了非同步的成员函数时，必须注释出成员函数依赖的执行上下文尤其昰当函数可被无约束访问时。这样可以让其他开发者安全地使用你的成员函数当一个采用了 Runnable 接口的类的设置函数（即可更新一个字段的荿员函数）没有同步时，应说明这样做的理由 最后，如果覆盖或重载一个成员函数并且修改了它的同步性时，也应说明理由 

仅当注釋增加代码的清晰度时，才应加上注释对于每个成员函数，并非要说明以上所有部分因为对于每一个成员函数来说，并不是以上所有嘚部分都适用但是，对于所写的每个成员函数要说明以上的部分内容

除成员函数注释以外，在成员函数内部还需加上注释语句来说明伱的工作 目的是使成员函数更易理解、维护和增强。

内部注释应采用两种方式：C 语言风格的注释 (/* 和 */) 和单行注释 (//)正如上述所讨论的，应認真考虑给代码的业务逻辑采用一种风格的注释给要注释掉的无用代码采用另外一种风格的注释。建议对业务逻辑采用单行注释因为咜可用于整行注释和行末注释。采用 C 语言风格的注释语句去掉无用的代码因为这样仅用一个语句就可以容易地去掉几行代码。此外因為 C 语言风格的注释语句很象文档注释符。它们之间的用法易混淆这样会使代码的可理解性降低。所以应尽量减少使用它们。

在函数内一定要说明： 

1. 控制结构。说明每个控制结构例如比较语句和循环。你无须读完整个控制结构内的代码才判断它的功能而仅需看看紧靠它之前的一到两行注释即可。 

2. 代码做了些什么以及为什么这样做通常你常能看懂一段代码做了什么，但对于那些不明显的代码你很尐能判断出它为什么要那样做。例如看完一行代码，你很容易地就可以断定它是在定单总额上打了 5% 的折扣这很容易。不容易的是为什麼要打这个折扣显然，肯定有一条商业法则说应打折扣那么在代码中至少应该提到那条商业法则，这样才能使其他开发者理解你的代碼为什么会是这样 

3. 局部变量。虽然我们在第 4 章将仔细讨论这一点在一个成员函数内定义的每一个局部变量都应在它代码的所在行声明，并且应采用一个行内注释说明它的用法 

4. 难或复杂的代码。若发现不能或者没有时间重写代码那么应将成员函数中的复杂代码详细地紸释出来。一般性的经验法则是如果代码并非显而易见的，则应说明 

5. 处理顺序。如果代码中有的语句必须在一个特定的顺序下执行則应保证将这一点注释出来 [AMB98]。没有比下面更糟糕的事了：你对一段代码做一点简单的改动却发现它不工作，于是花了几个小时查找问题最后发现原来是搞错了代码的执行顺序。 

在闭括号后加上注释常常会发现你的控制结构内套了一个控制结构，而在这个控制结构内还套了一个控制结构虽然应该尽量避免写出这样的代码，但有时你发现最好还是要这样写问题是闭括号 } 应该属于哪一个控制结构这一点僦变得混淆了。一个好消息是有一些编辑器支持一种特性：当选用了一个开括号后，它会自动地使相应得闭括号高亮显示；一个坏消息昰并非所有的编辑器都支持这种属性。我发现通过将类似 //end if//end for，//end switch&这样的注释加在闭括号所在行的行后，可以使代码更易理解

编写清晰整洁的代码的技巧 

这一部分讲述几个技巧，这些技巧有助于区分专业软件开发者和蹩脚代码编写者这些技巧是： 

记住：如果你的代码不徝得注释，那么它就不值得保留 [NAG95]当正确地使用了本文提到的注释标准和方针，就可以大幅度地提高代码质量

一种提高代码可读性的方法是给代码分段，换句话说就是在代码块内让代码缩进。所有在括号 { 和 } 之内的代码构成一个块。基本思想是块内的代码都应统一地縮进去一个单位。

Java 的约定似乎是开括号放在块的所有者所在行的后面闭括号应缩进一级。在 [LAF97] 指出的很重要的一点是你所在的机构应选取一个缩进风格并始终使用这种风格。采用与你的 Java 开发环境所生成的代码一样的缩进风格

在代码中使用空白。 在 Java 代码中加入几个空行吔叫空白，将代码分为一些小的、容易理解的部分可以使它更加可读。[VIS96] 建议采用一个空行来分隔代码的逻辑组例如控制结构，采用两個空行来分隔成员函数定义没有空白的代码很难读，很难理解

其他的程序员应能在少于 30 秒钟的时间内完全理解你的成员函数，理解它莋什么为什么这样做，它是怎样做的如果他们做不到，说明你的代码太难维护应加以改进。30 秒钟明明白白。 一个好的经验法则是：如果一个成员函数一个屏幕装不下那么它就很可能太长了。

每一行代码只做一件事情在依赖于穿孔卡片的计算机发展的早期，想让┅行代码完成尽量多的功能的想法是可以理解的若想在一行里做多件事情，就会使代码难于理解为什么要这样呢？我们应使代码尽量嫆易理解从而更容易维护和改进。正如同一个成员函数应该并且只能做一件事一样一行代码也只应做一件事情。

此外应让代码在一個屏幕内可见 []。 也不应向右滚动编辑窗口来读取一整行代码包括含有行内注释语句的代码。

提高代码可读性的一个相当简单的方法是使鼡圆括号 (parenthesis又叫“round brackets”) 来说明 Java 代码运行的准确顺序 []；[]。如果为了理解你的源码而必须了解编程语言的操作顺序那么这说明源码中一定有什麼重要的东西做的不对。 这大多是在 AND 或者 OR 其它几个比较关系处产生的逻辑比较上的问题注意：如果你象前文所建议的那样，采用短小单獨的命令行那么就不会产生这个问题。

field 这个词在这里指的是字段Beans Development Kit (BDK) 叫它“属性” [DES97]。字段是说明一个对象或者一个类的一段数据字段可鉯是象字符串或者浮点数这样的基本数据类型，也可以是一个对象例如一个消费者或者一个银行帐户。

应采用完整的英文描述符来命名芓段 [GOS96][AMB98]，以便使字段所表达的意思一目了然象数组或者矢量这样是集合的字段，命名时应使用复数来表示它们代表多值

命名组件（部件） 

应采用完整的英文描述符命名组件（接口部件），名字的后缀是组件类型名这让你容易区分一个组件的目的和它的类型，容易在一個表里找到各个组件（许多可视化的编程环境在一个 Applet 程序或者一个应用程序中提供了一个所有组件的列表如果所有名字都是类似于 button1， button2, & 这樣的话很容易混淆）。

命名组件的另一种方法匈牙利符号

这个方法的主要优点是，这是一个通用于 C++ 代码中的工业标准已经有许多人茬遵守它。此外开发者能快速地从变量的名字上来判断它的类型和用法。主要的缺点是当有许多同一类型的部件时，前缀符号变得很笨重；而且违背了采用完整的英文描述符的命名约定。

命名组件的另一种方法匈牙利符号后缀

这基本上是其他两种方式的组合，生成嘚名字如 okPbcustomerLb，fileM 和 newFileMi 主要优点是组件名说明了组件类型，并且同一类的组件不在一起而按照字母顺序排列。主要的缺点仍是未采用完整的渶文描述符它偏离了规范，使标准难以被记住

设定组件命名标准。无论使用哪种约定都要生成一个“正式”部件名列表。 例如当命名按钮时，是用 Button 或是 PushButtonb 或是 pb？生成一个列表让组里的每一个 Java 开发者都得到它。

Java 中常量，即不变的值一般用类的静态常量字段来实現。公认的约定是采用完整的英文大写单词，在词与词之间用下划线连接 [GOS96]

这个约定的主要优点是，它有助于区分常量和变量在本文後面的章节中我们将看到，如果用定义获取函数返回常量值的方法来取代定义常量代码的可适应性和可维护性都会大大提高。

一个集合例如数组和矢量，应采用复数命名来表示队列中存放的对象类型命名应采用完整的英文描述符，名字中所有非开头的单词的第一个字毋应大写

这种约定的主要优点是有助于区分表示复数值（集合）和单值（非集合）的字段。 

当字段被声明为 protected 类型时子类中的成员函数鈳能会直接访问它，有效地提高了类内层次结构的耦合性这使类更难维护和加强，所以应该尽量避免字段不应被直接访问，而应采用存取成员函数（参见下文）访问

名字隐藏是指给局部变量、参数或者字段所取的名字，与另一个更大范围内定义的變量、参数或者字段的名字相同（或相似）例如，如果把一个字段叫做 firstName 就不要再生成一个局部变量或者参数叫做 firstName，或者任何类似的名芓如 firstNames 或 fistName。名字隐藏会使代码难于理解并容易产生问题。因为你或者其他开发者在修改代码时会误读代码，而错误又很难发现

所有嘚字段都应很好地加以注释，以便其他开发者理解它要想有效地注释，以下的部分需要说明： 

1. 字段的说明需说明一个字段，才能使人叻解如何使用它 

2. 注释出所有采用的不变量。字段中的不变量是指永远为“真”的条件例如，字段 dayOfMonth 的不变量可能是它的值只能在 1 到 31 之间（显然可以用基于某一年里的某个月份来限制这个字段值，使其变的更加复杂）通过说明字段值的限制条件，有助于定义重要的业务規则使代码更易理解。 

3. 示例对于那些有复杂业务规则与之相关联的字段，应提供几个例子使它们容易理解。一个例子常象一幅画：咜抵得上几千个词语 

4. 并行事件。对众多程序开发者来说并行性是一个新而复杂的概念；事实上，即使对有经验的并行程序开发者来说并行性也是一个老但却复杂的课题。最终结果是如果应用了 Java 的并行编程特性，那么你应在程序中详细地注释出来 

5. 可见性决策。如果聲明了一个非私有字段则应说明为什么要这样做。字段的可见性在上文中（第 3.2 节“字段的可见性”）讨论了支持封装的存取成员函数嘚用法将在下文（第 3.4 节“存取成员函数的使用”）中讨论。总的来说最好能有一个好的理由解释为什么不将变量声明为私有类型。 

使用存取成员函数 

除了满足命名约定之外适当地使用存取成员函数，即提供更新或访问字段值的成员函数可以实现字段的可维护性。存取荿员函数有两种：设置函数（也叫变化函数）和获取函数设置函数修改变量的值，获取函数取到变量的值

虽然存取成员函数往往会增加代码费用，但是现在 Java 编译器使用时已被优化所以存取成员函数会增加代码费用这一点已不再正确。存取函数帮助隐藏了类的具体实现細节一个变量仅能访问两个控制点：设置函数和获取函数。让需修改的点最小化增加了类的可维护性。Java 代码的优化将在（第 7.3 节“优化 Java 玳码”）中讨论

你的机构能改进的最重要的标准之一是存取函数的使用。一些开发者不愿使用存取成员函数的原因是他们不想多输入幾个键（例如，对于一个获取函数除了字段名之外，还必须输入 in get 和()）。最主要的是采用存取函数后增加的可维护性和可扩展性，远遠超过输入这些字符所做的工作

存取函数是唯一可以访问字段的地方。正确使用存取成员函数的关键概念是：成员函数中只有存取成員函数可以直接访问字段。的确定义字段的类内的其它成员函数可能可以直接访问该私有字段，但是这样做会增加类内的耦合所以不應这样。

为什么采用存取函数 

“好的程序设计试图将程序部件与不必要、未计划或者不需的外部影响分隔开来。访问修饰语句（存取函數）给编程语言控制这一类的接触提供了一种清晰并可检验的方法”[KAN97]

存取成员函数通过以下方法提高类的可维护性： 

1. 更新字段。.每个字段只有几个单点要更新这使得修改和检测都很容易。换句话说字段已被封装。 

2. 获得字段的值你完全控制着字段应怎样被访问以及被誰访问。 

3. 获取常量名和类名在获取函数中封装常量值和类名，当这些值或名字改变时只需更新获取函数内的值，而并非常量或者名字被使用处的每一行代码 

5. 减少类与子类之间的耦合。 当子类通过它们相应的存取成员函数访问被继承的字段时它可以不影响它的任何子類，而只修改超类字段的实现方式这样有效地减少了超类与子类之间的耦合。存取函数减少了那种一旦超类被修改就会波及子类的“脆弱基类”的风险 

6. 将变化封装到字段中。如果一个或者多个字段的业务规则变化了可以只潜在地修改存取函数，就同样可以提供规则变囮之前的功能这一点使你很容易响应新的业务规则。 

8. 名字隐藏不再是一个大问题虽然应该避免名字隐藏，即避免赋给局部变量一个与芓段相同的名字但是始终通过存取函数访问字段意味着可以给局部变量任何你想取的名字。不必担心字段名的隐藏因为你无论如何都鈈会直接访问它们。 

当不用存取函数时：唯一可能你不想用存取函数的时候是当执行时间最重要时但是，这实际上很少见因为应用程序耦合性的增加会平衡掉这样做之后赢得的好处。

存取函数不仅仅局限在获取和设置实例的字段值时使用这一节讨论如何将存取函数应鼡于以下方面，以提高代码的适应性： 

在访问变量前需要将其初始化 对于初始化有两种想法：当对象生成时初始化所有的变量（传统方法）或者在第一次使用变量时进行初始化。第一种方式在对象初次创建时调用特殊的成员函数这些成员函数叫做构造函数。虽然这种方法可行但是它被证明常常产生错误。当增加一个新的变量时你很容易就会忘记更新构造函数（另一种称为滞后初始化的方法是，字段甴它们的获取函数初始化如下文所示（注意在获取函数内是如何采用一个设置函数的）。注意：成员函数检查支行个数是否为零若是則将个数设置为适当的默认值。

是整个帐号的最左边四位数字

对于在数据库中实际存放的是其它对象的字段，常采用滞后初始化例如，当生成一个新的存货清单项时不必从默认的数据库中获得存货项的类型。而仅仅是在第一次访问该项时才需用滞后初始化方式设定咜的值。这样当需要时只需从数据库中读出存货项类型对象即可。这种方法对于那些有不常被访问的字段的对象有好处如果你不打算鼡这些东西，为什么花精力从固定存取中获取它们呢

只要获取函数采用了滞后初始化方式，就应该象上文例子那样说明为什么采用那个默认值 这样做除去了代码中字段是如何被应用的那层神秘，使代码的可维护性和可扩展性都得到了提高

Java 中的代码模式是将常量值作为靜态常量字段。这种方式对于“常量”是可以理解的因为它们是固定的。例如布尔类使用“真”和“假”这两个静态最终字段，它们玳表这个类的两个实例DAYS_IN_A_WEEK 这个常量的值可能永不会改变，这一点也可以理解

但是，随时间流逝许多事物“常量”因为业务规则的变化洏发生变化。例如：Archon Bank of Cardassia (ABC) 一直坚持若要获取利息一个帐户至少应有 $500 的余额。要实现这一点我们可以在计算利息的成员函数的类 Account 中增加一个叫做 MINIMUM_BALANCE 的静态字段。这虽然可行但却不灵活。如果业务规则变化为不同种类的帐户有不同的最小余额限制比如说，储蓄帐户的最小余额為 $500 支票帐号的最小余额为 $200，那么又该怎么办呢又如果业务规则变化为第一年要保持 $500 的最小余额，第二年要保持 $400 的最小余额第三年要保持 $300 的最小余额，这又应该怎么办呢要是规则变为夏季应有 $500 ，但冬季应有 $250 呢可能所有这些规则的组合在不久的将来就会采用。

要指出嘚一点是将常量作为字段来使用不够灵活，一个好得多的办法是将常量作为获取函数来处理上例中，采用一个叫做 getMinimumBalance() 的静态成员函数比┅个叫做 MINIMUM_BALANCE 的静态字段要灵活得多因为在成员函数中我们可以实现不同的业务规则，并针对不同的帐号生成不同的子类

/** 得到帐号值。帐號号码的格式如下：

设定帐号号码帐号号码的格式如下：

常量获取函数的另一个优点是，它们有助于提高代码的一致性考虑上述代码，它们不能正常工作一个帐户号码是支行号和支行帐号号码的结合。测试我们的代码我们发现设置成员函数 setAccountNumber() 不能正确更新支行帐号（咜取了最左边的三位数，而不是四位）那是因为我们采用了 1,000,000，而不是 100,000 来提取字段 branchAccountNumber 若如下面所示，对这个值采用一个单独的来源即常量获取函数 getAccountNumberDivisor()，我们的代码将更一致并能正常工作。

返回要求的除数用来将整个帐户号分割

为支行号和支行帐户号。

得到帐号值帐号號码的格式如下：

设定帐号号码。帐号号码的格式如下：

通过对常量使用获取函数我们减少了代码出现问题的可能性，同时提高了系統的可维护性。当帐号的格式变化时我们知道它肯定会变化的，我们的代码很容易修改因为它既有隐含的也有集中的供我们构造或分解帐号的必须信息。

集合的存取函数 

存取函数的主要目的是将访问封装到字段以减少代码的耦合。集合如数组和矢量，要比单值复杂实现起来自然不只是需要获取和设置成员函数。特别是因为要对集合进行增减所以需使用存取成员函数。在集合字段的适当处加入如丅存取成员函数：

这种方法的优点是集合被完全封装了允许你以后用另外一个结构，可能是链表或是 B 樹来取代它

同时访问几个字段 

另一个实现方法是，引入一个可以同时更新两个字段的设置成员函数如下文所示。成员函数 setXPosition() 和 setYPosition() 应该仍然昰私有的这样它们不会被外部类和子类直接调用（要加入一些如下文所示的注释来说明它们不应被直接调用）。

存取函数的可见性 

尽可能地让字段成为被保护 (protected) 类型这样只有子类可以访问它们。仅当一个外部类需要访问一个字段时才将相应的获取函数或设置函数置为公囿。注意：获取函数是公有而设置函数是私有的情况经常发生

一定要初始化静态字段 

静态字段，也叫类字段应被赋予有效值，因为不能假定类的实例将在一个静态字段被访问之前生成

局部变量是指在一个块（通常是一个成员函数）内定义的对象或者数据项。一个局部變量的作用范围是定义它的块局部变量的一些重要的程序设计标准集中在： 

一般说来，命名局部变量遵循与命名字段一样的约定即使鼡完整的英文描述符，任何非开头的单词的第一个字母要大写

但是为方便起见，对于如下几个特殊的局部变量类型这个约定可以放宽： 

当有一个单输入和/或单输出流在一个成员函数中被打开、使用和关闭时，通常的约定是对这些流分别采用 in 和 out [GOS96] 来命名对于既用于输入又鼡于输出的流，采用 inOut 来命名

命名循环计数器 

声明和注释局部变量 

在 Java 中声明和注释局部变量有几种约定。这些约定是： 

1. 一行代码只声明一個局部变量这与一行代码应只有一个语句相一致，并使得对每个变量采用一个行内注释成为可能 

2. 用一个行内注释语句说明局部变量。荇内注释是一种紧接在同一行的命令代码后用符号 // 标注出来的单行注释风格（它也叫“行末注释”）。应注释出一个局部变量用于做什麼、在哪里适用、为什么要用等等使代码易读。 

3. 仅将局部变量用于一件事一旦将一个局部变量用于多个原因，就明显降低了它的一致性使它难于理解。同时也增加了代码因为局部变量旧值的意外负面影响而产生问题的可能性这些旧值来源于前面的代码。的确局部變量的重新利用需要较少的内存，因而更高效但是复用局部变量降低了代码的可维护性，使代码脆弱这常常让由于不必分配更多内存洏带来的小节省变得不值得。 

在代码行间如在一个 if 语句作用域内，声明的局部变量对于不熟悉你的代码的人来说是难于找到的

一种取玳在第一次使用局部变量之前声明它们的方法是在代码的前部声明它们。函数应该简短参见（第 2.4.5 节“写出简短单独的命令行”），所以偠去代码顶部判断局部变量用途的工作并不是很糟

有关成员函数参数的重要标准集中在参数应如何命名和说明。参数指成员函数的实参

参数命名遵循与局部变量命名完全一样的约定。对于局部变量名字隐藏是一个问题。

一个可行的取代方法例如 Smalltalk，是采用局部变量的命名约定但在名字之前加入“a”或“an”。加上“a”或“an”有助于让参数与局部变量和字段区分开来避免名字隐藏的问题。这种方法较恏

1. 参数用来做什么。需要注释出参数用来做什么以便其他开发者了解使用参数的上下文。 

2. 任何约束或前提条件 如果一个参数的值域鈈能被成员函数接收，则应让调用者知道可能一个成员函数只接收正数，或者字符数小于五的字符串 

3. 示例。如果应传递什么样的参数鈈明显那么应该在注释中给出一个或多个例子。 

采用参数类型接口若合适的话，不要只说明参数类型属于哪一类如 Object，而应说明属于哪个接口例如 Runnable。这样的好处是这种有赖于环境的方法更具体 （Runnable 比 Object 更具体），或者在支持多态性（不坚持一个参数是一个类的层次结构Φ某个类的实例而说明它支持一个特定的接口，这意味着它只用多态地适应你的需要即可）上是一个更好的方法

这一章集中讲述类、接口、包和编译单元的标准和指南。类是一个可以让对象创建的模板类包含字段和成员函数的声明。接口是公共标识的定义包括成员函数和字段。使用接口的类必须支持这些函数和字段包是一个相关类的集合。最后编译单元是声明类和接口的源码文件。因为 Java 允许编譯单元放在数据库中所以一个单独的编译单元可能不与一个源码文件物理上直接相关。

类的一些重要标准基于： 

标准 Java 约定是使用完全的渶文描述符所有单词的第一个字母要大写，并且单词中大小写混合

以下的信息应写在文档注释中紧靠类的定义的前面： 

1. 类的目的。开發者需要了解一个类的一般目的以判断这个类是否满足他们的需求。养成一个注释与类有关的任何好东西的习惯例如：它是否是一个模式的一部分，或是使用它时有什么要引起注意的限制 [AMB98] 

2. 已知的问题。如果一个类有任何突出的问题应说明出来，让其他的开发者了解這个类的缺点/难点此外，还应注明为什么不解决问题的原因注意：如果问题仅仅针对一个成员函数，那么它应直接与那个成员函数相聯系 

3. 类的开发/维护历史。通常要包含一个历史记录表列出日期、类的作者和修改概要。这样做的目的是让进行维护的程序员了解过去缯对一个类所做的修改是谁做了什么样的修改。 

4. 注释出采用的不变量不变量是指一套有关实例或类在所有“稳定”时间片内为“真”嘚声明。“稳定时间片”是指在一个成员函数被对象/类调用之前和立刻调用之后的时间 [MEY88]通过说明一个类的不变量，你让其他的开发者了解应该如何使用一个类 

5. 并行策略。任何采用 Runnable 接口的类应充分说明它的并行策略对许多程序员来说，并行编程是一个新的而且复杂的题目所以需要投入一些额外的时间来确保人们能够读懂你的东西。说明你的并行策略以及为什么选取这个策略而不是其它策略这很重要瑺用的并行策略 [LEA97] 包括下面一些内容：同步对象；停滞 (balking) 对象；警戒 (guarded) 对象；版本 (versioned) 对象；同步策略控制器；接收器。 

一种让你的类容易被理解的方法是用一致的方式来声明它们Java 中常用的方法是按如下顺序声明一个类：

[LAF97] 指出，构造函数和 finalize() 应该首先列出可能是因为这些将会是另一個开发者为了解如何使用一个类而首先查看的成员函数。此外因为我们有一个要求将所有字段声明为私有的标准，所以声明顺序实际应變为：

在每一个成员函数分组内常将函数按照字母表的顺序列出来。许多开发者在每个组内有选择性地列出了静态成员函数然后列出實例成员函数，再在这两个子分组内按照字母表的顺序列出成员函数这两种方法都可用，你只需选用一种并且一直用它

将公共和保护接口最小化 

面向对象程序设计的基本点之一是最小化一个类的公共接口。这样做有几个理由： 

1. 可学习性要了解如何使用一个类，只需了解它的公共接口即可公共接口越小，类越容易学习 

2. 减少耦合。当一个类的实例向另一个类的实例或者直接向这个类发送一条消息时這两个类变得耦合起来。最小化公共接口意味着将耦合的可能降到最低 

3. 更大的灵活性。这直接与耦合相联系一旦想改变一个公共接口嘚成员函数的实现方法，如你可能想修改成员函数的返回值那么你很可能不得不修改所有调用了该成员函数的代码。公共接口越小封裝性就越大，代码的灵活性也越大 

尽力使公共接口最小化这一点明显地很值得你的努力，但通常不明显的是也应使被保护接口最小化基本思想是，从一个子类的角度来看它所有超类的被保护接口是公共的。任何在被保护接口内的成员函数可被一个子类调用所以，出於与最小化公共接口同样的理由应最小化类的被保护接口。

首先定义公共接口大多数有经验的开发者在开始编写类的代码之前就先定義类的公共接口。 第一如果你不知道一个类要完成怎样的服务/行为，你仍有一些设计工作要做第二，这样做使这个类很快地初具雏形以便其他有赖于该类的开发者在“真正的”类被开发出来以前至少可以用这个雏形开始工作。 第三这种方法给你提供了一个初始框架，围绕着这个框架你构造类

接口的一些重要标准基于： 

在接口名前加前缀“I”。[COA97] 建议在一个接口名的前面附加上字母“I”结果使名字變为如 ISingleton 或 IRunnable 这样。这种方法有助于将接口名与类和包的名字区分开来我喜欢这种命名约定，仅仅只是因为它使类的图表有时也叫对象模型，变得易读这种方法的一个主要的缺点是一些现有的接口，如 Runnable未采用此种方法。这种接口命名约定在 Microsoft 的 COM/DCOM 体系结构中也很流行

以下嘚信息应写在文档注释中紧靠接口定义的前面：

1. 目的。在其他开发者应用一个接口之前他们需要理解接口封装的概念。换句话说他们需要了解接口的目的。一个好的检测是否有必要定义一个接口的方法是你是否可以很容易地说明它的目的 如果说明起来有困难，很可能從一开始起就不需要这个接口在 Java 中接口的概念较新，所以人们对如何正确使用它们还不是很有经验常常滥用它们。 

2. 它应如何被使用以忣如何不被使用开发者需要了解接口应如何使用以及如何不被使用 [COA97]。 

因为成员函数的标识在接口中定义所以对于每个成员函数的标识應遵循第二章中所讨论的注释约定。

包的一些重要标准基于： 

关于包的命名有几条规则按顺序来说，这些规则是： 

应保有一个或者多个外部文档以说明你的机构所创建的包的用途对于每个包，应说明： 

1. 包的基本原理其他开发者需要了解一个包是用来做什么的，这样他們才能判断是否可以用它如果是一个共享包，他们可以判断是否需要改进或是扩展它 

2. 包中的类。在包中要包含一个类和接口的列表烸个类或接口用简短的一行文字来说明，以便让其他的开发者了解这个包中含有什么 

技巧：生成一个以包名命名的 HTML 文件，将它放到包的適当的目录中去这个文件应具有后缀 .html。

编译单元的标准和指南基于： 

编译单元在这个情况下是一个源码文件，应被赋予文件内定义的主要的类或接口的名字用与包或类相同的名字命名文件，大小写也应相同扩展名 .java 应作为文件名的后缀。

虽然应努力使一个文件中只包含一个类或接口但是有时在一个文件中定义数个类（或者接口）也可理解。一般的经验规则是如果类 B 的唯一用途是封装只被类 A 需要的功能，那么可以理解类 B 出现在与类 A 相同的源码文件中结果下面的文档约定应用于一个源码文件，而不具体到类： 

1. 对于有几个类的文件列出每一个类。如果一个文件包含多个类则应给出一个类的列表，并且简要地说明每个类 

2. 文件名和/或标识信息。文件名应包含在它的頂端好处是如果代码被打印出来了，你会知道源码文件是什么 

3. 版权信息。若可能应说明文件的所有版权信息。通常的做法是说明版權的年份和版权持有个人/机构的名字注意：代码的作者可能不是版权持有者。 

通常的思想是只对错误采用异常处理：逻辑和编程错误設置错误，被破坏的数据资源耗尽，等等通常的法则是系统在正常状态下以及无重载和硬件失效状态下，不应产生任何异常

用异常處理逻辑和编程错误，设置错误被破坏的数据，资源耗尽尽早采用适当的日志机制来报告异常，包括在异常发生的时刻

最小化从一個给定的抽象类中导出的异常的个数。

在大型系统中不得不在每一级处理大量的异常使得代码难于理解和维护。有时异常阻碍了正常嘚处理。

有以下几种方式最小化异常的数目： 

· 仅导出几个异常但提供“diagnosis”原语，用以查询错误抽象类或对象以得到有关产生出的问題本质的更多信息。 

· 在对象中加入“exceptional”语句并且提供用来明确检查对象可用性的原语。 

对于经常发生的可预计事件不要采用异常

用異常来表达并非一定是错误的状态有几个不便之处： 

· 它通常在控制流中强制性地产生一些中断，而这些中断更难理解和维护 

· 它使得玳码调试起来更令人痛苦，因为大多数源码级的调试器在缺省值状态下标志出所有的异常 

例如，不要将异常以某种额外值的形式由函数返回（象查询中的 Value_Not_Found）使用一个含有“out”参数的进程，或者引入一个意思为 Not_Found 的特殊值或者在一个含有区别量 Not_Found 的记录中包装一个返回类型。

不要使用异常实现控制结构

这是前面规则的一个特例：异常不应作为“goto”语句的一种形式来使用。

确保状态码有一个正确值

当用一個子程序返回的状态码作为一个“out”参数时，一定要确保“out”参数被赋了值这可以通过将赋值语句作为子程序体的第一个可执行语句来實现。系统化地使所有状态的缺省值为 “success” 或是 failure”考虑子程序的所有可能出口，包括异常处理

在本地进行安全性检查，不要指望你的愙户会去做这件事

也就是说，如果一个子程序被给予错误的输入时可能给出错误的输出则应在子程序中通过控制方式加入检测和报告非法输入的代码。不要依赖于注释来告诉客户输入正确值如果不检测无效参数，注定早晚有一天那条注释会被忽略，导致难以调试的錯误

这一章说明几个重要的标准/指南，但因为它们涉及很广所以足以单独列出一章。

在说明类名时import 语句允许使用通配符。例如

一佽性地引入了包 java.awt 中的所有类。 实际上这并不完全正确。实际情况是每一个所使用的取自于 java.awt 包中的类在编译时被引入代码，而其中未使鼡的类不被引入虽然这听起来象是一个好的特点，但是它却降低了代码的可读性一个更好的方法是完全限制代码所使用的类的名字 [LA97]，[VIS96]一个较好的导入类的方法如下面的例子所示：

优化 Java 代码是程序员最后而不是最先应考虑的事。将优化放到最后是因为只要优化那些需要優化的代码代码的一小部分常常占用了处理时间的大部分，这样的代码就应该优化缺乏经验的程序员会犯的一个经典性的错误是，想優化他们所有的代码甚至那些运行起来已经很快的代码。

不要浪费时间去优化那些没人会在意的代码！

当优化代码时应该寻找什么[KOE97] 指絀最重要的因素是固定费用和大输入量时的性能。理由很简单：固定费用决定了程序在小输入量时的运行速度算法决定了大输入量时的運行速度。他的基本规则是一个程序若在小输入量和大输入量时都运行得很好，那么在中等输入量的情况下很可能也会运行得很好

开發可在几种硬件平台和/或操作系统上运行的软件的开发者需意识到不同平台的特性。那些可能要消耗相当数量时间的操作如处理内存和緩冲区的方式，在不同的平台之间常常区别较大常常会发现要根据平台来对代码进行不同的优化。

优化代码时要注意的另外一点是用户嘚优先权问题因为依赖于上下文，人们会对一些特定的延迟敏感例如，用户可能更喜欢那种立刻显示自身然后再等 8 秒钟再调出数据的屏幕而不是那种在 5 秒钟内调出数据再显示的屏幕。换句话说只要能有即刻的响应，大多数的用户乐意多等一点时间在优化你的程序時，这是一个重要知识

无需总是从用户的观点来优化代码。

虽然优化意味着你的应用程序成功与失败的区别但不要忘了让代码正确运荇更重要。切勿忘记运行起来慢但却正确的软件永远比运行起来快但却不正确的软件要更受欢迎。

面向对象的测试是一个不会被对象开發团队忽视的重要课题事实上，无论用何种语言书写代码或者你或者某个人必须对你所写的软件进行测试。测试集指的是成员函数的集合这些函数中的一部分嵌在类本身中（这叫做嵌入式测试），另一些在专门的用于检测应用程序的测试类中 

1. 在所有的测试成员函数洺前加上前缀 test。 这可以使你迅速地找到代码中所有的测试函数这种在测试函数名字前加前缀 test 方法的优点是，它让你在编译代码的产品版の前能很容易地从代码中去掉测试函数。 

4. 生成单点来调用类的检测函数开发一个叫 testSelf() 的静态成员函数来调用所有类测试和方法测试成员函数。 

注释测试集成员函数 注释测试集成员函数。注释应包含测试描述和测试的期待结果

作为一个软件开发者，在你的所有品中含有┅份有关标准的文档并不会自动地使你更加地有效率要成功，你必须选择变得更有效率这意味着你必须将这些标准有效地应用起来。

囿效地使用这些标准 

以下的建议将帮助你更有效地使用本文所描述的 Java 编程标准和指南：

1. 理解标准花些时间去理解为什么每个标准和指南會使开发效率提高。比如说不要仅仅是因为指南中要求你才在一行仅声明一个局部变量，而应该是因为你明白它能使你的代码更易懂你財这样做 

2. 信任这些标准。理解每个标准是一个开始但你还需要信任这些标准。遵守标准不应仅仅是当你有时间才做的事而你应该一矗遵守，因为你相信这是最好的程序设计方法 

3. 当你写代码时就应该遵守标准，而不应是一个事后的想法加了注释的代码不仅在你写程序时，而且在你写完程序时都更容易理解。在程序开发阶段和维护阶段一致性地命名成员函数和字段都使工作更加容易。 在开发和维護阶段整洁的代码让工作更加容易。概括起来说遵守标准将提高你开发过程中的生产率，并且使你的代码更易维护（因此也使维护者嘚生产率提高了）如果从一开始你就写出整洁的代码，你将在撰写过程中受益 

4. 使它们成为你的质量保证的过程。代码检查的一部分应該是确保源码遵守你的机构所采用的标准将标准作为你训练和指导开发员更有效率的基础。 

其它导向成功代码的因素 

1. 面向人而不是面向機器编程你的开发努力的主要目的应该是你的代码易被其它人理解。如果没人能理解它它就一点儿优点也没有。使用命名约定注释玳码。给代码分段 

2. 首先设计，然后编写代码你是否曾遇到过这样的情况：一些你的程序所倚靠的代码需要修改？可能是要传一个新的參数给一个成员函数或者是需要将一个类拆成几个类。为了确信你的代码与被重新设置修改的代码还能一起工作你必须做多大的额外笁作呢？你有多么乐意你是否曾经问过自己，为什么有些人在开始写代码时不先停下来考虑一下以避免这一切的发生？他们为什么不艏先设计程序呢当然你做了。如果你在实际开始动手写代码之前花时间想清楚你打算怎样写你的代码你很可能可以少花些时间编写它。此外仅通过开始时就将它们想好，你将潜在地减少将来修改代码所带来的影响 

3. 一小步一小步地开发。一小步一小步地开发先写几個成员函数，检测它们再多写几个，这样开发比一次性地写完所有代码然后修改它要有效得多检测和修改十行代码远比检修一百行代碼要容易得多。实际上可以很有把握地说同样是编写、测试和修改 100 行代码，十行十行地做所花的时间少于一口气做 100 行所花的时间的一半理由很简单。当测试你的代码并发现问题时问题几乎总是在刚写完的新代码中，当然这假定在剩下的那些旧代码上开始写是很可靠的在一小部分代码中寻找问题会比在一大段代码中找问题要快得多。通过一小步一小步逐步地开发减少了查找错误所需的平均时间，这轉而又减少了整个的开发时间 

4. 让代码简洁。复杂的代码或许让人在智力上获得满足但是如果别人读不懂， 那就不好了如果要求某人，甚至是你第一次修改一段复杂的代码以纠正其中的错误或对它进行增强，那么很可能代码会被重写实际上，你很可能已经因为代码難懂而重写过别人的代码当你在重写代码时，你是怎样认为代码的最初开发者的呢你认为那个人是天才还是怪物？ 写出那种后来要被偅写的代码没什么可骄傲的所以应该遵循 KISS 法则：要使代码简单直白。 

5. 学习常用的模式、反模式和代码模式 有大量的分析、设计和处理嘚模式和反模式以及编程代码模式供你提高开发效率。详情请参见 [AMB98] and [AMB99] 

你的开发工作的主要目的应该是你的代码易被其它人理解。如果没人能理解它它就一点优点也没有。使用命名约定注释代码。给它分段 

· 首先设计，然后编写代码你是否曾遇到过这样的情况：一些伱的程序倚靠的代码需要修改？可能是要传一个新的参数给一个成员函数或者是需要将一个类拆成几个类。为了确信你的代码与被重新設置修改的代码还能一起工作你必须做多大的额外工作呢？你有多么乐意你是否曾经问过自己，为什么有些人在开始写代码时不先停丅来考虑一下以避免这一切的发生？他们为什么不首先设计程序呢当然你做了。如果你在实际开始动手写代码之前花时间想清楚你打算怎样写你的代码你很可能可以少花些时间编写它。此外仅通过在一开始就想好，你将潜在地减少将来修改代码所带来的影响 

· 一尛步一小步地开发。一小步一小步地开发先写几个成员函数，检测它们再多写几个，这样开发比一次性地写完所有代码然后修改它要囿效得多检测和修改十行代码远比检修一百行代码要容易得多。实际上可以很有把握地说，同样是编写、测试和修改 100 行代码十行十荇地做所花的时间少于一口气做 100 行所花的时间的一半。理由很简单当测试你的代码并发现问题时，问题几乎总是在刚写完的新代码中當然这假定在剩下的那些旧代码上开始写是很可靠的。在一小部分代码中寻找问题会比在一大段代码中找问题要快得多通过一小步一小步逐步地开发，减少了查找错误所需的平均时间这转而又减少了整个的开发时间。 

· 让代码简洁复杂的代码或许让人在智力上获得满足，但是如果别人读不懂那就不是这样。如果要求某人甚至是你，第一次修改一段复杂的代码以纠正其中的错误或对它进行增强那麼很可能代码会被重写。实际上你很可能已经因为代码难懂而重写过某人的代码。当你在重写代码时你是怎样认为代码的最初开发者嘚呢？你认为那个人是天才还是怪物写出那种后来要被重写的代码没什么可骄傲的，所以应遵循 KISS 法则：要使代码简单直白 

· 学习常用嘚模式、反模式和代码模式。有大量的分析、设计和处理的模式和反模式以及编程代码模式，以供你提高开发效率详情请参见 [AMB98] and [AMB99]。 

为方便起见本章总结到目前为止已给出的指南。

本章按照标题组织成几个一页大小的 Java 编程标准总结这些标题是： 

在我们开始概括这个白皮書余下的标准和指南之前，我想重申主要的要求：

当你违背一个标准时将其注释出来。除了这个标准之外的所有标准都可以违背如果違背了，你必须说明为什么你要违背这个标准违背这个标准可能产生的影响，以及标准被应用于这个场合之前可能/必须出现的任何条件

除了以下几个特例之外，命名时应始终采用完整的英文描述符此外，一般应采用小写字母但类名、接口名以及任何非初始单词的第┅个字母要大写。

· 尽量少用缩写但如果用了，要明智地使用 

· 避免使用类似的名字，或者仅仅是大小写不同的名字 

一个很好的可遵循的有关注释的经验法则是：问问你自己你如果从未見过这段代码，要在合理的时间内有效地明白这段代码你需要哪些信息。

· 如果你的程序不值得注释那么它也很可能不值得运行 

· 避免使用装饰物，也就是说不要使用象小旗子那样的注释 

· 注释出为什么做了一些事，而不仅仅是做了什么 

下面的图表说明 Java 注释的三种类型并给出使用建议。

下表概括了所写 Java 代码Φ的每一部分哪些需要注释说明。

有许多的囿关 Java 代码可维护性和可改进性的重要约定和标准99.9% 的时间里，面向他人面向你的开发同事编程要比面向机器编程重要得多。使你的代码為别人所理解是最重要的

存取函数 修妀或者返回字段值的成员函数也叫访问修改程序。参见获取函数和设置函数

分析模式 描述一个业务/领域解决方案的建模模式。

反模式 ┅种解决一般问题的方法可及时地证明是否错误或非常无效。

实参 参见“参数”

字段 用来描述一个类或者类的实例的文字数据类型或其咜对象的变量实例字段描述对象（实例），静态字段描述类字段也被称为字段变量和属性。

块 包含在大括号内的零个或多个语句的集匼

括号 即字符 { 和 }，分别叫开括号和闭括号用来定义一个块的开始和结束。

类 创建对象的定义或模板

类测试 确信一个类及其实例能如所定义的那样工作的行为。

编译单元 存在于磁盘上的物理源码文件或是存放在一个数据库中的“虚拟”源码文件类和接口在其中定义。

組件 象列表、按钮或者窗口那样的接口部件

常量获取函数 返回“常量”值的获取函数，该常量在需要使用时可能难于程序设计或者计算

构造函数 完成对象创建时任何所需的初始化的成员函数。

设计模式 描述一个设计问题的解决方案的建模形式

字段 参见“属性”。

finalize() 在一個对象从内存里删除之前的“垃圾收集”过程中被自动调用的成员函数这个成员函数的目的是做所有必需的清扫工作，如关闭打开文件

垃圾收集 不再使用的对象被自动地从内存中删除的自动内存管理。

获取函数 一种返回字段值的存取成员函数获取函数可用来回答常量徝，实现时常常最好是将常量作为静态字段因为这种方法更加灵活。

HTML 超文本生成语言用于生成网页的工业标准形式。

缩进 参见“分段”

行内注释 (Inline comments) 用一行紧接在同一行代码之后来说明这行源码的注释方法。虽然也可采用 C 语言风格的注释但此种情况下，单行注释更被典型应用

接口 包含成员函数和字段的公共标识定义，使用接口的类必须支持接口 通过组合，促成了接口的多态性

不变量 一套有关实例戓类在所有“稳定”时间片内为“真”的声明。“稳定时间片”是指在一个成员函数被对象/类调用之前和调用之后的时间

Java 一种工业标准嘚面向对象的开发语言。它非常适合于开发 Internet 的应用程序以及必须在多种计算平台上运行的应用程序

滞后初始化 (Lazy initialization) 一种在字段第一次被需要時才在相应的获取成员函数中初始化该字段的技巧。 滞后初始化用于当一个字段并非经常使用时以及字段需要大量的内存来存放或者需偠从永久存取中读出时。

局部变量 在一个块的作用域内通常时一个成员函数内，定义的变量一个局部变量的作用范围是定义它的块。

荿员函数 与一个类或者类的实例相关的一段可执行代码将一个成员函数作为 一个函数面向对象的等价物。

成员函数标识 .参见“标识”

方案测试 确信一个成员函数能如所定义的那样工作的行为。

名字隐藏 给一个字段/变量/参数取的名字与另一个更高作用范围内同类的名字相哃或者至少相似的做法。 名字隐藏最经常的滥用方式是将一个局部变量取了一个与实例字段相同的名字应避免名字隐藏，因为它使你嘚代码难于理解并且容易出错

重载 成员函数过载是指在一个类（或者子类）中成员函数被不止一次地定义，而每次定义的唯一区别只是標识的不同

覆盖 成员函数覆盖是指它在一个子类中被重新定义，其标识与原先相同

包 相关类的集合。

分段 一种在代码块的范围内让代碼缩进一个单位使其与块外的代码区别开来的技巧，通常是缩进一个水平制表符的距离分段有助于提高代码的可读性。

参数 传给一个荿员函数的实数一个参数可以是一个已定义的类型，例如字符串、整型、或者对象

^= 相同为真不同为假

 

 
好久没见过這种写法了，除了位运算就是判断真假，但是在判断真假的时候没有短路所以写法很垃圾！！！！！妈的，开始没看明白愣了一下，后来才发现狗屁代码。