設計時應確保 class (類別) 能獨立運作

就像我們生活中的吹風機、微波爐等家電，我們預設把插頭插上插座就可以使用了。
…
基本上操作只要按個按鈕就能運作，不會因為些微操作失誤就把電器用壞，製作者也不會提供損害物品的操作方式給使用者。

設計類別的思路也是同理，要設計成可以獨立運行，而不需繁瑣的初始設定也能直接使用。為了防止類別陷入異常狀態並產生 bug，只在外部提供外部能正確操作的函式。

何謂好的 class 結構

構成要素包含（缺一不可）：

• 成員變數
• 確保成員變數可以正常運行、不會陷入異常的函式

如何做到第二點的函式呢？
要進入下一個重點

所有 class 都有自我防衛的責任 - 設計可以獨當一面的 class

一定要用建構函式做初始化

為了防止半熟物件（partially initialized objects）的產生，應該在建構函式內進行適當的初始化流程，確保在物件建立時所有必要的變數都已經被正確設定。
這樣可以避免物件處於不完整或不一致的狀態，從而減少潛在的錯誤和問題。

class Person {

  // 在建構函式中檢查變數是否合法存在
  constructor(name, age) {
    if (!name || !age) {
      throw new Error("Name and age are required");
    }
    this.name = name;
    this.age = age;
  }

  // 之後才可以確保在函式中使用變數不會產生 error
  greet() {
    console.log(`Hello, my name is ${this.name} and I am ${this.age} years old.`);
  }
}

確保 class 不會被傳入無效值變數 & 用型別來防止「傳入錯誤的值」

class Person {
  constructor(name, age) {
    if (!name || !age) {
      throw new Error("Name and age are required");
    }

    // 防衛子句：檢查 name 是否存在且為字串
    if (typeof name !== 'string' || name.trim() === '') {
      throw new Error("Name is required and must be a non-empty string");
    }
    // 防衛子句：檢查 age 是否存在且為數字
    if (typeof age !== 'number' || isNaN(age) || age <= 0) {
      throw new Error("Age is required and must be a positive number");
    }

    this.name = name;
    this.age = age;
  }
  //...略
 }

將傳入的變數設置為不可變（immutable）

將傳入的變數設置為不可變（immutable）可以確保變數值在整個程式執行過程中不會被意外修改，從而避免潛在的錯誤和不一致性。這種做法有助於提高程式的穩定性和可預測性，特別是在多執行緒或複雜的應用程式中。

為什麼要設置變數為不可變

1. 防止意外修改：如果變數是不可變的，則無法在其他地方意外地修改它，這樣可以避免許多難以追蹤的錯誤。
2. 提高可讀性和可維護性：不可變的變數使程式碼更容易理解，因為你可以確信變數的值不會在其他地方被改變。
3. 安全性：在多執行緒環境中，不可變的變數可以避免競態條件（race conditions），因為它們不會被多個執行緒同時修改。

如何設置變數為不可變

在 JavaScript 中，可以使用 const 關鍵字來宣告不可變的變數。
此外，對於物件，可以使用 Object.freeze 方法來防止物件的屬性被修改。

那萬一要修改怎麼辦？

修改變數內容時直接建立新的物件

class Person {
  constructor(name, age) {
    if (typeof name !== 'string' || name.trim() === '') {
      throw new Error("Name is required and must be a non-empty string");
    }
    if (typeof age !== 'number' || isNaN(age) || age <= 0) {
      throw new Error("Age is required and must be a positive number");
    }

    this._name = name;
    this._age = age;

    // 將物件設置為不可變
    Object.freeze(this);
  }

  get name() {
    return this._name;
  }

  get age() {
    return this._age;
  }

  // 靜態方法來更新 Person 物件
  static update(person, newName, newAge) {
    return new Person(
      newName !== undefined ? newName : person.name,
      newAge !== undefined ? newAge : person.age
    );
  }

  greet() {
    console.log(`Hello, my name is ${this.name} and I am ${this.age} years old.`);
  }
}

try {
  const person1 = new Person('Alice', 30);
  person1.greet(); // Hello, my name is Alice and I am 30 years old.

  const person2 = Person.update(person1, 'Bob', 35);
  person2.greet(); // Hello, my name is Bob and I am 35 years old.

在 update 追加驗證

class Person {
  constructor(name, age) {
    this._validateName(name);
    this._validateAge(age);

    this._name = name;
    this._age = age;

    // 將物件設置為不可變
    Object.freeze(this);
  }

  get name() {
    return this._name;
  }

  get age() {
    return this._age;
  }

  // 靜態方法來只更新 age
  static updateAge(person, newAge) {
  // 在這裡也驗證 newAge 是否合法
    person._validateAge(newAge);

    return new Person(person.name, newAge);
  }

  greet() {
    console.log(`Hello, my name is ${this.name} and I am ${this.age} years old.`);
  }

  // 驗證 name 的方法
  _validateName(name) {
    if (typeof name !== 'string' || name.trim() === '') {
      throw new Error("Name is required and must be a non-empty string");
    }
  }

  // 驗證 age 的方法
  _validateAge(age) {
    if (typeof age !== 'number' || isNaN(age) || age <= 0) {
      throw new Error("Age is required and must be a positive number");
    }
  }
}

使用「值物件」+「完整建構函式」設計模式ㄉ大功告成！

我們使用「值物件」+「完整建構函式」設計模式，創建一個不可變且完全初始化的物件。

值物件（Value Object）

值物件（Value Object）是一種設計模式，用於表示一個簡單的、不可變的物件，其等價性基於其屬性的值，而不是物件的身份。
值物件通常用於表示簡單的概念，如金額、日期、座標等。

值物件的特點包括：

• 不可變性：一旦創建，值物件的狀態就不能改變。
• 等價性：值物件的等價性基於其屬性的值，而不是物件的身份。
• 自包含：值物件應該包含所有必要的邏輯和驗證，以確保其狀態始終有效。

完整建構函式（Complete Constructor）

完整建構函式是一個設計模式，用於__確保物件在創建時已經完全初始化，並且處於有效狀態。__

完整建構函式應該：

• 初始化所有必要的屬性：確保物件的所有屬性都被正確設置。
• 進行必要的驗證：在建構函式中進行所有必要的驗證，以確保物件的狀態有效。
• 防止半熟物件：確保物件在創建後不會處於不完整或不一致的狀態。
• 結合值物件和完整建構函式
• 結合值物件和完整建構函式，可以創建一個不可變且完全初始化的物件。

「值物件」+「完整建構函式」是物件導向裡最基礎的結構之一

可以呈現物件的含義和相關限制，從而編寫出堅固的程式碼！