4.8.1. 枚举类

用逗号(,)分隔每个枚举常量，也可以用换行。

enum Color {
    RED,
    GREEN,
    YELLOW
}

enum Action {
    CREATE, READ, UPDATE, DELETE
}

4.8.2. 变量声明

4.8.3. 数组

• 初始化换行原则

  数组初始化通常不换行。在需要换行时，原则和普通代码块保持一致

new int[] {
    0, 1, 2, 3
}

new int[] {
    0, 1,
    2, 3
}

new int[] {
    0,
    1,
    2,
    3,
}

• 不要使用C的数组声明风格

  [J022] 必须用String[] args的方式来声明数组，而非String args[]。

4.8.4. switch语句

[J024] 说明：一个switch块包含了一个或多个语句组。每组都以一个或多个标签开头（如case 0:或者default:），后面跟着一个或多个语句。

• 缩进

  • switch块内的内容，使用4个空格缩进。
  • 在每个标签后换行，换行后缩进4个空格，下一个标签恢复原缩进。

• [J023] case贯穿：禁止

  • case必须被终止（break、return和抛出异常）。不允许使用case贯穿，这种风格容易导致bug。如有实际需要的场景，应使用if-else来实现。

• default

  • 每个switch中都要有default。
  • default也必须被终止（break、return和抛出异常）。
  • 在default预期不可能被执行的时候，应执行抛出异常等可以有效发现bug的动作。

switch (dayOfWeek) {
    case MONDAY:
        ...
        break;
    case TUESDAY:
        ...
        break;

    ...

    default:
        throw new RuntimeException("Unhandled case " + dayOfWeek);
}

4.8.5. 注解（Annotation）

[J025] 添加在类、方法、构造函数、成员属性上的注解（Annotation）直接写在注释块之后，每个注解独占一行。

@Override
@Nullable
public String getNameIfPresent() {
    ...
}

4.8.6. 注释

[J026] 块注释的缩进与其上下文保持一致，可以使用/* ... */或者// ...的风格。多行的块注释中*必须对齐。

/*
 * 可以
 * 这样
 */

// 也可以
// 这样

/* 或者甚至
 * 这样 */

4.8.7. 修饰符

[J027] 当同时使用多个修饰符时，按照下列顺序：

public protected private abstract static final transient volatile synchronized native strictfp

4.8.8. 数字

[J028] 长整型数字必须使用大写字母L结尾，不能使用小写字母l，以便和数字1进行区分。例如使用3000000000L而不是3000000000l

5.2.1. 包命名

[J029] 包名只允许使用小写字母和数字，并且单词直接连接（不允许使用下划线）。比如：com.baidu.somebusiness，而com.baidu.someBusiness或com.baidu.some_business是不允许的。

5.2.2. 类命名

[J030] 类名必须遵循大写字母开头的驼峰式命名方式（UpperCamelCase）。

类名通常使用名词或名词短语，比如：Customer、ImmutableList。接口名也可以是名词或名词短语（比如：List），但很多时候会使用形容词代替（比如：Runnable）。

对于注解（Annotation）命名没有特定的规定。

单测类的命名规则必须以被测试类名开始，Test单词结束。比如：BubbleSortTest。

5.2.3. 方法命名

5.2.4. 常量命名

[J032] 常量必须为大写单词，下划线分隔的命名方式。但什么是常量则没有特别精确的定义，需要主观判断。

首先常量一定是static final的字段，但是不是所有的static final字段都是常量。一个字段是否是常量需要按照语义进行判断。举例：如果一个变量的状态是可以改变的，那么几乎可以肯定它不是一个常量。仅仅看对象不可改变是不够的。

// 常量
static final int NUMBER = 5;
static final ImmutableList<String> NAMES = ImmutableList.of("Ed", "Ann");
static final Joiner COMMA_JOINER = Joiner.on(‘,‘);
static final SomeMutableType[] EMPTY_ARRAY = {};
enum SomeEnum {
    ENUM_CONSTANT
}

// 非常量
static String nonFinal = "non-final";
final String nonStatic = "non-static";
static final Set<String> mutableCollection = new HashSet<String>();
static final ImmutableSet<SomeMutableType> mutableElements = ImmutableSet.of(mutable);
static final Logger logger = Logger.getLogger(MyClass.getName());
static final String[] nonEmptyArray = {"these", "can", "change"};常量通常使用名词或名词短语。

5.2.5. 变量命名

5.2.6. 参数命名

5.2.7. 局部变量命名

5.2.8. 泛型类型变量命名

7.1.1. 通用

基础的Javadoc格式如下例：

/**
 * Multiple lines of Javadoc text are written here,
 * wrapped normally...
 */
public int method(String p1) {
    ...
}

7.1.2. 段落

除了第一段之外，后续段落描述应以<p>标签开始。段落首个文字可以紧接着<p>标签，也可以换行重新开始。

/**
 * Represents ....
 *
 * <p>More details here
 */
public class XXX {
    ...
}

/**
 * Represents ....
 *
 * <p>
 * New line is allowed.
 */
public class XXX {
    ...
}

7.2. 摘要

[J039] 每个类和成员的Javadoc需要以摘要片段来开头。这非常重要，因为Javadoc会自动抽取第一句话显示在索引和方法概述表中。写摘要片段的原则是简洁清晰。它不是一句完整的话，例如This is a ...，而是更接近短语，如A mutable sequence of characters.或Thrown when an exceptional arithmetic condition has occurred.。但在书写时采用类似句子的写法，以大写字母开头，并用.结尾。

7.3. Javadoc应该应用在哪些场合

至少Javadoc应该应用于所有的public类、public和protected的成员变量和方法，除了后面条款列举的例外情况。

除此之外的类和成员有时候也需要Javadoc。例如在需要总体解释一个类、方法、成员的具体实现逻辑的时候，通常会使用Javadoc替代注释。