Java编程规则

最新推荐文章于 2024-03-20 17:30:41 发布

一盏清辉

最新推荐文章于 2024-03-20 17:30:41 发布

阅读量783

点赞数 1

分类专栏： java 编程规范文章标签： java 编程语言代码规范

本文链接：https://blog.csdn.net/WaXiaoHui/article/details/118927956

版权

java 同时被 2 个专栏收录

7 篇文章 0 订阅

订阅专栏

编程规范

1 篇文章 0 订阅

订阅专栏

Java编程规则

在我们的工作学习中，编写代码的规范不仅能提高代码的整洁性，方便阅读，也可以对我们阅读他人代码提升自己能力有莫大的帮助，这篇文章提供了代码编写的一般性指导，能够帮助大家进行良好的程序设计。

1.1 编程规则

(1) 类名首字母应该大写。字段、方法以及对象（句柄）的首字母应小写。对于所有标识符，其中包含的所有单词都应紧靠在一起，而且大写中间单词的首字母。例如：

ThisIsAClassName
thisIsMethodOrFieldName

若在定义中出现了常数初始化字符，则大写static final基本类型标识符中的所有字母。这样便可标志出它们属于编译期的常数。

Java包（Package）属于一种特殊情况：它们全都是小写字母，即便中间的单词亦是如此。对于域名扩展名称，如com，org，net或者edu等，全部都应小写（这也是Java 1.1和Java 1.2的区别之一）。

(2) 为了常规用途而创建一个类时，请采取“经典形式”，并包含对下述元素的定义：

equals()
hashCode()
toString()
clone()（implement Cloneable）
implement Serializable

(3) 对于自己创建的每一个类，都考虑置入一个main()，其中包含了用于测试那个类的代码。为使用一个项目中的类，我们没必要删除测试代码。若进行了任何形式的改动，可方便地返回测试。这些代码也可作为如何使用类的一个示例使用。

(4) 应将方法设计成简要的、功能性单元，用它描述和实现一个不连续的类接口部分。理想情况下，方法应简明扼要。若长度很大，可考虑通过某种方式将其分割成较短的几个方法。这样做也便于类内代码的重复使用（有些时候，方法必须非常大，但它们仍应只做同样的一件事情）。

(5) 设计一个类时，请设身处地为客户程序员考虑一下（类的使用方法应该是非常明确的）。然后，再设身处地为管理代码的人考虑一下（预计有可能进行哪些形式的修改，想想用什么方法可把它们变得更简单）。

(6) 使类尽可能短小精悍，而且只解决一个特定的问题。下面是对类设计的一些建议：

■一个复杂的开关语句：考虑采用“多形”机制

■数量众多的方法涉及到类型差别极大的操作：考虑用几个类来分别实现

■许多成员变量在特征上有很大的差别：考虑使用几个类

(7) 让一切东西都尽可能地“私有”——private。可使库的某一部分“公共化”（一个方法、类或者一个字段等等），就永远不能把它拿出。若强行拿出，就可能破坏其他人现有的代码，使他们不得不重新编写和设计。若只公布自己必须公布的，就可放心大胆地改变其他任何东西。在多线程环境中，隐私是特别重要的一个因素——只有private字段才能在非同步使用的情况下受到保护。

(8) 谨惕“巨大对象综合症”。对一些习惯于顺序编程思维、且初涉OOP领域的新手，往往喜欢先写一个顺序执行的程序，再把它嵌入一个或两个巨大的对象里。根据编程原理，对象表达的应该是应用程序的概念，而非应用程序本身。

(9) 若不得已进行一些不太雅观的编程，至少应该把那些代码置于一个类的内部。

(10) 任何时候只要发现类与类之间结合得非常紧密，就需要考虑是否采用内部类，从而改善编码及维护工作。

(11) 尽可能细致地加上注释，并用javadoc注释文档语法生成自己的程序文档。

(12) 避免使用“魔术数字”，这些数字很难与代码很好地配合。如以后需要修改它，无疑会成为一场噩梦，因为根本不知道“100”到底是指“数组大小”还是“其他全然不同的东西”。所以，我们应创建一个常数，并为其使用具有说服力的描述性名称，并在整个程序中都采用常数标识符。这样可使程序更易理解以及更易维护。

(13) 涉及构建器和异常的时候，通常希望重新丢弃在构建器中捕获的任何异常——如果它造成了那个对象的创建失败。这样一来，调用者就不会以为那个对象已正确地创建，从而盲目地继续。

