使用 Web 上的數據列表

獲取數據庫參考

要讀取或寫入數據從數據庫中,你需要的實例firebase.database.Reference

網頁版 9

import { getDatabase } from "firebase/database";

const database = getDatabase();

網頁版 8

var database = firebase.database();

閱讀和寫作清單

附加到數據列表

使用push()方法,將數據追加到多用戶應用程序的列表。所述push()方法生成的唯一密鑰每一個新的子被添加到指定的火力地堡基準時間。通過為列表中的每個新元素使用這些自動生成的鍵,多個客戶端可以同時將子項添加到同一位置而不會發生寫入衝突。通過生成的唯一的密鑰push()是基於時間戳,所以列表項將自動按時間順序排列。

您可以使用參考由返回的新數據push()方法來獲得孩子的孩子的自動生成的密鑰組數據的價值。所述.key的屬性push()參考包含自動生成的密鑰。

您可以使用這些自動生成的鍵來簡化數據結構的扁平化。有關詳細信息,請參閱數據扇出示例

例如, push()可用於一個新的職位添加到社交應用的帖子列表:

網頁版 9

import { getDatabase, ref, push, set } from "firebase/database";

// Create a new post reference with an auto-generated id
const db = getDatabase();
const postListRef = ref(db, 'posts');
const newPostRef = push(postListRef);
set(newPostRef, {
    // ...
});

網頁版 8

// Create a new post reference with an auto-generated id
var postListRef = firebase.database().ref('posts');
var newPostRef = postListRef.push();
newPostRef.set({
    // ...
});

監聽子事件

兒童事件響應碰巧從操作節點的兒童的具體操作引發的,如通過添加一個新的子push()方法或小孩在被更新update()方法。

事件典型用法
child_added檢索項目列表或監聽項目列表的添加。此事件為每個現有子項觸發一次,然後在每次將新子項添加到指定路徑時再次觸發。偵聽器被傳遞一個包含新孩子數據的快照。
child_changed偵聽列表中項目的更改。每當修改子節點時都會觸發此事件。這包括對子節點後代的任何修改。傳遞給事件偵聽器的快照包含子項的更新數據。
child_removed偵聽從列表中刪除的項目。當直接子節點被移除時會觸發此事件。傳遞給回調塊的快照包含被移除子節點的數據。
child_moved偵聽有序列表中項目順序的更改。 child_moved事件始終遵循child_changed導致該項目的為了改變事件(根據您目前的訂單,通過方法上)。

這些中的每一個都可以用於偵聽數據庫中特定節點的更改。例如,一個社交博客應用程序可能會結合使用這些方法來監控帖子評論中的活動,如下所示:

網頁版 9

import { getDatabase, ref, onChildAdded, onChildChanged, onChildRemoved } from "firebase/database";

const db = getDatabase();
const commentsRef = ref(db, 'post-comments/' + postId);
onChildAdded(commentsRef, (data) => {
  addCommentElement(postElement, data.key, data.val().text, data.val().author);
});

onChildChanged(commentsRef, (data) => {
  setCommentValues(postElement, data.key, data.val().text, data.val().author);
});

onChildRemoved(commentsRef, (data) => {
  deleteComment(postElement, data.key);
});

網頁版 8

var commentsRef = firebase.database().ref('post-comments/' + postId);
commentsRef.on('child_added', (data) => {
  addCommentElement(postElement, data.key, data.val().text, data.val().author);
});

commentsRef.on('child_changed', (data) => {
  setCommentValues(postElement, data.key, data.val().text, data.val().author);
});

commentsRef.on('child_removed', (data) => {
  deleteComment(postElement, data.key);
});

監聽值事件

雖然偵聽子事件是讀取數據列表的推薦方式,但在某些情況下偵聽列表引用上的值事件很有用。

附加value觀測到的數據列表將返回數據的整個列表作為一個單個快照,你可以再遍歷訪問個別兒童。

即使查詢只有一個匹配項,快照仍然是一個列表;它只包含一個項目。要訪問該項目,您需要遍歷結果:

網頁版 9

import { getDatabase, ref, onValue } from "firebase/database";

const db = getDatabase();
const dbRef = ref(db, '/a/b/c');

onValue(dbRef, (snapshot) => {
  snapshot.forEach((childSnapshot) => {
    const childKey = childSnapshot.key;
    const childData = childSnapshot.val();
    // ...
  });
}, {
  onlyOnce: true
});

網頁版 8

ref.once('value', (snapshot) => {
  snapshot.forEach((childSnapshot) => {
    var childKey = childSnapshot.key;
    var childData = childSnapshot.val();
    // ...
  });
});

當您想在單個操作中獲取列表的所有子項而不是偵聽附加的子項添加事件時,此模式非常有用。

排序和過濾數據

您可以使用實時數據庫Query類檢索的關鍵排序的數據,按值,或者由孩子的價值。您還可以將排序結果過濾為特定數量的結果或一系列鍵或值。

排序數據

要檢索已排序的數據,首先指定一種 order-by 方法來確定結果的排序方式:

方法用法
orderByChild()按指定子鍵或嵌套子路徑的值對結果進行排序。
orderByKey()按子鍵排序結果。
orderByValue()按子值對結果進行排序。

您只能同時使用一個次序的方法。在同一查詢中多次調用 order-by 方法會引發錯誤。

以下示例演示瞭如何檢索用戶按星數排序的熱門帖子列表:

網頁版 9

import { getDatabase, ref, query, orderByChild } from "firebase/database";
import { getAuth } from "firebase/auth";

const db = getDatabase();
const auth = getAuth();

