Go groot 同名对象的cycle怎样影响读取

在 Go groot 里，ROOT 目录中的同名对象可能同时保留多个 cycle。读取时，f.Get("hist") 不代表“第一个 hist”，而是会在同名 key 中选择最高 cycle；如果要复现历史版本，应明确写成 f.Get("hist;1")。这个差异正是“刚写入的数据为什么被读出来”的常见原因。

官方资料：https://pkg.go.dev/go-hep.org/x/hep@v0.40.0/groot

先把同名对象看成不同 cycle

ROOT 的 key 由名称、类型和 cycle 等信息共同定位。名称相同并不意味着文件里只有一份内容：同一目录可以留下 hist;1、hist;2 这样的历史 key。groot 的 Key 暴露了 Name()、ClassName() 和 Cycle()，因此第一步不是直接做类型断言，而是先把目录索引打印出来。

package main

import (
    "fmt"
    "log"

    "go-hep.org/x/hep/groot"
)

func main() {
    f, err := groot.Open("data.root")
    if err != nil {
        log.Fatal(err) // 打开失败时不要继续对空文件句柄读取
    }
    defer f.Close() // 读取结束后释放文件描述符

    for _, key := range f.Keys() {
        // 同名对象靠 cycle 区分，先观察再决定读取哪个版本
        fmt.Printf("name=%q class=%q cycle=%d title=%q\n",
            key.Name(), key.ClassName(), key.Cycle(), key.Title())
    }
}

如果输出中出现多个 name="hist"，就不要把它们当成重复噪声。它们可能对应不同写入时刻或不同内容版本；后续是否读最新值，应成为业务代码的明确选择。

区分默认读取与指定 cycle

Get 的参数可以是普通名称，也可以是 name;cycle。普通名称会在同名 key 中选最高 cycle；指定数字时只匹配该 cycle。也就是说，下面两次读取的对象可能完全不同：

// 默认读取同名对象中 cycle 最大的一份
latest, err := f.Get("hist")
if err != nil {
    log.Fatal(err) // 名称不存在或对象解码失败时停止处理
}

// 精确读取历史版本；这里不会自动跳到 cycle=2 或 cycle=3
old, err := f.Get("hist;1")
if err != nil {
    log.Fatal(err) // 指定 cycle 不存在时应单独处理
}

fmt.Printf("latest=%s old=%s\n", latest.Class(), old.Class())

处理写入后的 cycle 递增

写入端也会影响读取结果。对同一个目录调用 Put("hist", obj) 时，groot 会检查已有同名 key；如果类型相同，新 key 的 cycle 会在最大值上加一。于是原本的默认读取目标可能从 hist;2 变成 hist;3。

// obj 代表一个已经准备好的 ROOT 对象
if err := w.Put("hist", obj); err != nil {
    log.Fatal(err) // 同名但类型不兼容时不要静默覆盖
}

// 写入新版本后重新列出 key，确认默认读取目标是否变化
for _, key := range w.Keys() {
    if key.Name() == "hist" {
        fmt.Printf("hist cycle=%d\n", key.Cycle())
    }
}

这里有一个容易忽略的边界：同名但 class 不同并不是“再增加一个 cycle”这么简单，写入时会遇到类型冲突。需要保留不同类型的对象时，应改用不同名称；需要保留同一对象的历史版本时，才使用 cycle。

用检查清单固定读取边界

在实际服务或批处理程序中，可以把选择规则固定成三步：

1. 启动时用 Keys() 记录目标名称、class 和最高 cycle，发现异常数量先报警。
2. 业务只要“最新版本”就调用无后缀名称；回放或比对必须把 cycle 写入配置或任务参数。
3. 完成 Get 后再做类型断言，并在错误信息里带上完整的 name;cycle，避免只显示对象名。

这套做法的重点不是手动删除旧 cycle，而是把“默认取最新”和“固定取历史”分开。只要文件会被追加写入，就不要在测试里假设 cycle 永远为 1。

相关问题

为什么 Get("hist") 读到的不是最早写入的数据？

因为无 cycle 的读取会在同名 key 中选择最高 cycle。需要最早版本时，应先从 Keys() 确认它存在，再调用 Get("hist;1")。

只知道对象名称时，怎样判断有没有历史版本？

遍历 f.Keys()，按 Name() 过滤并收集 Cycle()。不要只调用一次 Get，否则看不到被默认选择之外的 key。

cycle 能否替代不同对象名称？

不能。cycle 适合表示同一名称和类型的写入版本；不同类型或不同业务含义应使用不同名称，并在读取处明确类型。