Roam API

roam.Value("score").Int()           // int
roam.Value("score").IntOr(0)        // int，不存在时返回默认值
roam.Value("score").Int64()         // int64
roam.Value("score").Int64Or(0)      // int64，不存在时返回默认值
roam.Value("name").String()         // string
roam.Value("name").StringOr("N/A")  // string，带默认值
roam.Value("rate").Float64()        // float64
roam.Value("rate").Float64Or(0.0)   // float64，不存在时返回默认值
roam.Value("active").Bool()         // bool
roam.Value("active").BoolOr(false)  // bool，不存在时返回默认值
roam.Value("key").Exists()          // 是否存在
roam.Value("key").Raw()             // 原始 any 值

// 深层访问
roam.ValueDeep("user.profile.level").Int()
roam.ValueDeep("user.profile.level").IntOr(1)

// 绑定到指针
var level int
roam.Value("level").To(&level)

cloneRoam

浅拷贝 Roam：复制业务数据并创建新的 IceMeta process 缓冲区。主要用于并行 handler 执行时的数据隔离。

完整方法列表

Java (IceRoam)

方法	说明
`put(key, value)`	写入值。value 为 null 时移除 key
`get(key)`	读取值，返回 Object
`putValue(key, value)`	写入值（泛型免强转）
`getValue(key)`	读取值（泛型免强转）
`putDeep(multiKey, value)`	按 `.` 分隔写入嵌套结构
`getDeep(multiKey)`	按 `.` 分隔读取嵌套值
`resolve(union)`	引用语法：`@` 前缀从 roam 取值
`getIceId()`	获取执行 ID
`getIceScene()`	获取场景
`getIceTs()`	获取时间戳
`cloneRoam()`	浅拷贝 Roam（并行执行时使用）

Go (Roam)

方法	说明
`Put(key, value)`	写入值
`Get(key)`	读取值，返回 any
`PutDeep(multiKey, value)`	嵌套写入
`GetDeep(multiKey)`	嵌套读取
`Resolve(union)`	引用语法
`Data()`	返回数据副本（排除 _ice）
`String()`	JSON 格式输出
`Value(key)`	返回 RoamValue，支持链式类型转换
`ValueDeep(multiKey)`	深层访问，返回 RoamValue
`GetMeta()`	获取 IceMeta 元数据
`Clone()`	浅拷贝 Roam（并行执行时使用）

Python (Roam)

方法	说明
`put(key, value)`	写入值
`get(key, default=None)`	读取值
`put_deep(key, value)`	嵌套写入
`get_deep(key, default=None)`	嵌套读取
`resolve(union)`	引用语法
`contains(key)`	是否包含 key
`remove(key)`	移除 key
`keys()`	所有 key
`to_dict()`	转为 dict
`get_meta()`	获取 IceMeta 元数据
`clone()`	浅拷贝 Roam（并行执行时使用）