如何在Java中通过POJO序列化读写Firestore的Reference类型字段？

我来给你详细捋清楚怎么搞定这个事儿——用Java开发Firestore应用时，借助POJO的自动序列化来读写Reference类型字段其实挺省心的，我平时做项目经常这么用，踩过的坑也给你提个醒。

核心前提：认准Firestore的Reference对应类 #

Firestore里的文档引用（Reference类型），在Java SDK里对应的是com.google.cloud.firestore.DocumentReference类。咱们的POJO直接用这个类型定义字段就行，完全不用自己折腾字符串转来转去的操作。

第一步：定义符合要求的POJO #

你的实体类得满足Firestore序列化的基本要求，不然会报错：

• 必须有无参构造函数（不管是自己显式写的，还是用Lombok的@Data这类注解自动生成的都可以）
• 字段要有对应的getter/setter（同样Lombok能帮你省事儿）
• 直接用DocumentReference作为关联字段的类型

举个实际例子，比如我们有个User类，关联了一个Group文档：

import com.google.cloud.firestore.DocumentReference;
import com.google.cloud.firestore.annotation.PropertyName;
import lombok.Data;

@Data // Lombok自动生成getter、setter、无参构造函数
public class User {
    private String userId;
    private String username;
    
    // 如果Firestore文档里的字段名是"group_ref"，用@PropertyName做映射
    @PropertyName("group_ref")
    private DocumentReference groupRef;
}

第二步：写入Reference字段到Firestore #

当你要把POJO存入Firestore时，只需要给DocumentReference字段赋值，然后调用set()方法就行，Firestore会自动把它序列化成文档引用类型，而不是普通字符串。

代码示例：

// 先获取要关联的Group文档的Reference
DocumentReference groupRef = firestore.collection("groups").document("group_001");

// 创建User实例并赋值
User user = new User();
user.setUserId("user_001");
user.setUsername("JohnDoe");
user.setGroupRef(groupRef);

// 写入到Firestore
firestore.collection("users").document(user.getUserId())
        .set(user)
        .addOnSuccessListener(aVoid -> System.out.println("用户写入成功"))
        .addOnFailureListener(e -> System.err.println("写入失败：" + e));

第三步：读取Firestore里的Reference字段 #

读取的时候更简单，直接把文档转成POJO对象，Firestore会自动把文档里的Reference类型字段反序列化成DocumentReference实例，你直接用getter拿到就行，还能直接用这个Reference做后续操作（比如获取关联的Group文档）。

代码示例：

firestore.collection("users").document("user_001")
        .get()
        .addOnSuccessListener(documentSnapshot -> {
            if (documentSnapshot.exists()) {
                User user = documentSnapshot.toObject(User.class);
                if (user != null) {
                    // 拿到关联的Group Reference
                    DocumentReference groupRef = user.getGroupRef();
                    // 直接用这个Reference获取Group文档内容
                    groupRef.get().addOnSuccessListener(groupSnapshot -> {
                        Group group = groupSnapshot.toObject(Group.class);
                        System.out.println("关联的群组名称：" + group.getGroupName());
                    });
                }
            }
        })
        .addOnFailureListener(e -> System.err.println("读取失败：" + e));

几个容易踩的坑 #

• 无参构造函数不能少：Firestore的序列化器必须通过无参构造来创建POJO实例，要是没写，会直接抛出序列化异常，别大意。
• 字段名要对应：如果POJO字段名和Firestore文档里的字段名不一样，一定要用@PropertyName注解做映射，不然会找不到字段值。
• 别手动转字符串：千万不要把DocumentReference转成字符串存，那样读取的时候还要手动调用firestore.document(str)转回来，完全多此一举，用原生类型自动序列化香多了。

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