Android端如何使用Firestore文档多字段进行数据查询

嘿，我帮你把这个Firestore查询的代码补全并梳理清楚，结合你给出的集合结构，下面是完整的实现方案：

首先先明确你的Firestore数据结构：

集合(Products) → 文档(自动生成ID) → 字段(NumberOfPeople、OfferStartDate、OfferEndDate、OfferPrice、Location)

1. 初始化Firestore实例 #

首先确保你已经在项目中配置好Firebase，并且初始化Firestore实例：

FirebaseFirestore db = FirebaseFirestore.getInstance();

2. 完整查询代码实现 #

假设你需要查询指定地点、满足最低价格，并且处于活动有效期内的产品，补全后的代码如下：

// 获取Products集合的引用
CollectionReference collectionOfProducts = db.collection("Products");

// 构建多条件查询
Query productQuery = collectionOfProducts
        .whereEqualTo("Location", location) // 传入你要筛选的地点参数
        .whereGreaterThanOrEqualTo("OfferPrice", targetMinPrice) // 传入最低价格阈值
        .whereLessThanOrEqualTo("OfferStartDate", new Date()) // 筛选已开始的活动
        .whereGreaterThanOrEqualTo("OfferEndDate", new Date()); // 筛选未结束的活动

// 执行查询并处理结果
productQuery.get().addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        List<Product> productList = new ArrayList<>();
        for (QueryDocumentSnapshot document : task.getResult()) {
            // 将Firestore文档数据映射到自定义的Product实体类
            Product product = document.toObject(Product.class);
            // 把文档ID也存入实体类，方便后续的更新/删除操作
            product.setId(document.getId());
            productList.add(product);
        }
        // 这里可以调用方法更新UI，展示查询到的产品列表
        updateProductDisplay(productList);
    } else {
        // 处理查询失败的情况
        Log.e("FirestoreQuery", "查询产品数据失败", task.getException());
        Toast.makeText(getApplicationContext(), "查询失败，请稍后重试", Toast.LENGTH_SHORT).show();
    }
});

3. 定义Product实体类 #

你需要创建一个和Firestore字段对应的实体类，Firestore会自动把文档数据映射到这个类的对象中：

public class Product {
    private String id; // 存储文档的自动生成ID，可选但推荐
    private Integer NumberOfPeople;
    private Date OfferStartDate;
    private Date OfferEndDate;
    private Double OfferPrice;
    private String Location;

    // 必须要有无参构造函数，Firestore需要用它来实例化对象
    public Product() {}

    // Getter和Setter方法
    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public Integer getNumberOfPeople() {
        return NumberOfPeople;
    }

    public void setNumberOfPeople(Integer numberOfPeople) {
        NumberOfPeople = numberOfPeople;
    }

    public Date getOfferStartDate() {
        return OfferStartDate;
    }

    public void setOfferStartDate(Date offerStartDate) {
        OfferStartDate = offerStartDate;
    }

    public Date getOfferEndDate() {
        return OfferEndDate;
    }

    public void setOfferEndDate(Date offerEndDate) {
        OfferEndDate = offerEndDate;
    }

    public Double getOfferPrice() {
        return OfferPrice;
    }

    public void setOfferPrice(Double offerPrice) {
        OfferPrice = offerPrice;
    }

    public String getLocation() {
        return Location;
    }

    public void setLocation(String location) {
        Location = location;
    }
}

4. 关键注意事项 #

• 字段名一致性：Firestore区分大小写，实体类的变量名要和Firestore文档中的字段名完全一致；如果需要不同名称，可以用@PropertyName("字段名")注解来映射。
• 日期类型处理：如果Firestore中存储的是Timestamp类型，实体类用Date类型可以自动完成转换，无需额外处理。
• 实时监听数据：如果需要实时获取数据更新，可以把get()换成addSnapshotListener()，这样数据变化时会自动触发回调。
• 依赖检查：确保你的build.gradle中添加了Firestore的依赖，版本建议使用官方最新版：

  implementation 'com.google.firebase:firebase-firestore:24.10.0' // 版本号以官方最新为准
  

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