(14) 当客户程序员用完对象以后，若你的类要求进行任何清除工作，可考虑将清除代码置于一个良好定义的方法里，采用类似于cleanup()这样的名字，明确表明自己的用途。除此以外，可在类内放置一个boolean（布尔）标记，指出对象是否已被清除。在类的finalize()方法里，请确定对象已被清除，并已丢弃了从RuntimeException继承的一个类（如果还没有的话），从而指出一个编程错误。在采取象这样的方案之前，请确定finalize()能够在自己的系统中工作（可能需要调用System.runFinalizersOnExit(true)，从而确保这一行为）。

(15) 在一个特定的作用域内，若一个对象必须清除（非由垃圾收集机制处理），请采用下述方法：初始化对象；若成功，则立即进入一个含有finally从句的try块，开始清除工作。

(16) 若在初始化过程中需要覆盖（取消）finalize()，请记住调用super.finalize()（若Object属于我们的直接超类，则无此必要）。在对finalize()进行覆盖的过程中，对super.finalize()的调用应属于最后一个行动，而不应是第一个行动，这样可确保在需要基础类组件的时候它们依然有效。

(17) 创建大小固定的对象集合时，请将它们传输至一个数组（若准备从一个方法里返回这个集合，更应如此操作）。这样一来，我们就可享受到数组在编译期进行类型检查的好处。此外，为使用它们，数组的接收者也许并不需要将对象“造型”到数组里。

(18) 尽量使用interfaces，不要使用abstract类。若已知某样东西准备成为一个基础类，那么第一个选择应是将其变成一个interface（接口）。只有在不得不使用方法定义或者成员变量的时候，才需要将其变成一个abstract（抽象）类。接口主要描述了客户希望做什么事情，而一个类则致力于（或允许）具体的实施细节。

(19) 在构建器内部，只进行那些将对象设为正确状态所需的工作。尽可能地避免调用其他方法，因为那些方法可能被其他人覆盖或取消，从而在构建过程中产生不可预知的结果。

(20) 对象不应只是简单地容纳一些数据；它们的行为也应得到良好的定义。

(21) 尽量少的使用继承。只有自己的设计要求必须继承时，才应考虑这方面的问题。若在本来允许新建的场合使用了继承，则整个设计会变得没有必要地复杂。

(22) 用继承及方法覆盖来表示行为间的差异，而用字段表示状态间的区别。一个非常极端的例子是通过对不同类的继承来表示颜色，这是绝对应该避免的：应直接使用一个“颜色”字段。

(23) 每个名字都仅对应一个类。否则，编译器可能先找到同名的另一个类，并报告出错消息。若怀疑自己碰到了类路径问题，请试试在类路径的每一个起点，搜索一下同名的.class文件。

(24) 在Java 1.1 AWT中使用事件“适配器”时，特别容易碰到一个陷阱。若覆盖了某个适配器方法，同时拼写方法没有特别讲究，最后的结果就是新添加一个方法，而不是覆盖现成方法。然而，由于这样做是完全合法的，所以不会从编译器或运行期系统获得任何出错提示——只不过代码的工作就变得不正常了。

(25) 用合理的设计方案消除“伪功能”。也就是说，假若只需要创建类的一个对象，就不要提前限制自己使用应用程序，并加上一条“只生成其中一个”注释。请考虑将其封装成一个“独生子”的形式。若在主程序里有大量散乱的代码，用于创建自己的对象，请考虑采纳一种创造性的方案，将些代码封装起来。

(26) 警惕“分析瘫痪”。请记住，无论如何都要提前了解整个项目的状况，再去考察其中的细节。由于把握了全局，可快速认识自己未知的一些因素，防止在考察细节的时候陷入“死逻辑”中。

(27) 警惕“过早优化”。首先让它运行起来，再考虑变得更快——但只有在自己必须这样做、而且经证实在某部分代码中的确存在一个性能瓶颈的时候，才应进行优化。除非用专门的工具分析瓶颈，否则很有可能是在浪费自己的时间。性能提升的隐含代价是自己的代码变得难于理解，而且难于维护。

(28) 请记住，阅读代码的时间比写代码的时间多得多。思路清晰的设计可获得易于理解的程序，但注释、细致的解释以及一些示例往往具有不可估量的价值。无论对你自己，还是对后来的人，它们都是相当重要的。如对此仍有怀疑，那么请试想自己试图从联机Java文档里找出有用信息时碰到的挫折，这样或许能将你说服。

