Firestore技术问题：获取对象数组及查询Map数组字段的正确方式

嘿，我来帮你搞定这两个Firestore的问题，都是开发中经常遇到的场景，咱们一步步来～

这里分两种常见场景，看你是要拿自定义实体对象数组还是原生Map数组：

场景1：获取自定义对象数组 #

假设你有一个自定义的Product类，Firestore文档里有个products字段是这个类的数组。你可以在获取文档后，把字段值转成List<Product>：

// 获取指定文档
db.collection("stores").document("store_01")
    .get()
    .addOnSuccessListener(documentSnapshot -> {
        if (documentSnapshot.exists()) {
            // 方式1：用Firebase POJO自动转换（需给Product加无参构造器）
            List<Product> productList = documentSnapshot.toObject(Store.class).getProducts();
            
            // 方式2：手动转换为自定义对象
            List<Map<String, Object>> rawList = (List<Map<String, Object>>) documentSnapshot.get("products");
            List<Product> productList = new ArrayList<>();
            for (Map<String, Object> productMap : rawList) {
                Product product = new Product(
                    (String) productMap.get("name"),
                    (Double) productMap.get("price")
                );
                productList.add(product);
            }
        }
    });

注：用POJO自动转换时，要确保Product类的字段名和Firestore文档里的键完全对应，并且有无参构造器哦～

场景2：获取原生Map数组 #

如果不需要转自定义对象，直接拿ArrayList<Map>的话更简单：

db.collection("stores").document("store_01")
    .get()
    .addOnSuccessListener(documentSnapshot -> {
        if (documentSnapshot.exists()) {
            // 直接强转为ArrayList<Map>
            ArrayList<Map<String, Object>> mapList = (ArrayList<Map<String, Object>>) documentSnapshot.get("products");
            // 遍历列表处理业务逻辑
            for (Map<String, Object> item : mapList) {
                String name = (String) item.get("name");
                double price = (Double) item.get("price");
                // 你的业务代码
            }
        }
    });

这个要看你的查询需求，分两种情况判断：

情况1：Firestore原生支持的查询（无需客户端循环） #

Firestore本身支持对数组字段的查询，针对Map数组，你可以用以下方式：

• 匹配整个Map对象：用array-contains，比如要找products数组中包含某个特定Map的文档：

  Map<String, Object> targetProduct = new HashMap<>();
  targetProduct.put("name", "Apple");
  targetProduct.put("price", 5.99);
  
  db.collection("stores")
      .whereArrayContains("products", targetProduct)
      .get()
      .addOnSuccessListener(querySnapshot -> {
          // 处理符合条件的文档
      });
  

• 匹配Map中的某个键值对：如果只需要匹配数组中存在某个Map包含指定键值（比如价格大于10），可以用字段路径查询：

  db.collection("stores")
      .whereGreaterThan("products.price", 10.0)
      .get()
      .addOnSuccessListener(querySnapshot -> {
          // 返回所有products数组中至少有一个Map的price>10的文档
      });
  

情况2：需要客户端自定义逻辑处理（必须获取后循环） #

如果你的查询需求比较复杂（比如同时满足多个Map字段条件、或者需要过滤数组中的元素而不是整个文档），那就要先把整个数组拿到客户端，转成ArrayList<Map>后再循环处理：

// 先获取目标文档
db.collection("stores").document("store_01")
    .get()
    .addOnSuccessListener(documentSnapshot -> {
        if (documentSnapshot.exists()) {
            ArrayList<Map<String, Object>> productMaps = (ArrayList<Map<String, Object>>) documentSnapshot.get("products");
            ArrayList<Map<String, Object>> filteredList = new ArrayList<>();

            // 自定义过滤逻辑：比如筛选价格大于10且名称包含"fruit"的Map
            for (Map<String, Object> map : productMaps) {
                double price = (Double) map.get("price");
                String name = (String) map.get("name");
                if (price > 10.0 && name.contains("fruit")) {
                    filteredList.add(map);
                }
            }

            // filteredList就是你要的最终结果
        }
    });

总结一下：如果Firestore原生查询能满足你的需求，优先用原生查询（性能更好，减少客户端计算）；如果是复杂逻辑，再获取数组后循环处理。

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