Introduction à JSON

Présentation de JSON

JSON est un format d’échange de données, les données étant spécifiées par des clés.

"clé1" : "valeur en chaîne de caractères"
 

Visualisation et validation d’un JSON

Par défaut, sous Firefox et sous Chrome, l’affichage d’un JSON seul a un rendu brut, le code étant interprété comme du texte.

Voici un code JSON simple et son rendu sous les deux navigateurs :

{ 
    "style" : null, 
    "artistes" : null, 
    "duree" : -1, 
    "titre" : null, 
    "album" : null 
}
 

Il n’y a pas de différence entre l’affichage d’un JSON et l’affichage d’un fichier texte.

1. Le plugin JsonView

Le plugin (extension) JsonView (http://jsonview.com/), disponible pour Firefox et pour Chrome, permet d’aborder le JSON comme un format structuré. Il met en exergue la syntaxe du JSON à l’aide de colorations et d’aides à la navigation (voir ou non une section dans son intégralité).

a. Coloration syntaxique

JsonView permet de colorer syntaxiquement le JSON, le rendant plus lisible. Les captures ci-après utilisent le code défini plus haut et affichent le rendu sous Firefox et Chrome.

b. Détection d’erreurs de syntaxe

Lorsque la syntaxe du JSON est incorrecte, JsonView permet de détecter l’erreur. 

Dans l’exemple ci-après, les guillemets ont volontairement été retirés autour de la clé...

JSON et JavaScript

La version 5.1 de la norme ECMAScript (http://www.ecma-international.org), votée en juin 2011, et intitulée ECMA-262, introduit l’usage de JSON, car la syntaxe d’écriture de JSON est proche de celle des objets ECMAScript.

Voici quelques rappels sur les usages de JavaScript, puis la présentation des méthodes disponibles en JavaScript relatives au JSON.

var TitreMusique = function(titre, duree) { 
    this.titre = titre; 
    this.duree = duree; 
    this.artistes = []; 
}; 
 
TitreMusique.prototype = { 
    style : null, 
    artistes : null, 
    duree : -1, 
    titre : null, 
    album : null, 
    ajouteArtiste : function(artist) { 
        this.artistes.push(artist); 
    } 
};
 

var monTitreMusique = new TitreMusique("MetalSymphonique1", 218); 
monTitreMusique.style = "Metal symphonique"; 
monTitreMusique.ajouteArtiste("Artiste1"); 
monTitreMusique.album = "SymphonicMetalAlbum1";
 

JSON et Java, production et consommation

Dans le chapitre Production de JSON avec Java et REST, nous traiterons des annotations permettant de sérialiser et désérialiser des POJO (Plain Old Java Object).

Il semble cependant nécessaire de mentionner des méthodes plus traditionnelles qui permettent de réaliser le même travail avec quelques lignes de code, rappelant les fonctions JavaScript JSON.parse et JSON.stringify.

Pour ce faire, deux objets Java sont créés, représentant un album musical et un titre d’album.

Ce sont des objets simples, avec des attributs, des getters et des setters, et une surcharge de la méthode toString().

public class AlbumMusical { 
 
    private String nom; 
    private List<TitreMusique> titres; 
    private Date date; 
 
    public AlbumMusical() { 
        this.titres = new ArrayList<TitreMusique>(); 
    } 
 
    public String getNom() { 
        return this.nom; 
    } 
 
    public void setNom(final String nom) { 
        this.nom = nom; 
    } 
 
    [...] 
}
 

public class TitreMusique { 
 
    private String titre; 
    private float duree; 
    private List<String> artistes; 
    private String style; 
    private AlbumMusical album; 
    private String valeurTransiente; 
 
    public TitreMusique() { 
        this.artistes = new ArrayList<String>(); 
    } 
 
    public TitreMusique(final String titre, final float duree) { 
        this(); 
        this.titre = titre; 
        this.duree = duree; 
    } 
 
    public String getTitre() { 
        return this.titre; 
    } 
 
    public void setTitre(final String titre) { 
        this.titre = titre; 
    } 
 
    [...] 
}
 

Pour les besoins des exemples ci-après...