(29) 如认为自己已进行了良好的分析、设计或者实施，那么请稍微更换一下思维角度。试试邀请一些外来人士——并不一定是专家，但可以是来自本公司其他部门的人。请他们用完全新鲜的眼光考察你的工作，看看是否能找出你一度熟视无睹的问题。采取这种方式，往往能在最适合修改的阶段找出一些关键性的问题，避免产品发行后再解决问题而造成的金钱及精力方面的损失。

(30) 良好的设计能带来最大的回报。简言之，对于一个特定的问题，通常会花较长的时间才能找到一种最恰当的解决方案。但一旦找到了正确的方法，以后的工作就轻松多了，再也不用经历数小时、数天或者数月的痛苦挣扎。我们的努力工作会带来最大的回报（甚至无可估量）。而且由于自己倾注了大量心血，最终获得一个出色的设计方案，成功的快感也是令人心动的。坚持抵制草草完工的诱惑——那样做往往得不偿失。

##　Java编码规范

俗话说：“没有规矩不成方圆”。编程工作往往都是一个团队协同进行，因而一致的编码规范非常有必要，这样写成的代码便于团队中的其他人员阅读，也便于编写者自己以后阅读。

2.1　命名规范

程序代码中到处都是标识符，因此取一个一致并且符合规范的名字非常重要。

命名方法很多，但是比较有名的且被广泛接受的命名法包括下面两种。

匈牙利命名，一般只是命名变量，原则是：变量名 = 类型前缀 + 描述，如bFoo表示布尔类型变量，pFoo表示指针类型变量。匈牙利命名还是有一定争议的，在Java编码规范中基本不被采用。
驼峰命名（Camel-Case），又称“骆驼命名法”，是指混合使用大小写字母来命名。驼峰命名又分为小驼峰法和大驼峰法。小驼峰法就是第一个单词是全部小写，后面的单词首字母大写，如myRoomCount；相比小驼峰法，大驼峰法把第一个单词的首字母也大写了。常用于类名，函数名，属性，命名空间。譬如public class StudentInfomation;
补充说明，在JAVA中：类名的标识符一般用大驼峰式书写格式，方法和变量的标识符则多用小驼峰式书写格式。

除了包和常量外，Java编码规范命名方法采用驼峰法，下面分类说明一下。

- 包名：包名是全小写字母，中间可以由点分隔开。作为命名空间，包名应该具有唯一性，推荐采用公司或组织域名的倒置，如com.apple.quicktime.v2。但Java核心库包名不采用域名的倒置命名，如java.awt.event。
- 类和接口名：采用大驼峰法，如SplitViewController。
- 文件名：采用大驼峰法，如BlockOperation.java。
- 变量：采用小驼峰法，如studentNumber。
- 常量名：全大写，如果是由多个单词构成，可以用下划线隔开，如YEAR和WEEK_OF_MONTH。
- 方法名：采用小驼峰法，如balanceAccount、isButtonPressed等。

命名规范示例如下：

package com.wjh;

public class Date extends java.util.Date {

    private static final int DEFAULT_CAPACITY = 10;

    private int size;

    public static Date valueOf(String s) {

        final int YEAR_LENGTH = 4;
        final int MONTH_LENGTH = 2;

        int firstDash;
        int secondDash;
        ...
    }

    public String toString () {
        int year = super.getYear() + 1900;
        int month = super.getMonth() + 1;
        int day = super.getDate();
        ...
    }
}

2.2　注释规范

Java中注释的语法有三种：单行注释（//）、多行注释（/…/）和文档注释（/**…*/）。本节介绍如何规范使用这些注释。

2.2.1　文件注释

文件注释就是在每一个文件开头添加注释。文件注释通常包括如下信息：版权信息、文件名、所在模块、作者信息、历史版本信息、文件内容和作用等。

下面看一个文件注释的示例：

/*
* 版权所有 xxx
* 许可信息查看LICENSE.txt文件
* 描述:
*   实现日期基本功能
* 历史版本:
*   2015-7-22: xxx
*   2015-8-20: xxx
*   2015-8-22: xxx
*/

上述注释只是提供了版权信息、文件内容和历史版本信息等，文件注释要根据本身的实际情况包括内容。

2.2.2　文档注释

