获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

使用 Web 上的数据列表

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

获取数据库参考

要从数据库读取或写入数据,您需要一个firebase.database.Reference实例:

Web version 9

import { getDatabase } from "firebase/database";

const database = getDatabase();

Web version 8

var database = firebase.database();

阅读和写作清单

附加到数据列表

使用push()方法将数据附加到多用户应用程序中的列表。每次将新子项添加到指定的 Firebase 引用时, push()方法都会生成一个唯一键。通过为列表中的每个新元素使用这些自动生成的键,多个客户端可以同时将子元素添加到同一位置,而不会发生写入冲突。 push()生成的唯一键基于时间戳,因此列表项会自动按时间顺序排列。

您可以使用对push()方法返回的新数据的引用来获取子项自动生成的键的值或为子项设置数据。 push()引用的.key属性包含自动生成的密钥。

您可以使用这些自动生成的键来简化数据结构的扁平化。有关详细信息,请参阅数据扇出示例

例如, push()可用于将新帖子添加到社交应用程序的帖子列表中:

Web version 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, {
    // ...
});

Web version 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事件(基于您当前的 order-by 方法)。

这些中的每一个都可用于监听数据库中特定节点的更改。例如,社交博客应用程序可能会同时使用这些方法来监控帖子评论中的活动,如下所示:

Web version 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);
});

Web version 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观察器附加到数据列表将返回整个数据列表作为单个快照,然后您可以循环访问单个子节点。

即使查询只有一个匹配项,快照仍然是一个列表;它只包含一个项目。要访问该项目,您需要遍历结果:

Web version 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
});

Web version 8

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

当您想在单个操作中获取列表的所有子项而不是侦听附加的子项添加事件时,此模式很有用。

排序和过滤数据

您可以使用实时数据库Query类来检索按键、按值或按子值排序的数据。您还可以将排序结果筛选为特定数量的结果或键或值范围。

排序数据

要检索已排序的数据,请首先指定一种 order-by 方法来确定结果的排序方式:

方法用法
orderByChild()按指定子键或嵌套子路径的值对结果进行排序。
orderByKey()按子键排序结果。
orderByValue()按子值排序结果。

您一次只能使用一种排序方法。在同一个查询中多次调用 order-by 方法会引发错误。

以下示例演示了如何检索按星数排序的用户热门帖子列表:

Web version 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'));

Web version 8

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

这定义了一个查询,当与子侦听器结合使用时,该查询根据用户 ID 将客户端与数据库中路径中的用户帖子同步,按每个帖子收到的星数排序。这种使用 ID 作为索引键的技术称为数据扇出,您可以在Structure Your Database中了解更多信息。

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",
  }
},

在这种情况下,我们可以通过在orderByChild()调用中指定嵌套子项的相对路径,按嵌套在metrics键下的值对列表元素进行排序。

Web version 9

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

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

Web version 8

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

有关其他数据类型如何排序的详细信息,请参阅查询数据的排序方式

过滤数据

要过滤数据,您可以在构造查询时将任何限制或范围方法与 order-by 方法结合使用。

方法用法
limitToFirst()设置从有序结果列表的开头返回的最大项目数。
limitToLast()设置从有序结果列表末尾返回的最大项目数。
startAt()根据选择的 order-by 方法,返回大于或等于指定键或值的项目。
startAfter()根据选择的 order-by 方法返回大于指定键或值的项目。
endAt()根据选择的 order-by 方法,返回小于或等于指定键或值的项目。
endBefore()根据选择的 order-by 方法返回小于指定键或值的项目。
equalTo()根据选择的 order-by 方法,返回等于指定键或值的项目。

与 order-by 方法不同,您可以组合多个限制或范围函数。例如,您可以组合startAt()endAt()方法来将结果限制在指定的值范围内。

限制结果数量

您可以使用limitToFirst()limitToLast()方法来设置要为给定事件同步的最大子节点数。例如,如果您使用limitToFirst()将限制设置为 100,那么您最初最多只能收到 100 个child_added事件。如果您的 Firebase 数据库中存储的项目少于 100 个,则会为每个项目触发一个child_added事件。

随着项目的变化,您会收到进入查询的项目的child_added事件和退出查询的项目的child_removed事件,因此总数保持在 100。

以下示例演示了示例博客应用程序如何定义一个查询来检索所有用户最近发布的 100 个帖子的列表:

Web version 9

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

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

Web version 8

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

这个例子只定义了一个查询,要真正同步数据,它需要一个附加的监听器。

按键或值过滤

您可以使用startAt()startAfter()endAt()endBefore()equalTo()来选择查询的任意起点、终点和等价点。这对于对数据进行分页或查找具有特定值的子项非常有用。

查询数据如何排序

本节说明如何按Query类中的每个 order-by 方法对数据进行排序。

orderByChild

使用orderByChild()时,包含指定子键的数据按如下顺序排列:

  1. 具有指定子键的null值的子项首先出现。
  2. 接下来是指定子键的值为false的子项。如果多个孩子的值为false ,则它们按字典顺序键排序。
  3. 接下来是指定子键的值为true的子项。如果多个孩子的值为true ,则它们按字典顺序键排序。
  4. 接下来是具有数值的子项,按升序排列。如果指定子节点的多个子节点的数值相同,则按key排序。
  5. 字符串在数字之后,并按字典顺序升序排序。如果指定子节点的多个子节点具有相同的值,则它们按字典顺序键排序。
  6. 对象排在最后,并按关键字按字典顺序升序排序。

orderByKey

使用orderByKey()对数据进行排序时,数据按 key 升序返回。

  1. 具有可以被解析为 32 位整数的键的子项排在最前面,按升序排序。
  2. 以字符串值作为键的子项紧随其后,按字典顺序升序排序。

orderByValue

使用orderByValue()时,子项按其值排序。排序标准与orderByChild()中的相同,除了使用节点的值而不是指定子键的值。

分离监听器

通过在 Firebase 数据库引用上调用off()方法来删​​除回调。

您可以通过将单个侦听器作为参数传递给off()来删除它。在不带参数的位置调用off()会删除该位置的所有侦听器。

在父监听器上调用off()不会自动删除在其子节点上注册的监听器;还必须在任何子侦听器上调用off()以删除回调。

下一步