Coding conventions

The Java code conventions are defined by Oracle in the coding conventions document. In short, these conventions ask the user to use camel case when defining classes, methods, or variables. Classes start with a capital letter and should be nouns, like CalendarDialogView. For methods, the names should be verbs in imperative form, like getBrakeSystemType, and should start with a lowercase letter.

It is important to get used to and follow coding conventions, so that code written by multiple programmers will appear the same. Projects may re-define the standard code conventions to better fit their needs. Examples include a list of allowed abbreviations, as these can often make the code difficult to understand for other designers. Documentation should always accompany code.

One example from the coding conventions is how to define a constant. Constants should be written with capital letters in Java, where the words are separated by an underscore ('_') character. In the Java coding conventions, a constant is a static final field in a class.

The reason for this diversion is that Java discerns between "simple" and "complex" types. These will be handled in detail in the following sections. An example for a simple type is the byte type. An example for a complex type is a class. A subset of the complex types are classes that cannot be modified after creation, like a String, which is a concatenation of characters.

For instance, consider the following "constants":

publicclass MotorVehicle{
/** Number of motors */
privatestaticfinalintMOTORS=1;

/** Name of a motor */
privatestaticfinalStringMOTOR_NAME="Mercedes V8";

/** The motor object */
privatestaticfinalMotorTHE_MOTOR=newMercedesMotor();

/**
 * Constructor
 */
publicMotorVehicle(){
MOTORS=2;// Gives a syntax error as MOTORS has already been assigned a value.
THE_MOTOR=newToshibaMotor();// Gives a syntax error as THE_MOTOR has already been assigned a value.
MOTOR_NAME.toLowercase();// Does not give a syntax error, because it returns a new String rather than editing the MOTOR_NAME variable.
THE_MOTOR.fillFuel(20.5);// Does not give a syntax error, as it changes a variable in the motor object, not the variable itself.
}
}

• Book:Java Programming

• Pages using the JsonConfig extension