const myUserId = auth.currentUser.uid;
const topUserPostsRef = query(ref(db, 'user-posts/' + myUserId), orderByChild('starCount'));

網頁版 8

var myUserId = firebase.auth().currentUser.uid;
var topUserPostsRef = firebase.database().ref('user-posts/' + myUserId).orderByChild('starCount');

這定義了查詢,當與結合孩子聽眾同步客戶端提供基於他們的用戶ID的數據庫路徑,用戶的帖子,下令恆星每個崗位收到的數量。使用ID作為索引鍵的這種技術被稱為數據扇出,你可以閱讀更多關於它在構建數據庫

在調用orderByChild()方法指定的子鍵由訂購的結果。在這種情況下,職位是由各自的值進行排序的"starCount"的孩子。查詢也可以按嵌套子項排序,以防您的數據如下所示:

"posts": {
  "ts-functions": {
    "metrics": {
      "views" : 1200000,
      "likes" : 251000,
      "shares": 1200,
    },
    "title" : "Why you should use TypeScript for writing Cloud Functions",
    "author": "Doug",
  },
  "android-arch-3": {
    "metrics": {
      "views" : 900000,
      "likes" : 117000,
      "shares": 144,
    },
    "title" : "Using Android Architecture Components with Firebase Realtime Database (Part 3)",
    "author": "Doug",
  }
},

在這種情況下,我們可以訂購我們通過在嵌套值列表元素metrics通過指定我們到嵌套子的相對路徑鍵orderByChild()調用。

網頁版 9

import { getDatabase, ref, query, orderByChild } from "firebase/database";

const db = getDatabase();
const mostViewedPosts = query(ref(db, 'posts'), orderByChild('metrics/views'));

網頁版 8

var mostViewedPosts = firebase.database().ref('posts').orderByChild('metrics/views');

有關其它數據類型如何排序的詳細信息,請參閱查詢數據是如何排序

過濾數據

要過濾數據,您可以在構建查詢時將任何限製或範圍方法與 order-by 方法結合使用。

方法用法
limitToFirst()設置從結果有序列表的開頭返回的最大項目數。
limitToLast()設置從結果有序列表的末尾返回的最大項目數。
startAt()返回大於或等於指定鍵或值的項目,具體取決於所選的排序方法。
startAfter()根據選擇的排序方法返回大於指定鍵或值的項目。
endAt()返回小於或等於指定鍵或值的項目,具體取決於所選的排序方法。
endBefore()根據選擇的排序方法,返回小於指定鍵或值的項目。
equalTo()返回等於指定鍵或值的項目,具體取決於所選的 order-by 方法。

與 order-by 方法不同,您可以組合多個限製或範圍函數。例如,你可以結合startAt()endAt()方法來限制的結果,值的指定範圍。

限制結果數量

您可以使用limitToFirst()limitToLast()方法來設置兒童被同步為給定事件的最大數量。例如,如果你使用limitToFirst()設置的100個限度,你最初只獲得高達100 child_added事件。如果您有存儲在您的火力地堡數據庫,少於100個項目child_added事件觸發每個項目。

隨著項目的變化,您會收到child_added事件即進入查詢和物品child_removed事件,在100它的輟學,使總數停留項目。

以下示例演示示例博客應用程序如何定義查詢以檢索所有用戶最近發布的 100 篇文章的列表:

網頁版 9

import { getDatabase, ref, query, limitToLast } from "firebase/database";

const db = getDatabase();
const recentPostsRef = query(ref(db, 'posts'), limitToLast(100));

網頁版 8

var recentPostsRef = firebase.database().ref('posts').limitToLast(100);

本實施例中僅定義了一個查詢,來實際同步數據它需要有一個附加的監聽器

按鍵或值過濾

您可以使用startAt() startAfter() endAt() endBefore()equalTo()選擇任意的開始,結束,以及查詢等當點。這對於分頁數據或查找具有特定值的子項的項目非常有用。

查詢數據的排序方式

本節介紹如何將數據由每個訂單由方法來分類的Query類。

orderByChild

當使用orderByChild()包含指定的子鍵如下排序的數據:

  1. 與兒童null的指定子鍵值是第一位的。
  2. 用價值孩子false的指定子鍵來下。如果有多個孩子的價值false ,它是按照字典序的關鍵。
  3. 用價值孩子true用於指定的子鍵來下。如果有多個孩子的價值true ,它們是由鍵按字典順序排序。
  4. 接下來是帶有數值的孩子,按升序排序。如果指定子節點的多個子節點具有相同的數值,則它們按鍵排序。
  5. 字符串在數字之後,按字典順序升序排列。如果指定子節點的多個子節點具有相同的值,則它們按字典順序按關鍵字排序。
  6. 對象排在最後,並按字典順序按鍵升序排序。

orderByKey

當使用orderByKey()對數據進行排序,數據在由鍵升序返回。

  1. 具有可以解析為 32 位整數的鍵的子項首先出現,按升序排序。
  2. 接下來是以字符串值作為鍵的子項,按字典順序升序排列。

orderByValue

當使用orderByValue()孩子們通過自己的價值排序。排序標準是一樣orderByChild()除了節點的值被用來代替一個指定的子密鑰的值。

分離監聽器

回調是通過調用刪除off()在你的火力地堡數據庫的參考方法。

你可以把它當作一個參數來刪除單個監聽器off()調用off()上不帶參數的位置刪除該位置處的所有聽眾。

調用off()對父母聽眾不會自動刪除其子結點註冊的偵聽器; off()也必須在任何一個孩子叫聽眾刪除回調。

下一步