文档注释就是指这种注释内容能够生成API帮助文档，JDK中javadoc命令能够提取这些注释信息并生成HTML文件。文档注释主要对类（或接口）、实例变量、静态变量、实例方法和静态方法等进行注释。

提示　文档是要给别人看的帮助文档，一般注释的实例变量、静态变量、实例方法和静态方法都应该是非私有的，那些只给自己看的内容可以不用文档注释。

文档注释示例：

package com.wjh;

/**
 * 自定义的日期类，具有日期基本功能，继承java.util.Date
 * <p>实现日期对象和字符串之间的转换</p>
 * @author wjh
 */
public class Date extends java.util.Date {

    private static final int DEFAULT_CAPACITY = 10;

    /**
     * 容量
     */
    public int size;

    /**
     * 将字符串转换为Date日期对象
     * @param s 要转换的字符串
     * @return Date日期对象
     */
    public static Date valueOf(String s) {

        final int YEAR_LENGTH = 4;
        final int MONTH_LENGTH = 2;

        int firstDash;
        int secondDash;

      ...
    }

    /**
     * 将日期转换为yyyy-mm-dd格式的字符串
     * @return yyyy-mm-dd格式的字符串
     */
    public String toString () {
        int year = super.getYear() + 1900;
        int month = super.getMonth() + 1;
        int day = super.getDate();
      ...
    }
}

由于文档注释最终会生成HTML文档，所以可以在文档注释中使用HTML标签，上述注释中的

是HTML段落标签。

另外，上述的文档注释中还用到了@author、@return和@param等文档注释标签，这些标签能够方便生成API帮助文档，下图所示是常用的文档注释标签。
文档注释标签
在这里插入图片描述

如果你想生成API帮助文档，可以使用javadoc指令在命令行中输入javadoc -d apidoc Data.java指令，-d参数指明要生成文档的目录，apidoc是当前目录下面的apidoc目录，如果不存在javadoc会创建一个apidoc目录；Data.java是当前目录下的Java源文件。
在这里插入图片描述

如果生成成功则在当前apidoc目录下生成很多HTML文件，其中的index.html文件是文档的入口，双击此文件，从页面中可见在Date.java中注释的内容会出现在HTML页面中。

注意　javadoc生成文档中的一些中文翻译与本书不一致，如“构造器”是本书中“构造方法”，文档中的“字段”包括了本书中“实例变量”和“静态变量”。

2.2.3　代码注释

程序代码中处理文档注释还需要在一些关键的地方添加代码注释，文档注释一般是给一些看不到源代码的人看的帮助文档，而代码注释是给阅读源代码的人参考的。代码注释一般是采用单行注释（//）和多行注释（/…/）。

示例代码如下：

public class Date extends java.util.Date {

    // 默认的容量，是一个常量  ①
    private static final int DEFAULT_CAPACITY = 10;

    /**
     * 容量
     */
    public int size;

    /**
     * 将字符串转换为Date日期对象
     * @param s 要转换的字符串
     * @return Date日期对象
     */
    public static Date valueOf(String s) {

        final int YEAR_LENGTH = 4;
        final int MONTH_LENGTH = 2;

        int firstDash;
        int secondDash;

        Date d = null;
        ...

        /*                             ②
        * 判断d是否为空，
        * 如果为空抛出异常IllegalArgumentException，否则返回d。
        */
        if (d == null) {
            throw new java.lang.IllegalArgumentException();
        }

        return d;
    }

    /**
     * 将日期转换为yyyy-mm-dd格式的字符串
     * @return yyyy-mm-dd格式的字符串
     */
    public String toString () {
        int year = super.getYear() + 1900; //计算年份   ③
        int month = super.getMonth() + 1; /*计算月份*/  ④
        int day = super.getDate();
        ...
    }
}

上述代码第①行采用了单行注释，要求与其后的代码具有一样的缩进层级。如果注释的文字很多，可以采用多行注释，见代码第②行。多行注释也要求与其后的代码具有一样的缩进层级。有时也会在代码的尾端进行注释，这要求注释内容极短，应该再有足够的空白来分开代码和注释，见代码第③行和第④行。

2.2.4　使用地标注释

Eclipse等IDE工具都为Java源代码提供了一些特殊的注释，就是在代码中加一些标识，便于IDE工具快速定位代码，称为“地标注释”。这种注释虽然不是Java官方所提供的，但是主流语言和主流的IDE工具也都支持“地标注释”。

Eclipse、IDEA等工具支持如下三种地标注释：

