跳轉到內容

編碼規範

100% developed
來自華夏公益教科書

導航 語言基礎 主題:v  d  e )


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.
  }
}


華夏公益教科書