使用@Parcelize注解处理含RealmList属性的Realm对象问题

这个场景我之前开发时也遇到过，确实Kotlin的@Parcelize注解默认不支持Realm的RealmList这种自定义集合类型，不过有几种实用的解决思路，我给你详细说说：

方法一：自定义TypeParceler（最推荐） #

@Parcelize允许我们为特定类型指定自定义的序列化逻辑，核心是写一个Parceler来处理RealmList的读写，然后通过@TypeParceler注解绑定到属性上。

步骤1：实现RealmList的Parceler #

// 泛型Parceler，支持所有实现Parcelable的RealmModel子类
class RealmListParceler<T : Parcelable> : Parceler<RealmList<T>> {
    override fun create(parcel: Parcel): RealmList<T> {
        val listSize = parcel.readInt()
        val realmList = RealmList<T>()
        repeat(listSize) {
            // 读取每个Parcelable元素并添加到RealmList
            realmList.add(parcel.readParcelable(T::class.java.classLoader)!!)
        }
        return realmList
    }

    override fun RealmList<T>.write(parcel: Parcel, flags: Int) {
        // 先写入集合大小，再逐个写入元素
        parcel.writeInt(this.size)
        this.forEach { parcel.writeParcelable(it, flags) }
    }
}

步骤2：在Realm对象中绑定Parceler #

修改你的Garage类，给cars属性加上@TypeParceler注解，指定我们刚才写的Parceler：

@Parcelize
@RealmClass
open class Garage(
    var name: String? = null,
    // 绑定RealmList对应的Parceler
    @TypeParceler<RealmList<Car>, RealmListParceler<Car>>
    var cars: RealmList<Car> = RealmList()
) : Parcelable, RealmModel

⚠️ 注意：Car类必须也实现Parcelable（比如用@Parcelize注解），否则无法序列化其中的元素。

方法二：用普通List做过渡（简单但有局限） #

如果不想写自定义Parceler，可以通过一个普通List作为中间层，利用@Parcelize支持标准List的特性，在getter/setter中完成与RealmList的转换：

@Parcelize
@RealmClass
open class Garage(
    var name: String? = null
) : Parcelable, RealmModel {
    // 私有RealmList存储实际数据
    private var _cars: RealmList<Car> = RealmList()

    // 对外暴露普通List，@Parcelize会自动序列化这个属性
    var cars: List<Car>
        get() = _cars.toList()
        set(newList) {
            _cars.clear()
            _cars.addAll(newList)
        }
}

这种方式的局限是：每次获取cars都会生成新的List实例，而且如果Garage是托管的Realm对象（即从数据库查询出来的实例），修改cars时必须在Realm事务中操作，否则会抛出线程异常。

额外注意事项 #

• 确保所有嵌套的RealmModel（比如Car）都实现了Parcelable，否则无论哪种方法都无法完成序列化。
• 如果序列化的是托管的Realm对象，建议先调用copyFromRealm()生成非托管副本，再进行Parcel操作，避免线程安全问题。

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