写入与历史
实时写入与原子发布
.jsw 文件只追加:一个进程写入时,另一个进程可以同时读取,而不会读到半个块。在 SDK 中,文件只在 fechar() 时完整出现。
· jsonW 1.3.11
问题
在另一个程序写文件时去读它,可能读到被截断的一行。程序在写到一半时崩溃,还可能留下一个写了一半的文件,覆盖原本完好的那个。
jsonW 的做法
.jsw 的每个块都能独立存在,带有标记、CRC32C 和哈希。因此格式允许在另一个进程写入时以流的方式读取,就像一个永远不会看到半个块的 tail -f。通过 SDK 写入时,文件只在 fechar() 时发布;出错退出时调用 abandonar(),目标文件保持原样。
const { Escritor } = require("@wortictecnologia/jsonw");
const e = new Escritor("eventos.jsw", "id:i64,tipo:dic,quando:tempo");
e.gravar({ id: 1, tipo: "entrada", quando: "2026-11-13T09:00:00Z" });
e.fechar();
使用 Node SDK(npm @wortictecnologia/jsonw)写入。eventos.jsw 文件只在 fechar() 时才完整出现。
在哪里
10 个 SDK 都支持原子发布。写入过程中的读取存在于核心中,但在 1.3.11 版本里,它在 wjsw 中没有命令,在公开 ABI 中也没有函数。