Android FireStore数据列表检索咨询（附已实现的数据推送代码）

嘿，既然你已经成功把TaskItem数据推送到Firestore的quotes集合里了，那把它们拉出来展示成列表其实很简单～ 下面我分两种常用场景给你讲具体的实现方式，都是基于Android Java的哈：

首先确认你的数据模型类（TaskItem）没问题 #

Firestore在反序列化数据的时候需要你的模型类满足两个核心条件：

• 有一个无参数的空构造函数（Firestore要用它来实例化对象）
• 字段的getter/setter方法要完整，或者给类加上@IgnoreExtraProperties注解，忽略那些没有对应字段的属性

比如你的TaskItem可以调整成这样：

import com.google.firebase.firestore.IgnoreExtraProperties;

@IgnoreExtraProperties
public class TaskItem {
    private String id;
    private String title;
    private String category;

    // 空构造函数必须要有，Firestore序列化需要
    public TaskItem() {}

    // 带参数的构造函数（可选，方便你手动创建对象）
    public TaskItem(String id, String title, String category) {
        this.id = id;
        this.title = title;
        this.category = category;
    }

    // 所有字段的getter和setter方法
    public String getId() { return id; }
    public void setId(String id) { this.id = id; }

    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }

    public String getCategory() { return category; }
    public void setCategory(String category) { this.category = category; }
}

方式一：一次性获取数据（适合不需要实时更新的场景） #

如果你只需要加载一次数据，不需要同步后续的增删改变化，可以用get()方法一次性拉取集合里的所有文档：

private void fetchQuotesOnce() {
    CollectionReference quotesRef = mFirestore.collection("quotes");

    quotesRef.get()
        .addOnSuccessListener(queryDocumentSnapshots -> {
            // 成功获取数据，把文档逐个转成TaskItem对象
            List<TaskItem> taskItemList = new ArrayList<>();
            for (QueryDocumentSnapshot document : queryDocumentSnapshots) {
                TaskItem item = document.toObject(TaskItem.class);
                // 可选：如果需要把Firestore文档的ID绑定到item里，加上这行
                item.setId(document.getId());
                taskItemList.add(item);
            }

            // 拿到列表后，就可以传给你的列表组件（比如RecyclerView的适配器）
            updateRecyclerView(taskItemList);
        })
        .addOnFailureListener(e -> {
            // 处理获取失败的情况，比如打印错误日志
            Log.e("Firestore", "获取数据失败", e);
        });
}

方式二：实时监听数据变化（推荐，适合需要实时同步的场景） #

Firestore的核心特性就是实时同步，用addSnapshotListener可以监听集合的所有变化（新增、修改、删除），一旦数据有变动，回调会自动触发，帮你更新列表：

// 保存监听引用，方便后续销毁时移除
private ListenerRegistration quotesListener;

private void setupRealtimeQuotesListener() {
    CollectionReference quotesRef = mFirestore.collection("quotes");

    // 添加实时监听
    quotesListener = quotesRef.addSnapshotListener((queryDocumentSnapshots, e) -> {
        if (e != null) {
            Log.e("Firestore", "监听数据失败", e);
            return;
        }

        if (queryDocumentSnapshots != null) {
            List<TaskItem> taskItemList = new ArrayList<>();
            for (QueryDocumentSnapshot document : queryDocumentSnapshots) {
                TaskItem item = document.toObject(TaskItem.class);
                // 可选：绑定Firestore文档ID到item
                item.setId(document.getId());
                taskItemList.add(item);
            }

            // 实时更新列表UI
            updateRecyclerView(taskItemList);
        }
    });
}

// 记得在页面销毁时移除监听，避免内存泄漏
@Override
protected void onDestroy() {
    super.onDestroy();
    if (quotesListener != null) {
        quotesListener.remove();
    }
}

把数据绑定到RecyclerView展示 #

最后一步就是把拿到的taskItemList绑定到RecyclerView上，这里给你一个简单的适配器示例：

1. 创建适配器类 #

public class TaskItemAdapter extends RecyclerView.Adapter<TaskItemAdapter.TaskViewHolder> {
    private List<TaskItem> mTaskItems;

    public TaskItemAdapter(List<TaskItem> taskItems) {
        mTaskItems = taskItems;
    }

    @NonNull
    @Override
    public TaskViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_task, parent, false);
        return new TaskViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull TaskViewHolder holder, int position) {
        TaskItem item = mTaskItems.get(position);
        holder.titleTv.setText(item.getTitle());
        holder.categoryTv.setText(item.getCategory());
    }

    @Override
    public int getItemCount() {
        return mTaskItems.size();
    }

    // 用于实时更新数据的方法
    public void updateData(List<TaskItem> newItems) {
        mTaskItems = newItems;
        notifyDataSetChanged();
    }

    static class TaskViewHolder extends RecyclerView.ViewHolder {
        TextView titleTv;
        TextView categoryTv;

        public TaskViewHolder(@NonNull View itemView) {
            super(itemView);
            titleTv = itemView.findViewById(R.id.tv_title);
            categoryTv = itemView.findViewById(R.id.tv_category);
        }
    }
}

2. 在Activity里初始化RecyclerView并更新数据 #

private RecyclerView mRecyclerView;
private TaskItemAdapter mAdapter;

private void initRecyclerView() {
    mRecyclerView = findViewById(R.id.recycler_view);
    mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
    mAdapter = new TaskItemAdapter(new ArrayList<>());
    mRecyclerView.setAdapter(mAdapter);
}

// 统一的列表更新方法
private void updateRecyclerView(List<TaskItem> taskItems) {
    mAdapter.updateData(taskItems);
}

这样一来，不管你用一次性获取还是实时监听，都能把Firestore里的数据流畅展示成列表啦～

内容的提问来源于stack exchange，提问作者Aks4125