如何将Firestore嵌套Map数据映射到FirestoreRecyclerAdapter实体类

核心问题分析 #

你的Firestore文档结构是顶层字段为ServiceOrder的Map，而Java中的ServiceOrder类对应的是这个Map内部的业务结构。直接用setQuery(query, ServiceOrder.class)会让Firestore尝试把整个文档（而非ServiceOrder字段下的内容）映射到ServiceOrder对象，导致所有字段匹配失败、值为空，最终触发空指针异常（NPE）。

正确实现步骤 #

1. 创建文档映射类 #

先定义一个对应Firestore完整文档结构的类，用来承接顶层的ServiceOrder字段：

public class ServiceOrderDocument {
    @PropertyName("ServiceOrder")
    private ServiceOrder serviceOrder;

    // Firestore映射必须的无参构造函数
    public ServiceOrderDocument() {}

    public ServiceOrder getServiceOrder() {
        return serviceOrder;
    }

    public void setServiceOrder(ServiceOrder serviceOrder) {
        this.serviceOrder = serviceOrder;
    }
}

2. 修改适配器泛型与绑定逻辑 #

将FirestoreRecyclerAdapter的泛型改为ServiceOrderDocument，在绑定视图时从文档类中取出实际的业务对象：

public class FirestoreAdapter extends FirestoreRecyclerAdapter<ServiceOrderDocument, FirestoreAdapter.ViewHolder> {

    public FirestoreAdapter(@NonNull FirestoreRecyclerOptions<ServiceOrderDocument> options) {
        super(options);
    }

    @Override
    protected void onBindViewHolder(@NonNull ViewHolder holder, int position, @NonNull ServiceOrderDocument model) {
        // 取出实际的ServiceOrder业务对象
        ServiceOrder serviceOrder = model.getServiceOrder();
        
        // 正常调用Getter方法绑定数据
        holder.osIdItem.setText(String.valueOf(serviceOrder.getId()));
        holder.osClientItem.setText(serviceOrder.getClient().getName()); // 假设Client类有getName()方法
        holder.osDateItem.setText(serviceOrder.getDate());
        holder.osValueItem.setText(String.valueOf(serviceOrder.getTotalValue()));
    }

    // ViewHolder实现（示例）
    public static class ViewHolder extends RecyclerView.ViewHolder {
        TextView osIdItem, osClientItem, osDateItem, osValueItem;

        public ViewHolder(@NonNull View itemView) {
            super(itemView);
            osIdItem = itemView.findViewById(R.id.os_id_item);
            osClientItem = itemView.findViewById(R.id.os_client_item);
            osDateItem = itemView.findViewById(R.id.os_date_item);
            osValueItem = itemView.findViewById(R.id.os_value_item);
        }
    }
}

3. 初始化RecyclerView与适配器 #

调整setupRecyclerView代码，适配新的文档映射类，同时修正排序字段的路径：

private void setupRecyclerView() {
    RecyclerView recyclerView = findViewById(R.id.recyclerViewOs);

    // 排序字段要使用Firestore支持的嵌套路径格式
    Query query = osRef.orderBy("ServiceOrder.id", Query.Direction.ASCENDING);

    FirestoreRecyclerOptions<ServiceOrderDocument> options =
            new FirestoreRecyclerOptions.Builder<ServiceOrderDocument>()
                    .setQuery(query, ServiceOrderDocument.class)
                    .build();

    listAdapter = new FirestoreAdapter(options);

    recyclerView.setHasFixedSize(true);
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    recyclerView.setAdapter(listAdapter);
}

4. 修复生命周期方法 #

添加非空判断，避免空指针异常：

@Override
protected void onStart() {
    super.onStart();
    if (listAdapter != null) {
        listAdapter.startListening();
    }
}

@Override
protected void onStop() {
    super.onStop();
    if (listAdapter != null) {
        listAdapter.stopListening();
    }
}

关键注意事项 #

• ServiceOrder类中的Client、Vehicle成员变量需为public，或提供标准Getter/Setter方法，Firestore才能正确映射嵌套对象。
• 所有实体类（ServiceOrder、Client、Vehicle）必须保留无参构造函数，这是Firestore对象映射的强制要求。
• Firestore排序/过滤嵌套字段时，需用父字段.子字段的路径格式，比如ServiceOrder.id。

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