Android平台下使用Java基于Firestore文档ID集合查询对应商品文档的实现方法

嘿，我完全懂你现在的困扰——你已经把收藏的商品文档ID存在SharedPreferences的String集合里，但不知道怎么一次性从Firestore把这些对应的文档都捞出来对吧？别担心，这其实有个很直接的解决方案，而且我会把两种情况都给你讲清楚：收藏列表元素≤10个，以及超过10个的场景（因为Firestore有查询限制）。

基础场景：收藏列表≤10个元素 #

Firestore提供了whereIn方法，可以配合FieldPath.documentId()来查询文档ID在指定列表中的文档。直接看代码：

import com.google.firebase.firestore.FieldPath;
import com.google.firebase.firestore.FirebaseFirestore;
import com.google.firebase.firestore.QueryDocumentSnapshot;
import com.google.firebase.firestore.QuerySnapshot;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import android.content.SharedPreferences;

// 获取SharedPreferences中的收藏ID集合
SharedPreferences sharedFile = favorite.this.getSharedPreferences("appShared", favorite.this.MODE_PRIVATE);
Set<String> favList = sharedFile.getStringSet("fav_products", new HashSet<String>());

// 把Set转换为List，因为whereIn需要Iterable类型参数
List<String> favIdList = new ArrayList<>(favList);

FirebaseFirestore firestore = FirebaseFirestore.getInstance();

// 构建查询：匹配文档ID在favIdList中的商品
firestore.collection("products")
        .whereIn(FieldPath.documentId(), favIdList)
        .get()
        .addOnSuccessListener(querySnapshot -> {
            // 遍历查询到的所有文档
            for (QueryDocumentSnapshot doc : querySnapshot) {
                // 这里可以把文档转换成你的商品模型类，比如：
                // Product product = doc.toObject(Product.class);
                Log.d("FAV_PRODUCTS", "找到收藏商品：ID=" + doc.getId() + "，数据=" + doc.getData());
            }
        })
        .addOnFailureListener(e -> {
            // 处理查询失败的情况
            Log.e("FAV_PRODUCTS", "查询收藏商品出错", e);
        });

进阶场景：收藏列表超过10个元素 #

这里要注意Firestore的一个限制：whereIn最多支持10个元素的查询条件。如果你的收藏列表可能超过这个数，就得把列表拆分成多个不超过10个元素的子列表，分批查询后再合并结果。

下面是完整的实现代码：

import com.google.firebase.firestore.FieldPath;
import com.google.firebase.firestore.FirebaseFirestore;
import com.google.firebase.firestore.QueryDocumentSnapshot;
import com.google.firebase.firestore.QuerySnapshot;
import com.google.android.gms.tasks.Tasks;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import android.content.SharedPreferences;

// 首先获取收藏ID集合
SharedPreferences sharedFile = favorite.this.getSharedPreferences("appShared", favorite.this.MODE_PRIVATE);
Set<String> favList = sharedFile.getStringSet("fav_products", new HashSet<String>());
List<String> favIdList = new ArrayList<>(favList);

FirebaseFirestore firestore = FirebaseFirestore.getInstance();

// 拆分列表为多个不超过10个元素的子列表
List<List<String>> splitFavLists = splitList(favIdList, 10);

// 存储所有查询任务
List<Task<QuerySnapshot>> queryTasks = new ArrayList<>();

// 为每个子列表创建查询任务
for (List<String> idChunk : splitFavLists) {
    Task<QuerySnapshot> task = firestore.collection("products")
            .whereIn(FieldPath.documentId(), idChunk)
            .get();
    queryTasks.add(task);
}

// 等待所有查询完成，合并结果
Tasks.whenAllSuccess(queryTasks)
        .addOnSuccessListener(results -> {
            List<QueryDocumentSnapshot> allFavProducts = new ArrayList<>();
            // 遍历每个查询的结果，合并到总列表中
            for (Object result : results) {
                QuerySnapshot snapshot = (QuerySnapshot) result;
                allFavProducts.addAll(snapshot.getDocuments());
            }
            // 处理合并后的所有收藏商品
            for (QueryDocumentSnapshot doc : allFavProducts) {
                Log.d("FAV_PRODUCTS", "找到收藏商品：ID=" + doc.getId() + "，数据=" + doc.getData());
            }
        })
        .addOnFailureListener(e -> {
            Log.e("FAV_PRODUCTS", "批量查询收藏商品出错", e);
        });

// 拆分列表的工具方法
private List<List<String>> splitList(List<String> originalList, int chunkSize) {
    List<List<String>> chunks = new ArrayList<>();
    for (int i = 0; i < originalList.size(); i += chunkSize) {
        int endIndex = Math.min(i + chunkSize, originalList.size());
        chunks.add(originalList.subList(i, endIndex));
    }
    return chunks;
}

额外注意事项 #

• 确保favList中的ID和Firestore里的商品文档ID完全匹配，否则对应的文档不会出现在查询结果中。
• 如果你已经定义了商品模型类（比如Product），直接用doc.toObject(Product.class)就能把文档数据转换成对象，比手动提取字段更高效。
• 检查Firestore的安全规则，确保当前用户有权限读取这些商品文档，否则查询会失败。

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