Руководство Google по форматированию кода на Java. Часть 2

// правильно
if (true) {

// неправильно
if (true)
{

// правильно
while (true) {
    // some code

// неправильно
while (true) { // some code

// правильно
for (true) {
    // some code
}

// неправильно
while (true) { /* some code */ }

// неправильно
if (true) {
    /* some code */ }

return () -> {
    while (condition()) {
        method();
   }
};

return new MyClass() {
    @Override public void method() {
        if (condition()) {
            try {
                something();
            } catch (ProblemException e) {
                recover();
            }
        } else if (otherCondition()) {
            somethingElse();
        } else {
            lastThing();
        }
        {
            int x = foo();
            frob(x);
        }
    }
};

// Приемлемо
void doNothing() {}

// Также приемлемо
void doNothingElse() {
}

// Неприемлемо: нельзя использовать пустые блоки в многоблочных операторах
try {
    doSomething();
} catch (Exception e) {}

MyLambda<String, Long, Object> lambda =
        (String label, Long value, Object obj) -> {
            ...
        };

Predicate<String> predicate = str ->
        longExpressionInvolving(str);

switch (x) {
    case ColorPoint(Color color, Point(int x, int y)) ->
            handleColorPoint(color, x, y);
    ...
}

private int x;       // хорошо
private Color color; // и это тоже

private int   x;      // разрешено, но при редактировании в будущем
private Color color;  // можно оставить без выравнивания

private enum Answer {
    YES {
        @Override public String toString() {
            return "yes";
        }
    },

    NO,
    MAYBE
}

private enum Suit { CLUBS, HEARTS, SPADES, DIAMONDS }

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

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

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

switch (number) {
    case 0, 1 -> handleZeroOrOne();
    case 2 ->
        handleTwoWithAnExtremelyLongMethodCallThatWouldNotFitOnTheSameLine();
    default -> {
        logger.atInfo().log("Surprising number %s", number);
        handleSurprisingNumber(number);
    }
}

switch (input) {
    case 1:
    case 2:
        prepareOneOrTwo();
        // fall through
    case 3:
        handleOneTwoOrThree();
        break;
    default:
        handleLargeNumber(input);
}

return switch (list.size()) {
    case 0 -> "";
    case 1 -> list.getFirst();
    default -> String.join(", ", list);
};

final @Nullable String name;

public @Nullable Person getPersonByName(String name);

/** Класс. */
@Deprecated
@CheckReturnValue
public final class Frozzler { ... }

/** Пакет. */
@Deprecated
@CheckReturnValue
package com.example.frozzler;

/** Модуль. */
@Deprecated
@SuppressWarnings("CheckReturnValue")
module com.example.frozzler { ... }

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

@Override public int hashCode() { ... }

@Partial @Mock DataLoader loader;

/*
 * This is          // And so           /* Or you can
 * okay.            // is this.          * even do this. */
 */

// TODO: crbug.com/12345678 - Удалить это после истечения окна совместимости 2047q4.

// TODO: @ваше_имя_пользователя - Создайте задачу и используйте '*' для повтора.

public protected private abstract default static final sealed non-sealed transient volatile synchronized native strictfp

transitive static