Realtime Database 使用說明

2024-12-09 01:36 by @robi

Realtime Database 是一種雲端資料庫，讓應用程式可以即時同步資料，任何變更都會立即反映在所有連接的客戶端。它非常適合需要即時更新的應用程式，例如聊天應用程式、協作工具和線上遊戲。本文將逐步說明如何使用 Realtime Database。

1. 建立專案並設定 Firebase:

首先，你需要一個 Firebase 專案。如果還沒建立，請前往 Firebase console (https://console.firebase.google.com/) 建立一個新的專案。完成後，你需要在你的應用程式中加入 Firebase SDK。這步驟根據你使用的平臺 (例如 iOS, Android, Web) 而有所不同，詳情請參考 Firebase 官方文件。記住下載你的 google-services.json (或等效文件) 並正確地將它添加到你的專案中。

2. 資料結構:

Realtime Database 使用 JSON 來儲存資料。你的資料以樹狀結構組織，根節點是 /。你可以建立子節點來組織你的資料。好的資料結構對於效能和可維護性至關重要。避免過於扁平的結構，考慮使用明確的鍵值來組織你的資料。例如，一個儲存使用者資訊的資料庫，可以這樣設計：

{
  "users": {
    "user123": {
      "name": "John Doe",
      "email": "john.doe@example.com"
    },
    "user456": {
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    }
  }
}

3. 讀取資料:

使用 Firebase SDK 中的函式來讀取資料。你通常會使用參考 (reference) 來指定你想要讀取的資料位置。例如，要讀取 users 節點下的所有資料，你可以這樣做 (範例以 JavaScript 為主):

const db = firebase.database();
const usersRef = db.ref('users');

usersRef.on('value', (snapshot) => {
  const users = snapshot.val();
  console.log(users);
});

on('value', ...) 函式會監聽資料的任何變更。每次資料變更時，都會呼叫回呼函式，並提供最新的快照 (snapshot)。 snapshot.val() 會將快照轉換成 JavaScript 物件。如果你只需要讀取一次資料，可以使用 once('value', ...)。

4. 寫入資料:

寫入資料也很簡單，可以使用 set(), push(), update() 等方法。

set(): 覆蓋整個節點的資料。
push(): 新增一個新的子節點，並自動產生一個唯一的鍵。
update(): 更新節點的部分資料。

// 設定一個新的使用者
const newUserRef = usersRef.push();
newUserRef.set({
  name: "Peter Pan",
  email: "peter.pan@example.com"
});

// 更新現有使用者的電子郵件
usersRef.child('user123').update({
  email: "john.updated@example.com"
});

5. 監聽資料變更:

Realtime Database 最強大的功能之一是它的即時同步能力。使用 on() 函式，你可以監聽特定節點的資料變更，包括新增、修改和刪除。不同的事件類型，例如 child_added, child_changed, child_removed, child_moved 可以讓你在資料變更時更精準的處理。

6. 安全性規則:

安全性規則定義了誰可以讀取和寫入你的資料庫。你需要仔細設定安全性規則，以防止未經授權的存取。安全性規則使用 Firebase Security Rules 語法，這是一種基於 Firebase 安全模型的特殊語言。正確的安全性規則設定是至關重要的，可以保護你的資料。

7. 離線功能:

Firebase 提供離線功能，讓應用程式即使在沒有網路連線的情況下也能繼續運作。當應用程式重新連線時，所有未同步的變更都會自動同步到伺服器。

這篇文章提供了一個關於如何使用 Realtime Database 的概述。更多詳細資訊，請參考 Firebase 官方文件，其中包含各個平臺的程式碼範例和進階功能說明。記得在使用過程中，特別注意安全性規則的設定，以保護你的資料安全。

有想到什麼再寫什麼，沒想到什麼就算了

Realtime Database 使用說明

提示