//TODO：说明此处有待处理的任务，或代码没有编写完成。
//FIXME：说明此处代码是错误的，需要修正。
//XXX：说明此处代码虽然实现了功能，但是实现的方法有待商榷，希望将来能改进。

示例代码如下：

    @Override
    public Order findById(int orderid) {
        // TODO 自动生成的方法存根
        return null;
    }

    @Override
    public int modify(Order order) {
        // FIXME 方法无返回值
        return 0;
    }

    @Override
    public int remove(Order order) {
        // XXX 可采用数据连接池
        return 0;
    }

这些注释在Eclipse工具的任务视图查看，如果没有打开任务视图，可以通过菜单“窗口”→“显示视图”→“任务”，双击其中的任务可以跳转到注释处。

2.3　代码排版

代码排版包括空行、空格、断行和缩进等内容。代码排版内容比较多，工作量很大，也非常重要。

2.3.1　空行

空行用以将逻辑相关的代码段分隔开，以提高可读性。空行使用规范：

类声明和接口声明之间保留两个空行。见示例Date.java代码第⑧行和第⑨行。
两个方法之间保留一个空行。见示例Date.java代码第⑦行。
方法的第一条语句之前保留一个空行。见示例Date.java代码第⑤行。
代码注释（尾端注释外）之前保留一个空行。见示例Date.java代码第①、②、③、④行。
一个方法内的两个逻辑段之间。见示例Date.java代码第⑥行。

示例Date.java代码如下：

/*
* 版权所有 2015 xxx
* 许可信息查看LICENSE.txt文件
* 描述:
*   实现日期基本功能
* 历史版本:
*   2015-7-22: xxx
*   2015-8-20: xxx
*   2015-8-22: xxx
*/
package com.wjh;
    ①
/**
 * 自定义的日期类，具有日期基本功能，继承java.util.Date
 * <p>实现日期对象和字符串之间的转换</p>
 * @author wjh
 */
public class Date extends java.util.Date {
         ②
    // 默认的容量，是一个常量
    private static final int DEFAULT_CAPACITY = 10;
                ③
    /**
     * 容量
     */
    public int size;
            ④
    /**
     * 将字符串转换为Date日期对象
     * @param s 要转换的字符串
     * @return Date日期对象
     */
    public static Date valueOf(String s) {
            ⑤
        final int YEAR_LENGTH = 4;
        final int MONTH_LENGTH = 2;

        int firstDash;
        int secondDash;
                ⑥
        Date d = null;
        ...

        /*
        * 判断d是否为空，
        * 如果为空抛出异常IllegalArgumentException，否则返回d。
        */
        if (d == null) {
            throw new java.lang.IllegalArgumentException();
        }

        return d;
    }
                ⑦
    /**
     * 将日期转换为yyyy-mm-dd格式的字符串
     * @return yyyy-mm-dd格式的字符串
     */
    public String toString () {

        int year = super.getYear() + 1900; //计算年份
        int month = super.getMonth() + 1; /*计算月份*/
        int day = super.getDate();
        ...
    }
}

                ⑧
class A {

}

                ⑨
class B {

}

2.3.2　空格

代码中的有些位置是需要有空格的，这个工作量也很大。下面是使用空格的规范：

1**. 赋值符号“=”前后各有一个空格**。示例如下：

int YEAR_LENGTH = 4;
int day = super.getDate();

