Scrittura e storico
Scrittura dal vivo e pubblicazione atomica
Il file .jsw si scrive solo in coda: un processo può leggere mentre un altro scrive, senza vedere mezzo blocco. Negli SDK il file compare, completo, solo con fechar().
· jsonW 1.3.11
Il problema
Chi legge un file mentre un altro programma lo scrive può trovare una riga tagliata. E un programma che si blocca a metà scrittura può lasciare un file a metà al posto di quello buono.
Come lo risolve jsonW
Ogni blocco del .jsw sta in piedi da solo, con marcatore, CRC32C e hash. Per questo il formato permette di leggere in flusso mentre un altro processo scrive, come un tail -f che non vede mai mezzo blocco. Scrivendo con gli SDK, il file viene pubblicato solo con fechar(); chi esce per errore chiama abandonar() e la destinazione resta com'era.
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();
Scrittura con l'SDK di Node (npm @wortictecnologia/jsonw). Il file eventos.jsw comincia a esistere, completo, solo con fechar().
Dove si trova
La pubblicazione atomica è in tutti i 10 SDK. La lettura durante la scrittura esiste nel nucleo, ma nella versione 1.3.11 non ha un comando in wjsw né una funzione nell'ABI pubblica.