Vai al contenuto
jsonW Articolo GitHub

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.

Leggi la sezione completa nell'articolo →