所有的二元运算符都应该使用空格与操作数分开。示例如下：
```
a += c + d;
prints("size is " + foo + "\n");
```
一元操作符：负号“-”、自增“++”和自减“–”等，它们与操作数之间没有空格。示例如下：
```
int a = -b;
a++;
--b;
```
小左括号“(”之后，小右括号“)”之前不应有空格。示例如下：
```
a = (a + b) / (c * d)
```
大左括号“{”之前有一个空格。示例如下：
```
while (a == d) {
    n += 1
}
```
方法参数列表小左括号“(”之前没有空格，小右括号“)”之后有一个空格，参数列表中参数逗号“,”之后也有一个空格。示例如下：
```
String format(Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition) {
        ...
}
```
**关键字之后紧跟着小左括号“(”，关键字之后应该有一个空格。**如下示例中while之后有一个空格。
```
while (a == d) {
    ...
}
```

2.3.3　缩进

4个空格常被作为缩进排版的一个单位。虽然在开发时程序员使用制表符进行缩进，而默认情况下一个制表符等于8个空格，但是不同的IDE工具中一个制表符与空格对应个数会有不同。Eclipse中默认是一个制表符对应4个空格。

缩进可以依据一般规范，如下。

在方法、Lambda、控制语句等包含大括号“{}”的代码块中，代码块的内容相对于首行缩进一个级别（4个空格）。
如果是if语句中条件表达式的断行，那么新的一行应该相对于上一行缩进两个级别（8个空格），再往后的断行要与第一次的断行对齐。

示例如下：

public class Date extends java.util.Date {

    …

    public String getString() {

        int year = super.getYear() + 1900; // 计算年份
        int month = super.getMonth() + 1; /* 计算月份 */
        int day = super.getDate();

        if ((longName1 == longName2)
                || (longName3 == longName4) && (longName3 > longName4)     ①
                && (longName2 > longName5)) {  ②

        }

        return null;
    }
}

上述代码第①行和第②行是if语句条件表达式的断行，代码第①行和第②行要对齐。

2.3.4　断行

一行代码的长度应尽量不要超过80个字符，如果超过则需断行，可以依据下面的一般规范断开：

在一个逗号后面断开。
在一个操作符前面断开，要选择较高级别的运算符（而非较低级别的运算符）断开。
新的一行应该相对于上一行缩进两个级别（8个空格）。

下面通过一些示例说明：

longName1 = longName2 * (longName3 + longName4 - longName5)
        + 4 * longName6    ①
longName1 = longName2 * (longName3 + longName4
        - longName5) + 4 * longName6  ②

private static DateFormat get(int timeStyle, int dateStyle,
                                  int flags, Locale loc) {  ③
    ...
}

if ((longName1 == longName2)
    || (longName3 == longName4) && (longName3 > longName4)
    && (longName2 > longName5)) {    ④

}

 boolName1 = (longName3 == longName4)
     ? (longName3 > longName4)
     : (longName2 > longName5);     ⑤

上述代码第①行和第②行是带有小括号运算的表示式，其中代码第①行的断开位置要比第②行的断开位置要好。因为代码第①行断开处位于括号表达式的外边，这是个较高级别的断开。

代码第③行是方法名断开是在参数逗号之后。

代码第④行是if判断语句，由于可能有很多长的条件表达式，断开的位置应在逻辑运算符处。

代码第⑤行是三元运算符的断开。

2.4　其他规范

除了上述规范外，还有很多零散的规范，下面补充一些重要的规范。

**在声明变量或常量时推荐一行一个声明。**示例如下：

推荐使用：
```
int longName1 = 0 ;
int longName2 = 0 ;
```
不推荐使用：
```
int longName1 = 0, longName2 = 0 ;
```

**左大括号“{”位于声明语句同行的末尾。右大括号“}”另起一行，与相应的声明语句对齐，除非是一个空语句，右大括号“}”应紧跟在左大括号“{”之后。**示例如下：

public class Date extends java.util.Date {

    int longName1 = 0;
    int longName2 = 0;

    boolean boolName1 = true;

    public String getString() {

        int year = super.getYear() + 1900; // 计算年份
        int month = super.getMonth() + 1; /* 计算月份 */
        int day = super.getDate();

        return null;
    }

    public void setString() {}
}

**每行至多包含一条语句。**示例如下：

推荐使用：
```
argv++;
argc--;
```
不推荐使用：
```
argv++; argc--;
```

虽然**Java语言允许if、for等控制语句只有一行代码情况下，省略左右两个大括号，但是编码规范并不推荐这样使用。**示例如下：

推荐使用：

if (1 == 3) {
    x = 2.3;
}

不推荐使用：

if (1 == 3)
    x = 2.3;

public String getString() {

    int year = super.getYear() + 1900; // 计算年份
    int month = super.getMonth() + 1; /* 计算月份 */
    int day = super.getDate();

    return null;
}

public void setString() {}

}

每行至多包含一条语句。示例如下：

推荐使用：
```
argv++;
argc--;
```
不推荐使用：
```
argv++; argc--;
```
虽然Java语言允许if、for等控制语句只有一行代码情况下，省略左右两个大括号，但是编码规范并不推荐这样使用。示例如下：

推荐使用：
```
if (1 == 3) {
    x = 2.3;
}
```
不推荐使用：
```
if (1 == 3)
    x = 2.3;
```
关于规范事实上还有很多，不能穷尽，这里就不再赘述了。