The following rules outline the formatting guidelines for indentation and braces:
Ø Indentation should be 4 space characters (tabs usage is prohibited).
Ø Open brace should reside on the same line as related construct.
Ø Case labels should use indentation.
Ø All flow control primitives (if, else, while, for, do, switch) shall be followed by braces, even if they have single operation.
Ø Methods, fields and nested types should be separated by single empty line. Related fields can be placed on the sequential lines however.
Ø When instruction spares several lines, second and subsequent ones should be indented with 4 space characters.
Ø If necessary, method logic can contain empty lines if it increases understandability (however, small methods strongly encouraged).
For example:
public class Point extends EventArgs {
private final double x;
private final double y;
public Point(double x, double y) {
this.x = x;
this.y = y;
}
public double getX() {
return x;
}
public double getY() {
return y;
}
public PointType getType() {
double radius = x * x + y * y;
if (Math.abs(radius – 1.0) < 0.000001) {
return PointType.PERIODIC;
}
if (radius < 1.0) {
return PointType.CONVERGING;
}
return PointType.DIVERGENT;
}
}
