編碼規範
外觀
| 導航 語言基礎 主題: |
Java 程式碼規範由 Oracle 在編碼規範文件中定義。簡而言之,這些規範要求使用者在定義類、方法或變數時使用駝峰式大小寫。類以大寫字母開頭,應該是名詞,例如 CalendarDialogView。對於方法,名稱應該是祈使句形式的動詞,例如 getBrakeSystemType,並且應該以小寫字母開頭。
熟悉並遵循編碼規範非常重要,這樣由多個程式設計師編寫的程式碼看起來會一致。專案可能會重新定義標準程式碼規範,以更好地滿足其需求。例如,可以列出允許的縮寫,因為這些縮寫可能會讓其他設計人員難以理解程式碼。文件應該始終伴隨程式碼。
編碼規範的一個例子是定義常量的方式。在 Java 中,常量應該用大寫字母編寫,單詞之間用下劃線 ('_') 分隔。在 Java 編碼規範中,常量是類中的 static final 欄位。
之所以這樣區分是因為 Java 區分了“簡單”型別和“複雜”型別。將在接下來的部分詳細討論它們。byte 型別是簡單型別的示例。類是複雜型別的示例。複雜型別的一個子集是建立後無法修改的類,比如 String,它是一個字元的連線。
例如,考慮以下“常量”
public class MotorVehicle {
/** Number of motors */
private static final int MOTORS = 1;
/** Name of a motor */
private static final String MOTOR_NAME = "Mercedes V8";
/** The motor object */
private static final Motor THE_MOTOR = new MercedesMotor();
/**
* Constructor
*/
public MotorVehicle() {
MOTORS = 2; // Gives a syntax error as MOTORS has already been assigned a value.
THE_MOTOR = new ToshibaMotor(); // 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.
}
}