从 Firebase Realtime Database 读取数据教程

聖光之護

发布时间：2025-10-19 13:29:26

265人浏览过

来源于php中文网

原创

从 firebase realtime database 读取数据教程

本文档旨在指导开发者如何从 Firebase Realtime Database 中读取数据，重点介绍如何处理具有动态子节点的数据库结构，并提供使用 `ValueEventListener` 和 `DataSnapshot` 读取数据的详细步骤和示例代码，同时强调数据模型与数据库结构的匹配的重要性。

在 Firebase Realtime Database 中读取数据，需要理解数据库的结构以及如何通过引用来访问特定的数据节点。以下将详细介绍如何从具有特定结构的数据库中读取数据，并提供相应的代码示例。

理解数据结构

假设数据库结构如下：

{
  "User": {
    "mail@gmail.com": {
      "-NHTVinbEVUAqJwK8Umt": {
        "getEmail": "mail@gmail.com",
        "coins": 100
      },
      "-NHTVinpCPOJ4UPZvgpN": {
        "getEmail": "mail@gmail.com",
        "coins": 200
      }
    }
  }
}

在这个结构中，User 是根节点，mail@gmail.com 是一个子节点，其下包含多个动态生成的键（例如 -NHTVinbEVUAqJwK8Umt 和 -NHTVinpCPOJ4UPZvgpN），每个键对应一个包含 getEmail 和 coins 字段的用户数据。

创建数据库引用

首先，需要创建一个指向特定节点的数据库引用。例如，要访问 mail@gmail.com 节点，可以使用以下代码：

DatabaseReference db = FirebaseDatabase.getInstance().getReference();
DatabaseReference emailRef = db.child("User").child("mail@gmail.com");

这段代码首先获取 Firebase 数据库的根引用，然后通过 child() 方法逐级向下访问到 mail@gmail.com 节点。

读取数据

要读取该节点下的数据，可以使用 get() 方法，并添加一个 OnCompleteListener 来处理异步任务的结果。

emailRef.get().addOnCompleteListener(new OnCompleteListener<DataSnapshot>() {
    @Override
    public void onComplete(@NonNull Task<DataSnapshot> task) {
        if (task.isSuccessful()) {
            for (DataSnapshot ds : task.getResult().getChildren()) {
                String email = ds.child("getEmail").getValue(String.class);
                Long coins = ds.child("coins").getValue(Long.class); // 使用 Long 类型
                Log.d("TAG", "Email: " + email + ", Coins: " + coins);
            }
        } else {
            Log.d("TAG", task.getException().getMessage()); // 打印错误信息
        }
    }
});

在这个例子中，task.getResult().getChildren() 返回一个包含所有动态子节点的 DataSnapshot 集合。通过遍历这个集合，可以访问每个子节点的数据。ds.child("getEmail").getValue(String.class) 用于获取 getEmail 字段的值，并将其转换为字符串类型。同样，ds.child("coins").getValue(Long.class) 用于获取 coins 字段的值，并将其转换为 Long 类型。

注意: 数据库中的数字默认会映射为Long类型，所以使用Integer可能会导致类型转换错误。

Cardify卡片工坊

使用Markdown一键生成精美的小红书知识卡片

下载

将 DataSnapshot 映射到 Java 对象

另一种读取数据的方法是将 DataSnapshot 对象映射到 Java 对象。为此，需要创建一个与数据库结构对应的 Java 类。例如：

public class User {
    private String getEmail;
    private Long coins;

    public User() {
        // 必须提供一个无参构造函数
    }

    public User(String getEmail, Long coins) {
        this.getEmail = getEmail;
        this.coins = coins;
    }

    public String getGetEmail() {
        return getEmail;
    }

    public Long getCoins() {
        return coins;
    }
}

然后，可以使用 ds.getValue(User.class) 将 DataSnapshot 对象转换为 User 对象：

emailRef.get().addOnCompleteListener(new OnCompleteListener<DataSnapshot>() {
    @Override
    public void onComplete(@NonNull Task<DataSnapshot> task) {
        if (task.isSuccessful()) {
            for (DataSnapshot ds : task.getResult().getChildren()) {
                User user = ds.getValue(User.class);
                Log.d("TAG", "Email: " + user.getGetEmail() + ", Coins: " + user.getCoins());
            }
        } else {
            Log.d("TAG", task.getException().getMessage());
        }
    }
});

这种方法更加简洁，但要求 Java 类的字段名与数据库中的字段名完全一致，并且必须提供一个无参构造函数。

实时监听数据变化

除了单次读取数据，还可以使用 ValueEventListener 实时监听数据的变化。当数据库中的数据发生变化时，ValueEventListener 会自动触发。

ValueEventListener valueEventListener = new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        for (DataSnapshot ds : snapshot.getChildren()) {
            User user = ds.getValue(User.class);
            Log.d("TAG", "Email: " + user.getGetEmail() + ", Coins: " + user.getCoins());
        }
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        Log.d("TAG", error.getMessage());
    }
};

emailRef.addValueEventListener(valueEventListener);

在这个例子中，onDataChange() 方法会在数据发生变化时被调用，onCancelled() 方法会在读取数据失败时被调用。

注意事项：