Aller au contenu
jsonW Article GitHub

Écriture et historique

Écriture en direct et publication atomique

Le fichier .jsw ne fait qu'ajouter : un processus peut lire pendant qu'un autre écrit, sans voir de bloc à moitié écrit. Dans les SDK, le fichier n'apparaît, complet, qu'au fechar().

· jsonW 1.3.11

Le problème

Un lecteur qui ouvre un fichier pendant qu'un autre programme l'écrit peut tomber sur une ligne coupée. Et un programme qui s'arrête en pleine écriture peut laisser un fichier à moitié écrit à la place du bon.

Comment jsonW le résout

Chaque bloc du .jsw tient tout seul, avec un marqueur, un CRC32C et un hash. C'est pourquoi le format permet de lire en flux pendant qu'un autre processus écrit, comme un tail -f qui ne voit jamais un bloc à moitié écrit. À l'écriture par les SDK, le fichier n'est publié qu'au fechar() ; en cas d'erreur, appelez abandonar() et la destination reste telle qu'elle était.

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();

Écriture avec le SDK Node (npm @wortictecnologia/jsonw). Le fichier eventos.jsw n'existe, complet, qu'au fechar().

Où la trouver

La publication atomique est dans les 10 SDK. La lecture pendant l'écriture existe dans le noyau, mais dans la version 1.3.11 elle n'a ni commande dans wjsw ni fonction dans l'ABI publique.

Lire la section complète dans l'article →