JSON
Remonter à Utilisation de la RTL dans les applications multi-périphériques
JSON (EN) (JavaScript Object Notation) est un format léger d'échange de données indépendant du langage. JSON peut être utilisé comme une alternative aux autres formats d'échange de données tels que XML ou YAML.
RAD Studio fournit des frameworks JSON qui contiennent des classes et des méthodes pour stocker, analyser, lire, écrire et générer des données au format JSON.
Sommaire
Frameworks JSON
RAD Studio fournit différents frameworks pour la gestion des données JSON.
- Framework d'objets JSON : ce framework crée des objets temporaires pour les opérations de lecture et d'écriture relatives aux données JSON.
- Framework de lecteurs et d'éditeurs JSON : ce framework vous permet de lire et d'écrire des données JSON directement.
Framework d'objets JSON
Le framework d'objets JSON requiert de créer un objet temporaire pour analyser ou générer des données JSON. Pour lire ou écrire des données JSON, vous devez créer un objet mémoire intermédiaire tel que TJSONObject, TJSONArray ou TJSONString avant de lire et d'écrire les données JSON.
Pour de plus amples informations sur ce framework, voir Framework d'objets JSON.
Framework de lecteurs et d'éditeurs JSON
Le framework de lecteurs et d'éditeurs JSON vous permet de lire et d'écrire des données JSON directement dans un flux, sans créer d'objet temporaire. Dans la mesure où vous n'avez pas besoin de créer d'objet temporaire pour les opérations de lecture et d'écriture JSON, ce framework présente de meilleures performances et améliore l'utilisation de la mémoire.
A la différence du framework d'objets JSON, le framework de lecteurs et d'éditeurs JSON fournit une prise en charge du format BSON.
Pour de plus amples informations sur ce framework, voir Framework de lecteurs et d'éditeurs JSON.
Différences relatives au framework JSON
Vous pouvez utiliser l'un ou l'autre des deux frameworks lorsque vous travaillez avec des données JSON. Vous opterez pour l'un ou l'autre selon les besoins de votre projet. Le tableau ci-dessous présente les principales différences entre les deux frameworks JSON.
| Framework d'objets JSON |
|
|---|---|
| Framework de lecteurs et d'éditeurs JSON |
|
Le tableau ci-dessous comporte trois extraits de code qui illustrent les différences entre les frameworks pour les opérations d'écriture JSON.
| Framework d'objets JSON | Framework de lecteurs et d'éditeurs JSON : TJSonWriter | Framework de lecteurs et d'éditeurs JSON : TJSONObjectBuilder |
|---|---|---|
JSONColor := TJSONObject.Create;
JSONColor.AddPair('name', 'red');
JSONColor.AddPair('hex', '#f00');
JSONArray := TJSONArray.Create;
JSONArray.Add(JSONColor);
JSONObject := TJSONObject.Create;
JSONObject.AddPair('colors', JSONArray);
|
Writer.WriteStartObject;
Writer.WritePropertyName('colors');
Writer.WriteStartArray;
Writer.WriteStartObject;
Writer.WritePropertyName('name');
Writer.WriteValue('red');
Writer.WritePropertyName('hex');
Writer.WriteValue('#f00');
Writer.WriteEndObject;
Writer.WriteEndArray;
Writer.WriteEndObject;
|
Builder := TJSONObjectBuilder.Create(Writer);
Builder
.BeginObject
.BeginArray('colors')
.BeginObject
.Add('name', 'red')
.Add('hex', '#f00')
.EndObject
.EndArray
.EndObject;
|
Les trois extraits de code du tableau ci-dessus écrivent le code JSON suivant :
{
"colors":[
{
"name":"red",
"hex":"#f00"
}
]
}
Le tableau ci-dessous comporte trois extraits de code qui illustrent les différences entre les frameworks pour les opérations de lecture JSON.
| Framework d'objets JSON | Framework de lecteurs et d'éditeurs JSON : TJSonReader | Framework de lecteurs et d'éditeurs JSON : TJSONIterator |
|---|---|---|
JSONValue := TJSONObject.ParseJSONValue('{"colors":[{"name":"red", "hex":"#f00"}]}');
Memo1.Lines.Add('READER:');
if JSONValue is TJSONArray then
//...
else if JSONVAlue is TJSONObject then
Memo1.Lines.Add('colors');
Memo1.Lines.Add('name: '+ JSONValue.GetValue<string>('colors[0].name'));
Memo1.Lines.Add('hex: '+ JSONValue.GetValue<string>('colors[0].hex'));
|
LStringReader := TStringReader.Create('{"colors":[{"name":"red", "hex":"#f00"}]}');
LJsonTextReader := TJsonTextReader.Create(LStringReader);
while LJsonTextReader.read do
case LJsonTextReader.TokenType of
TJsonToken.PropertyName:
Memo1.Lines.Add(LJsonTextReader.Value.AsString);
TJsonToken.String:
Memo1.Lines[Memo1.Lines.Count-1] := Memo1.Lines[Memo1.Lines.Count-1] + ': ' +LJsonTextReader.Value.AsString;
end;
|
LStringReader := TStringReader.Create('{"colors":[{"name":"red", "hex":"#f00"}]}');
LJsonTextReader := TJsonTextReader.Create(LStringReader);
LIterator := TJSONIterator.Create(LJsonTextReader);
LIterator.Recurse;
LIterator.Next;
Memo1.Lines.Add(LIterator.Key);
LIterator.Recurse;
LIterator.Recurse;
LIterator.Next;
LIterator.Recurse;
LIterator.Next;
Memo1.Lines.Add(LIterator.Key +': '+ LIterator.AsString);
LIterator.Next;
Memo1.Lines.Add(LIterator.Key +': '+ LIterator.AsString);
|
Les trois extraits de code du tableau ci-dessus ajoutent ce qui suit à un TMemo.
colors name: red hex: #f00
Améliorations relatives à l'analyse et au traitement JSON dans 10.3
- L'exactitude du code JSON a été améliorée en ce qui concerne le code JSON généré par la classe TJSONValue et ses classes dérivées mais aussi en termes d'analyse. Des améliorations de performances sont également à noter.
- Nouvelle classe TAsciiStreamWriter : cette classe peut être associée à un TJsonTextWriter pour une génération de chaînes JSON plus performante (peu de conversions).
- Une sortie JSON "pretty print" grâce à l'introduction de TJSONAncestor.Format(Indentation: Integer = 4). En conséquence, TJSON.Format est désormais obsolète.
- TJSONAncestor.ToJSON génère maintenant une chaîne JSON valide alors que TJSONAncestor.ToString produit une chaîne JSON similaire, mais sans convertir les symboles non ASCII en \uNNNN.
- La prise en charge de l'analyse JSON présente un nouveau comportement en cas d'erreurs dans le texte source JSON. Une nouvelle option, TJSONObject.TJSONParseOption.RaiseExc, détermine si la méthode ParseJSONValue déclenche une exception de type EJSONParseException dans le cas d'un code JSON non valide ou renvoie nil (comme c'était le cas auparavant). Si l'exception est activée, TJSONObject.ParseJSONValue renvoie maintenant une position avec une erreur, déclenchant une nouvelle exception System.JSON.EJSONParseException (ayant les propriétés Path, Offset, Line et Position). De même, la méthode TJSONObject.ParseJSONValue contient un troisième nouveau paramètre : RaiseExc, qui remplace le paramètre global provoquant l'exception à déclencher, en cas d'erreurs d'analyse JSON.
Rubriques sur JSON
- Frameworks JSON :