JSON
JSON est une façon d'écrire une information structurée en texte simple : des valeurs nommées, des listes, des nombres et des mots, imbriqués aussi profondément qu'il le faut.
En détail
Il n'y a que quelques pièces. Une valeur a un nom et un contenu ; un contenu est un mot, un nombre, un oui ou un non, une liste de contenus, ou un autre jeu de valeurs nommées. Tout le reste se bâtit en imbriquant cela.
Parce que c'est du texte, cela se lit à l'œil, se garde dans un fichier, se met sous gestion de versions et se compare ligne à ligne. Parce que c'est simple, tout langage de programmation transforme ses propres données en cela, et l'inverse, en un appel.
Ce qu'il fait sur un vrai document
Le document entier y est décrit avant que rien ne soit dessiné : une liste de choses à dessiner, et à côté de cette liste les polices, les couleurs et les images que ces choses nomment.
L'écrire à la main est parfaitement possible pour un premier essai, et c'est ce que sont les exemples de ces pages. Dans un vrai programme, elle se construit comme n'importe quelle autre donnée, et se transforme en texte au dernier moment.
D'où il vient, et pourquoi
Cela vient de la façon dont un langage écrivait déjà ses propres données, et cela s'est répandu parce que c'était la plus petite chose qui faisait le travail. Sa description complète tient sur une page.
Ce qu'il a remplacé était plus lourd : une forme qui portait des balises autour de chaque valeur et exigeait un schéma à côté pour être lue. Les deux sont encore en usage, et une norme de facture demande souvent la plus lourde — c'est pourquoi un document fini peut la porter à l'intérieur alors que la requête qui l'a fait est écrite dans celle-ci.
Voyez-le sur un document fini
Les règles derrière ce mot, et les textes d'où elles sont tirées
Glossaire
- norme
- Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.
- police
- Le dessin de chaque lettre, de chaque chiffre et de chaque signe qu'un document écrit, rangé dans un fichier à part. Un PDF emporte à l'intérieur de lui-même les polices dans lesquelles il est composé : c'est pour cela qu'il s'ouvre à l'identique sur une machine qui ne les a jamais eues. Sans elles, un lecteur en met une autre à la place, et la mise en page bouge.
- PDF balisé
- Un PDF qui range son texte en plus de le dessiner : ceci est un titre, ceci un tableau, cette case appartient à cette colonne. C'est ce qui permet au logiciel qui lit à voix haute, ou au programme qui récupère les chiffres, de comprendre la page.
- requête
- Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.