Dart Hive TypeAdapter的write方法中writeByte使用逻辑与参数含义咨询
Hive TypeAdapter 写入方法中
writeByte(2)/writeByte(3)的设计原理 开头写入的第一个writeByte(n)的实际含义
这行代码的作用非常直白:记录当前类需要持久化存储的字段总数量。
你可以直接对照read方法的第一行实现看:var numOfFields = reader.readByte(); 这行代码读取的就是write方法最开头写入的这个整数值。
比如你示例中的Person类一共标注了2个带@HiveField的持久化字段,生成适配器时这里就会自动写入2;如果后续你给这个类新增了第三个带注解的持久化字段,重新生成适配器后,这里的数值就会变成3——这就是你在其他代码里看到writeByte(3)的全部原因,没有任何特殊的协议魔法,本质就是持久化字段的总数计数。
为什么每个字段前都要单独写字段ID,不做纯顺序匹配的写入
很多人刚接触适配器时会有疑问:既然读写逻辑是一一对应的,为什么不能按照字段书写的固定顺序直接依次写入、读取,非要在每个字段前面插一个字节标记字段ID?
这个设计完全是为了满足持久化场景下的版本兼容、存储压缩、容错能力,核心价值如下:
- 打破字段顺序的强依赖。如果是纯顺序匹配的逻辑,只要你后续调整了类里的字段书写顺序,或者增删了字段,老版本存储的二进制数据就会和新版本的读取逻辑错位,直接出现类型解析错误甚至崩溃。而通过每个字段前置ID的键值对存储模式,只要
@HiveField标注的ID不变,不管你代码里的字段顺序怎么调整,序列化和反序列化都不会出错。 - 支持存储体积压缩。如果某个对象的字段值是系统默认值,你完全可以在write阶段跳过这个字段的写入;read阶段读取时只要发现对应ID不存在,就给字段赋值默认值即可,不需要为没有实际价值的默认值占用存储空间。
- 提供版本迭代的容错能力。老版本存储的数据里如果带有已经被新版本废弃的字段,读取时直接把这个字段ID对应的内容忽略即可,不会因为读不认识的内容导致整个对象解析失败。
这里需要纠正一个常见的认知偏差:很多人觉得read方法是“按顺序依次读字段”,实际上它的逻辑从根上就不是纯顺序驱动的。你可以仔细拆解read的循环实现:
循环读取的次数就是开头拿到的字段总数量,每轮循环会先读一个字节作为字段ID,再读取这个ID对应的实际值,把所有键值对存在一个映射表里,最后才从映射表里按ID取出对应值,赋值给类的成员变量。只是通常生成的适配器会按照ID从小到大的顺序写入字段,才会让人误以为读写是纯顺序对应的关系。
常见的认知澄清
- 不要把
writeByte(3)当成什么特殊的协议标识,它仅仅代表当前类一共有3个持久化字段需要序列化而已。 - 你示例代码里read方法最后写的
return Trips()是代码生成模板的复制粘贴笔误,正常自动生成的适配器这里会返回Person()实例,不影响核心逻辑的理解。
内容的提问来源于stack exchange,提问作者Denio Mariz
相关产品推荐
相关产品推荐

