Skip to content

pkgs/store/kv

pkgs/store/kv 定义 GizClaw 的通用 ordered key-value abstraction。Key 使用 string segments 表达层级路径,Store 提供 get、set、delete、prefix list 和有序遍历能力。

Go API References

核心结构与实现

符号作用
Key / Entry表达分段 key 与读取结果。
Store定义 CRUD、prefix listing 和 iterator contract。
Options配置 key separator 等 store 行为。
Memory / NewMemory进程内 ordered store。
Badger / NewBadgerBadger-backed persistent implementation。
Prefixed为已有 Store 增加固定 key namespace。
ListAfter在 prefix 下从指定 key 之后分页读取。

Ownership 边界

kv 只定义 byte payload 与层级 key 语义,不解释 payload 的领域类型。序列化、resource validation、secondary index 和跨记录一致性由使用它的领域 service 负责。调用方应使用稳定 prefix 隔离数据,不能依赖其他领域的内部 key layout。