《Java 编程指南.doc》由会员分享，可在线阅读，更多相关《Java 编程指南.doc（55页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、先锋软件股份有限公司 【Java编程标准】/【TS-G-01】Java 编程指南文档编号：TS-G-02*软件股份有限公司-内部资料，注意保密- 第 2 页 共 10 页*软件股份有限公司 【Java编程指南】/【TS-G-02】文件变更记录*A - 增加 M - 修订 D - 删除变更版本号日期变更类型（A*M*D）修改人变更摘要备注V1.0-内部资料，注意保密- 第 5 页 共 55 页目录JAVA 编程指南11简介11.1最根本的原则：12程序设计标准12.1命名约定12.1.1注释约定22.1.1.1Java 注释语句类型32.1.1.2快速浏览 javadoc53成员函数标准63.1
2、命名成员函数63.2命名存取成员函数63.2.1.获取函数63.2.2.获取函数的另一种命名约定。Has 和 Can73.2.3.设置函数73.3.命名构造函数83.4.成员函数的可见性83.5.注释成员函数83.5.1.成员函数的函数头83.5.2.内部注释103.6.编写清晰整洁的代码的技巧123.6.1.给代码加上注释123.6.2.让代码分段/缩进123.6.3.遵循 30 秒条法则133.6.4.写短小单独的命令行133.6.5.说明运行顺序134.字段标准（字段/属性）134.1命名字段144.1.1.命名组件（部件）144.1.2.命名组件的另一种方法。匈牙利符号144.1.3.
3、命名组件的另一种方法。匈牙利符号后缀154.1.4.命名常量154.1.5.命名集合154.2.字段可见性164.2.1.不要“隐藏”名字164.3.注释一个字段174.4.使用存取成员函数174.4.1.为什么使用存取函数？184.4.2.命名存取函数194.4.3.存取函数的高级技术194.4.3.1.滞后初始化194.4.3.2.常量存取函数214.4.3.3.集合存取函数244.4.3.4.同时访问几个字段244.4.4.存取函数的可见性254.5.一定要初始化静态字段255.局部变量标准255.1声明命名局部变量265.1.1.命名流265.1.2.命名循环计数器265.1.3.命名
4、异常对象265.2.声明并注释局部变量275.2.1.关于声明的一般注释276.成员函数的参数标准276.1命名参数276.1.1注释参数287.类、接口、包和编译单元的标准287.1类的标准297.1.1.命名类297.1.2.注释类297.1.3.类的声明307.1.4.将公共和保护接口最小化317.2接口标准317.2.1.命名接口327.2.1.1可替代的其它办法：327.2.2.注释接口327.3包的标准327.3.1.命名包337.3.2.注释包337.4编译单元标准337.4.1命名编译单元347.4.2注释编译单元348.错误处理和异常349.其他标准和版本369.1复用369
5、.2导入类369.3优化 Java 代码369.4编写 Java 测试集3710.成功的模式3810.1有效地使用这些标准3810.2其它导向成功代码的因素3911.总结4011.1Java 命名约定4111.2Java 注释约定4311.2.1Java 注释类型4311.2.2注释哪些部分4411.3Java 程序设计约定 （一般）4612.词汇表47*软件股份有限公司 【Java编程指南】/【TS-G-02】Java 编程指南1 简介本文提供一整套编写高效可靠的 Java 代码的标准、约定和指南。它们以安全可靠的软件工程原则为基础，使代码易于理解、维护和增强。而且，通过遵循这些程序设计标准
6、，你作为一个 Java 软件开发者的生产效率会有显著提高。经验证明，若从一开始就花时间编写高质量的代码，则在软件开发阶段，对代码的修改要容易很多。最后，遵循一套通用的程序设计标准将带来更大的一致性，使软件开发团队的效率明显提高。1.1 最根本的原则：运用常识。当找不到任何规则或指导方针，当规则明显不能适用，当所有的方法都失效的时侯： 运用常识并核实这些基本原则。这条规则比其它所有规则都重要。常识是必不可少的。2 程序设计标准Java 的程序设计标准很重要，原因在于它将提高开发团队各成员的代码的一致性。一致性的提高会使代码更易理解，这意味着它更易开发和维护。从而降低了应用程序的总开发成本。你必须
7、牢记的是：你的 Java 代码在你已离开并开始另一个项目之后，会保留相当长的一端时间。因此开发过程中一个很重要的目标就是要确保在开发成员或开发团队之间的工作可以顺利交接，不必花很大的力气便能理解已编写的代码，以便继续维护和改进以前的工作。如果代码难以理解，很有可能被废弃和重写。2.1 命名约定我们将在整个标准中讨论命名约定，所以让我们先讨论几个基本点： 1. 使用可以准确说明变量/字段/类的完整的英文描述符。例如，采用类似 firstName，grandTotal 或 CorporateCustomer 这样的名字。虽然象 x1，y1 或 fn 这样的名字很简短，输入起来容易，但是我们难以知道
8、它们代表什么、结果是什么含义，因而使代码难以理解、维护和改进。 2. 采用该领域的术语。如果用户称他们的“客户” (clients) 为“顾客” (customers)，那么就采用术语 Customer 来命名这个类，而不用 Client。许多程序开发者会犯的一个错误是，不去使用工业或领域里已经存在着很完美的术语时，却生造出一些普通词汇。 3. 采用大小写混合，提高名字的可读性。一般应该采用小写字母，但是类和接口的名字的首字母，以及任何中间单词的首字母应该大写。 4. 尽量少用缩写，但如果一定要使用，就要谨慎地使用。这意味着应该保留一个标准缩写的列表，明智地从中选取，并且在使用时保持一致。例如
9、，想对单词“number”采用缩写，那么可从 nbr，no 或者 num 中选取一个，说明一下采用了哪一个（具体是哪个倒无所谓），并且只使用这一种形式。 5. 避免使用长名字（最好不超过 15 个字母）。虽然 PhysicalOrVirtualProductOrService 看起来似乎是个不错的类名，但是这个名字太长了，应该考虑重新给它起个短一点的名字，比如象 Offering。 6. 避免使用相似或者仅在大小写上有区别的名字。例如，不应同时使用变量名 persistentObject 和 persistentObjects，以及 anSqlDatabase 和 anSQLDatabase。
10、 7. 避免使用下划线作为名字的首末字母。以下划线为首末字母的名字通常为系统保留，除预处理定义之外，一般不用作用户命名。更重要的是，下划线经常造成麻烦而且难输入，所以尽量避免使用。 2.1.1 注释约定我们还会对注释约定进行讨论，所以，我们先谈谈一些基本点： 1. 注释应该增加代码的清晰度。代码注释的目的是要使代码更易于被同时参与程序设计的开发人员以及其他后继开发人员理解。 2. 如果你的程序不值得注释，那么它也很可能也不值得运行 。 3. 避免使用装饰性内容，也就是说，不要使用象广告横幅那样的注释语句。二十世纪六十年代和七十年代，COBOL 程序员们养成了画框的习惯，典型的是用星号将他们的内
11、部注释圈起来。当然，这给他们的艺术创造欲一个发泄方式，但是坦白地说，这只是在大量浪费时间，并不能给最终的产品增加丝毫价值。要写的是清晰的代码，不是外表可爱的代码。此外，由于有些字体的显示和打印是成比例的，但有些又不是，所以无法将那些框排整齐。 4. 保持注释的简洁。最好的注释应该是简单明了的注释。注释不必洋洋洒洒，只需提供足够的信息，使别人能够理解你的代码。 5. 先写注释，后写代码。写代码注释的最好方法是在写代码之前就写注释。这使你在写代码之前可以想想代码的功能和运行。而且这样确保不会遗漏注释。另一种方法是边写代码边写注释。因为注释可以使代码更易理解，所以在程序开发的过程中，也可以利用这一点
12、。如果打算花些时间写注释，那么至少你应从这个过程中获得些什么 。 6. 注释信息不仅要包括代码的功能，还应给出原因。例如，下面例 1 中的代码显示金额在 $1,000 以上（包括 $1,000）的定单可给予 5% 的折扣。为什么要这样做呢？难道有一个商业法则规定大额定单可以得到折扣吗？这种给大额定单的特殊是有时限的呢，还是一直都这样？最初的程序设计者是否只是由于慷慨大度才这样做呢？除非它们在某个地方（或者是在源代码本身，或者是在一个外部文档里）被注释出来，否则你不可能知道这些。例 1.1if (grandTotal = 1000.00)grandTotal = grandTotal * 0.9
13、5;2.1.1.1 Java 注释语句类型Java 有三种注释语句风格：以 /* 开始， */ 结束的文档注释，以 /* 开始，以 */ 结束的C语言风格注释，以及以 / 开始，代码行末尾结束的单行注释。下表是对各类注释语句建议用法的一个概括，也给出了几个例子。注释语句类型用法示例文档注释在接口、类、成员函数和字段声明之前紧靠它们的位置用文档注释进行说明。文档注释由 javadoc 处理，为一个类生成外部注释文档，如下所示。/* Customer（顾客）顾客是指作为我们的服务及产品的销售对象的任何个人或组织。author S.W. Ambler*/C 语言风格注释采用 C 语言风格的注释语句将
14、无用的代码注释掉。保留这些代码是因为用户可能改变想法，或者只是想在调试中暂时不执行这些代码。/* 这部分代码已被它前面的代码替代，所以于 1999 年6 月 4 日被 B. Gustafsson 注释掉。如果两年之后仍未用这些代码，将其删除。. . . （源代码）*/单行注释在成员函数内部采用单行注释语句对业务逻辑、代码片段和临时变量声明进行说明。/ 因为让利活动 / 从 1995 年 2 月开始，/ 所以给所有超过 $1000 的/ 发货单 5% 的折扣。一件很重要的事情是，你的机构应该制订一套如何使用 C 语言风格注释和单行注释的标准，并始终严格遵守。使用一种注释方式来说明业务逻辑，使用另
15、一种方式注释掉旧的代码。业务逻辑采用单行注释，因为这样可以将注释和代码放在同一行（这又叫做“内联”）。采用 C 语言风格的注释屏蔽掉旧的代码，因为这样可以同时注释掉数行。C 语言风格注释看起来很象文档注释，所以为了防止混淆，不应在别处使用。注意行末注释。强烈反对采用行内注释，即在一行的末尾加上注释。他指出，这种注释必须在代码的右端对齐，这样才能避免代码结构看起来混乱。结果，这些注释的格式难以划一。“如果你使用了很多这样的注释，则要花时间去将它们排列整齐。这些时间并没有花在更多地了解代码上，而完全花在了敲击空格键和制表符这种冗长乏味的工作上。”他又指出，行末注释也难以维护。因为当该行程序的代码加
16、长时，它们会将这些注释挤出该行，如果你将它们排齐了，你不得不对余下的注释做同样的工作。2.1.1.2 快速浏览 javadocSun 公司的 Java Development Kit (JDK) 中有一个名为 javadoc 的程序。它可以处理 Java 的源代码文件，并且为 Java 程序产生 HTML 文件形式的外部注释文档。Javadoc 支持一定数目的标记，标识注释文档中各段起始位置的保留字。详情请参考 JDK javadoc 文档。标记用于目的author name类、 接口说明特定某一段程序代码的作者。每一个作者各有一个标记。deprecated类、 成员函数说明该类的应用程序编程
17、接口 (API) 已被废弃，因此应不再使用。exception name description成员函数说明由成员函数发出的异常。一个异常采用一个标记，并要给出异常的完整类名。param name description成员函数用来说明传递给一个成员函数的参数，其中包括参数的类型/类和用法。每个参数各有一个标记。return description成员函数若成员函数有返回值，对该返回值进行说明。应说明返回值的类型/类和可能的用途。since类、成员函数说明自从有 JDK 1.1 以来，该项已存在了多长时间。see ClassName类、接口、成员函数、字段在文档中生成指向特定类的超文本链接。可
18、以并且应该采用完全合法的类名。see ClassName#member functionName类、接口、成员函数、字段在文档中生成指向特定成员函数的超文本链接。可以并且应该采用完全合法的类名。version text类、接口说明特定一段代码的版本信息。你注释代码的方式很大地影响着你的工作效率以及所有维护改进代码的后继开发者的工作效率。在软件开发过程中及早注释代码，会促使你在开始撰写代码之前仔细考虑这些代码，从而带来更高的工作效率。而且，当你重新阅读数天前或者数星期前所写的代码时，你可以很容易地判断出当时你是怎么想的，因为这一切都有记录。3 成员函数标准切记：你今天所写的代码可能在今后的数年里
19、仍在使用，而且很有可能由其他人来维护和改进。应尽可能使你的代码“整洁”易懂，因为这会使代码易于维护和改进。3.1 命名成员函数成员函数的命名应采用完整的英文描述符，大小写混合使用：所有中间单词的第一个字母大写。成员函数名称的第一个单词常常采用一个有强烈动作色彩的动词。示例：openAccount()printMailingLabel()save()delete()这种约定常常使人一看到成员函数的名称就能判断它的功能。虽然这种约定要使开发者多做一些输入的工作，因为函数名常常较长，但是回报是提高代码的可理解性。3.2 命名存取成员函数在后续章节中，我们将更详细地讨论获取和存放字段值（字段/属性）的
20、存取成员函数。下面将概括一下存取函数的命名约定。3.2.1. 获取函数获取函数作为一个成员函数，返回一个字段的值。除了布尔字段之外，应采用 get 作为字段的前缀；布尔字段采用 is 作为前缀。示例：getFirstName()getAccountNumber()isPersistent()isAtEnd()遵循这个命名约定，显然，成员函数将返回对象的字段，布尔型的获取函数将返回布尔值“真”或者“假”。这个标准的另一个优点是：它遵循 beans development kit (BDK) 对获取成员函数采用的命名约定 。它的一个主要的缺点是 get 是多余的，需要额外的录入工作。3.2.2.
21、获取函数的另一种命名约定。Has 和 Can基于正规英文约定的一个可行的取代方法是，用 has 或者 can 来代替布尔型获取函数的 is 前缀。例如，形如 hasDependents() 和 canPrint() 的获取函数，读起来就发现它们意义更加明确。这种方法存在的问题是 BDK 目前还不支持这种命名方法。可以将 isBurdenedWithDependents() 和 isPrintable() 这些成员函数重新命名。3.2.3. 设置函数设置函数，也叫变值函数，是可以修改一个字段值的成员函数。无论何种字段类型，都要在字段名的前面加上 set 前缀。示例：setFirstName(St
22、ring aName)setAccountNumber(int anAccountNumber)setReasonableGoals(Vector newGoals)setPersistent(boolean isPersistent)setAtEnd(boolean isAtEnd)按照这种命名约定，显然是一个成员函数设定一个对象的字段值。这个标准的另一个优点是：它遵循 beans development kit (BDK) 对设置函数采用的命名约定 。它的一个主要的缺点是 set 是多余的，需要额外的录入。3.3. 命名构造函数构造函数是在一个对象初次生成时，完成所有必需的初始化的成员函数
23、。构造函数与它所属类的名字总是相同的。例如，类 Customer 的构造函数是 Customer()。注意大小写一致。示例：Customer()SavingsAccount()PersistenceBroker()这个命名约定由 Sun 公司设定，必须严格遵守。3.4. 成员函数的可见性良好的程序设计应该尽可能减小类与类之间耦合，所遵循的经验法则是：尽量限制成员函数的可见性。如果成员函数没必要公有 (public)，就定义为保护 (protected)；没必要保护 (protected)，就定义为私有 (private)。可见性说明正确用法public公有成员函数可被任何其它对象和类的成员函数
24、调用。当该成员函数必须被该函数所在的层次结构之外的其他对象和类在访问时。protected被保护的成员函数可被它所在的类或该类的子类的任何成员函数调用。当该成员函数提供的行为被它所在类的层次结构内部而非外部需要时。private私有成员函数只可以被该类所在的其它成员函数调用，该类的子类不可以调用。当该成员函数所提供的行为明确针对定义它的类时。私有成员函数常常是重新分配要素的结果。重新分配要素又叫“重组”，指类内其它成员函数封装某一个特定行为的做法。3.5. 注释成员函数如何注释一个成员函数常常成为判断函数是否可被理解，进而可维护和可扩展的决定性因素。3.5.1. 成员函数的函数头每一个 Jav
25、a 成员函数都应包含某种称之为“成员函数文档”的函数头。这些函数头在源代码的前面，用来记录所有重要的有助于理解函数的信息。这些信息包含但不仅仅局限于以下内容：1. 成员函数做什么以及它为什么做这个。通过给一个成员函数加注释，让别人更加容易判断他们是否可以复用代码。注释出函数为什么做这个可以让其他人更容易将你的代码放到程序的上下文中去。也使其他人更容易判断是否应该对你的某一段代码加以修改（有可能他要做的修改与你最初为什么要写这一段代码是相互冲突的）。 2. 哪些参数必须传递给一个成员函数。还必须说明，如果带参数，那么什么样的参数必须传给成员函数，以及成员函数将怎样使用它们。这个信息使其他程序员了
26、解应将怎样的信息传递给一个成员函数。在 (第 1.4.2 节“快速浏览 javadoc”) 中讨论的 javadoc param 标识便用于该目的。 3. 成员函数返回什么。如果成员函数有返回值，则应注释出来，这样可以使其他程序员正确地使用返回值/对象。在 (第 1.4.2节“快速浏览 javadoc”) 里讨论的 javadoc return 标识便用于此目的。 4. 已知的问题。成员函数中的任何突出的问题都应说明，以便让其他程序开发者了解该成员函数的弱点和难点。如果在一个类的多个成员函数中都存在着同样的问题，那么这个问题应该写在类的说明里。 5. 任何由某个成员函数抛出的异常。应说明成员函
27、数抛出的所有异常，以便使其他程序员明白他们的代码应该捕获些什么。在 (第 1.4.2节“快速浏览 javadoc”) 中讨论的 javadoc exception 标识便用于此目的。 6. 可见性决策。如果你觉得你对于一个成员函数可见性的选择会遭到别人的质疑，例如可能你将一个成员函数设为公共的，但是却没有任何对象调用该成员函数，那么应说明你的决定。这将帮助其他开发者了解你的想法，使他们不必浪费时间操心考虑你为什么要选择一种有疑问的东西。 7. 成员函数是如何改变对象的。若一个成员函数修改了一个对象，例如一个银行帐户的成员函数 withdraw() 修改了帐户余额，那么就需要说明。这种信息必须给
28、出，使其他 Java 程序员能准确地知道一个成员函数调用将如何影响目标对象。 8. 避免使用含有信息的函数头。比如说作者、电话、创建和修改日期、单元（或者文件名）的位置，因为这些信息很快就会过时。将版权所有者信息放到单元的最后。例如，读者不会想要翻过两三页诸如“版权所有”等对理解程序毫无帮助且（或）不提供任何编程信息的文本。避免使用垂直滚动条或者关闭的文本框或对话框，这些东西只会增加视觉干扰，而且较难保持一致。采用一个配置管理工具来保存单元历史。 9. 如何在适当情况下调用成员函数的例子。最简单的确定一段代码如何工作的方法是看一个例子。考虑包含一到两个如何调用成员函数的例子。 10. 可用的前
29、提条件和后置条件。前提条件是指一个成员函数可正确运行的限制条件；后置条件是指一个成员函数执行完以后的属性或声明。前提条件和后置条件以多种方式说明了在编写成员函数过程中所做的假设，精确定义了一个成员函数的应用范围。 11. 所有并行事件。对众多程序开发者来说，并行性是一个新而复杂的概念；对有经验的并行性程序开发者来说，并行性也是一个老但却复杂的课题。最终结果是，如果应用了 Java 的并行编程特性，那么应在程序中详细地将其注释出来。 建议，当一个类既包含了同步也包含了非同步的成员函数时，必须注释出成员函数依赖的执行上下文，尤其是当函数可被无约束访问时。这样可以让其他开发者安全地使用你的成员函数。
30、当一个采用了 Runnable 接口的类的设置函数（即可更新一个字段的成员函数）没有同步时，应说明这样做的理由。最后，如果覆盖或重载一个成员函数，并且修改了它的同步性时，也应说明理由。 仅当注释增加代码的清晰度时，才应加上注释。对于每个成员函数，并非要说明以上所有部分，因为对于每一个成员函数来说，并不是以上所有的部分都适用。但是，对于所写的每个成员函数要说明以上的部分内容。3.5.2. 内部注释除成员函数注释以外，在成员函数内部还需加上注释语句来说明你的工作。目的是使成员函数更易理解、维护和增强。内部注释应采用两种方式：C 语言风格的注释 (/* 和 */) 和单行注释 (/)。正如上述所讨论
31、的，应认真考虑给代码的业务逻辑采用一种风格的注释，给要注释掉的无用代码采用另外一种风格的注释。建议对业务逻辑采用单行注释，因为它可用于整行注释和行末注释。采用 C 语言风格的注释语句去掉无用的代码，因为这样仅用一个语句就可以容易地去掉几行代码。此外，因为 C 语言风格的注释语句很象文档注释符。它们之间的用法易混淆，这样会使代码的可理解性降低。所以，应尽量减少使用它们。在函数内，一定要说明： 1. 控制结构。说明每个控制结构，例如比较语句和循环。你无须读完整个控制结构内的代码才判断它的功能，而仅需看看紧靠它之前的一到两行注释即可。 2. 代码做了些什么以及为什么这样做。通常你常能看懂一段代码做了
32、什么，但对于那些不明显的代码，你很少能判断出它为什么要那样做。例如，看完一行代码，你很容易地就可以断定它是在定单总额上打了 5% 的折扣。这很容易。不容易的是为什么要打这个折扣。显然，肯定有一条商业法则说应打折扣，那么在代码中至少应该提到那条商业法则，这样才能使其他开发者理解你的代码为什么会是这样。 3. 局部变量。虽然我们在第 4 章将仔细讨论这一点，在一个成员函数内定义的每一个局部变量都应在它代码的所在行声明，并且应采用一个行内注释说明它的用法。 4. 难或复杂的代码。若发现不能或者没有时间重写代码，那么应将成员函数中的复杂代码详细地注释出来。一般性的经验法则是，如果代码并非显而易见的，则
33、应说明。 5. 处理顺序。如果代码中有的语句必须在一个特定的顺序下执行，则应保证将这一点注释出来。没有比下面更糟糕的事了：你对一段代码做一点简单的改动，却发现它不工作，于是花了几个小时查找问题，最后发现原来是搞错了代码的执行顺序。 在闭括号后加上注释。常常会发现你的控制结构内套了一个控制结构，而在这个控制结构内还套了一个控制结构。虽然应该尽量避免写出这样的代码，但有时你发现最好还是要这样写。问题是闭括号 应该属于哪一个控制结构这一点就变得混淆了。一个好消息是，有一些编辑器支持一种特性：当选用了一个开括号后，它会自动地使相应得闭括号高亮显示；一个坏消息是，并非所有的编辑器都支持这种属性。我发现通
34、过将类似 /end if，/end for，/end switch，& 这样的注释加在闭括号所在行的行后，可以使代码更易理解。3.6. 编写清晰整洁的代码的技巧这一部分讲述几个技巧，这些技巧有助于区分专业软件开发者和蹩脚代码编写者。这些技巧是： 给代码加上注释 给代码分段 使用空白 遵循 30 秒条规则 说明消息发送的顺序 写短小单独的命令行 3.6.1. 给代码加上注释记住：如果你的代码不值得注释，那么它就不值得保留。当正确地使用了本文提到的注释标准和方针，就可以大幅度地提高代码质量。3.6.2. 让代码分段/缩进一种提高代码可读性的方法是给代码分段，换句话说，就是在代码块内让代码缩进。所有
35、在括号 和 之内的代码，构成一个块。基本思想是，块内的代码都应统一地缩进去一个单位。Java 的约定似乎是开括号放在块的所有者所在行的后面，闭括号应缩进一级。在 指出的很重要的一点是，你所在的机构应选取一个缩进风格并始终使用这种风格。采用与你的 Java 开发环境所生成的代码一样的缩进风格。在代码中使用空白。在 Java 代码中加入几个空行，也叫空白，将代码分为一些小的、容易理解的部分，可以使它更加可读。 建议采用一个空行来分隔代码的逻辑组，例如控制结构，采用两个空行来分隔成员函数定义。没有空白的代码很难读，很难理解。3.6.3. 遵循 30 秒条法则其他的程序员应能在少于 30 秒钟的时间内
36、完全理解你的成员函数，理解它做什么，为什么这样做，它是怎样做的。如果他们做不到，说明你的代码太难维护，应加以改进。30 秒钟，明明白白。一个好的经验法则是：如果一个成员函数一个屏幕装不下，那么它就很可能太长了。3.6.4. 写短小单独的命令行每一行代码只做一件事情。在依赖于穿孔卡片的计算机发展的早期，想让一行代码完成尽量多的功能的想法是可以理解的。若想在一行里做多件事情，就会使代码难于理解。为什么要这样呢？我们应使代码尽量容易理解，从而更容易维护和改进。正如同一个成员函数应该并且只能做一件事一样，一行代码也只应做一件事情。此外，应让代码在一个屏幕内可见。也不应向右滚动编辑窗口来读取一整行代码，
37、包括含有行内注释语句的代码。3.6.5. 说明运行顺序提高代码可读性的一个相当简单的方法是使用圆括号 (parenthesis，又叫“round brackets”) 来说明 Java 代码运行的准确顺序。如果为了理解你的源码而必须了解编程语言的操作顺序，那么这说明源码中一定有什么重要的东西做的不对。这大多是在 AND 或者 OR 其它几个比较关系处产生的逻辑比较上的问题。注意：如果你象前文所建议的那样，采用短小单独的命令行，那么就不会产生这个问题。4. 字段标准（字段/属性）field 这个词在这里指的是字段，Beans Development Kit (BDK) 叫它“属性”。字段是说明一
38、个对象或者一个类的一段数据。字段可以是象字符串或者浮点数这样的基本数据类型，也可以是一个对象，例如一个消费者或者一个银行帐户。4.1 命名字段应采用完整的英文描述符来命名字段，以便使字段所表达的意思一目了然。象数组或者矢量这样是集合的字段，命名时应使用复数来表示它们代表多值。示例：firstNamezipCodeunitPricediscountRateorderItems4.1.1. 命名组件（部件）应采用完整的英文描述符命名组件（接口部件），名字的后缀是组件类型名。这让你容易区分一个组件的目的和它的类型，容易在一个表里找到各个组件（许多可视化的编程环境在一个 Applet 程序或者一个应用
39、程序中提供了一个所有组件的列表。如果所有名字都是类似于 button1， button2, & 这样的话，很容易混淆）。示例：okButtoncustomerListfileMenunewFileMenuItem4.1.2. 命名组件的另一种方法。匈牙利符号“匈牙利符号”是基于字段应按照以下方法命名的原则：xEeeeeeEeeeee，其中 x 指组件类型，EeeeeEeeeee 是完整的英文描述符。示例：pbOklbCustomermFilemiNewFile这个方法的主要优点是，这是一个通用于 C+ 代码中的工业标准，已经有许多人在遵守它。此外，开发者能快速地从变量的名字上来判断它的类型和用
40、法。主要的缺点是，当有许多同一类型的部件时，前缀符号变得很笨重；而且，违背了采用完整的英文描述符的命名约定。4.1.3. 命名组件的另一种方法。匈牙利符号后缀这基本上是其他两种方式的组合，生成的名字如 okPb，customerLb，fileM 和 newFileMi。主要优点是组件名说明了组件类型，并且同一类的组件不在一起，而按照字母顺序排列。主要的缺点仍是未采用完整的英文描述符，它偏离了规范，使标准难以被记住。设定组件命名标准。无论使用哪种约定，都要生成一个“正式”部件名列表。例如，当命名按钮时，是用 Button 或是 PushButton，b 或是 pb？生成一个列表，让组里的每一个
41、Java 开发者都得到它。4.1.4. 命名常量Java 中，常量，即不变的值，一般用类的静态常量字段来实现。公认的约定是，采用完整的英文大写单词，在词与词之间用下划线连接。示例：MINIMUM_BALANCEMAX_VALUEDEFAULT_START_DATE这个约定的主要优点是，它有助于区分常量和变量。在本文后面的章节中我们将看到，如果用定义获取函数返回常量值的方法来取代定义常量，代码的可适应性和可维护性都会大大提高。4.1.5. 命名集合一个集合，例如数组和矢量，应采用复数命名来表示队列中存放的对象类型。命名应采用完整的英文描述符，名字中所有非开头的单词的第一个字母应大写。示例：cus
42、tomersorderItemsaliases这种约定的主要优点是有助于区分表示复数值（集合）和单值（非集合）的字段。4.2. 字段可见性当字段被声明为 protected 类型时，子类中的成员函数可能会直接访问它，有效地提高了类内层次结构的耦合性。这使类更难维护和加强，所以应该尽量避免。字段不应被直接访问，而应采用存取成员函数（参见下文）访问。可见性说明正确用法public一个公共字段可被任何其他对象或者类中的成员函数访问。不要让字段公有。protected被保护的字段可被它声明时所在的类及该类的子类的所有成员函数访问。不要让字段被保护。private私有字段只可以被它声明时所在的类的其它成
43、员函数调用，该类子类中的函数不可以调用。所有的字段都应置为私有，由获取和设置成员函数（存取函数）访问。对于那些非长期性的字段（它们不被永久保留），应将它们标注为 static 或 transient 。使它们与 BDK 的约定一致。4.2.1. 不要“隐藏”名字名字隐藏是指给局部变量、参数或者字段所取的名字，与另一个更大范围内定义的变量、参数或者字段的名字相同（或相似）。例如，如果把一个字段叫做 firstName ，就不要再生成一个局部变量或者参数叫做 firstName，或者任何类似的名字，如 firstNames 或 fistName。名字隐藏会使代码难于理解，并容易产生问题。因为你或者
44、其他开发者在修改代码时，会误读代码，而错误又很难发现。4.3. 注释一个字段所有的字段都应很好地加以注释，以便其他开发者理解它。要想有效地注释，以下的部分需要说明： 1. 字段的说明。需说明一个字段，才能使人了解如何使用它。 2. 注释出所有采用的不变量。字段中的不变量是指永远为“真”的条件。例如，字段 dayOfMonth 的不变量可能是它的值只能在 1 到 31 之间（显然，可以用基于某一年里的某个月份来限制这个字段值，使其变的更加复杂）。通过说明字段值的限制条件，有助于定义重要的业务规则，使代码更易理解。 3. 示例。对于那些有复杂业务规则与之相关联的字段，应提供几个例子，使它们容易理解
45、。一个例子常象一幅画：它抵得上几千个词语。 4. 并行事件。对众多程序开发者来说，并行性是一个新而复杂的概念；事实上，即使对有经验的并行程序开发者来说，并行性也是一个老但却复杂的课题。最终结果是，如果应用了 Java 的并行编程特性，那么你应在程序中详细地注释出来。 5. 可见性决策。如果声明了一个非私有字段，则应说明为什么要这样做。字段的可见性在上文中（第 3.2 节“字段的可见性”）讨论了，支持封装的存取成员函数的用法将在下文（第 3.4 节“存取成员函数的使用”）中讨论。总的来说，最好能有一个好的理由解释为什么不将变量声明为私有类型。 4.4. 使用存取成员函数除了满足命名约定之外，适当地使用存取成员函数，即提供更新