JSON (JavaScript Object Notation) is a language-independent lightweight data-interchange format. JSON can be used as an alternative to other data-interchange formats such as XML or YAML. RAD Studio provides JSON frameworks that contain classes and methods to store, parse, read, write, and generate data in JSON format. Sooner or later you will find it necessary to understand what JSON is and how to use it since it’s an extremely common format, especially for things like REST servers.
In this post, you’ll learn what JSON is, How we can test a JSON script? How we can use JSON with C++ Builder? Can we generate and parse JSON in C++ Builder? By learning more about JSON, it will help you build C++ applications with the use of C++ software.
Table of Contents
JSON Frameworks
RAD Studio provides different frameworks to handle JSON data.
- JSON Objects Framework: This framework creates temporary objects to read and write JSON data.
- Readers and Writers JSON Framework: This framework allows you to read and write JSON data directly.
JSON Example
For example you have animals in a Zoo and you want to hold data in JSON form. In our small zoo, let’s have two Penguins from different origins
- First one is from Magascar at the age of 4
- Second one is from Antarctica at the age of 5
In JSON form this data can be written in animals category with their properties as below,
|
1 2 3 |
{"animals":[{"title":"Penguin","origin":"Madagascar","age":"4"},{"title":"Penguin","origin":"Antarctica","age":"5"}]} |
You can test this JSON with a JSON Parser Online , here below is from http://json.parser.online.fr/
JSON Generator Example in C++ Builder
In C++ Builder, we can create this JSON form by using TJSONObject and TJSONArray. We can add properties of animals by the AddPair() method and we can use AddElement() method to add these animals with their features. Let’s do this in a new C++ Builder Project.
- Create a new C++ Builder Multi-Device application, save all project and unit files to a folder.
- Add a TMemo and two TButtons with text “Generate” and “Parse”
- To use JSON methods, we need to include System.JSON .hpp, with #include <System.JSON.hpp> as below,
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
//--------------------------------------------------------------------------- #include <fmx.h> #include <System.JSON.hpp> #pragma hdrstop #include "JSON_Example_Unit1.h" //--------------------------------------------------------------------------- #pragma package(smart_init) #pragma resource "*.fmx" TForm1 *Form1; //--------------------------------------------------------------------------- __fastcall TForm1::TForm1(TComponent* Owner) : TForm(Owner) { } |
4. To create this JSON form, first we should create a jobject with TJSONObject and jarray with TJSONArray then we can create elements with TJSONObject to define each animal properties. We can add these elements to our array by using AddElement() method. Here is a simplified code below,
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
TJSONObject *jobject = new TJSONObject(); TJSONArray *jarray = new TJSONArray(); jobject->AddPair("animals", jarray); TJSONObject *jelement = new TJSONObject(); // add pairs to this element // ... // Add all elements of this animal to the array jarray->AddElement(jelement); // add pairs to this element // ... // Add all elements of this animal to the array jarray->AddElement(jelement); // .. // Finally use jobject here // free jobject only which jarray and jelements etc. jobject->Free(); |
After using JSON object we should free this, all it’s elements will be free too. To make safe data addition, we can use __try and__finally. Here is a simple example to show how we can add all elements safely as below.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
void __fastcall TForm1::Button1Click(TObject *Sender) { // Let's create a new object TJSONObject *jobject = new TJSONObject(); __try { // Let's create a new array TJSONArray *jarray = new TJSONArray(); jobject->AddPair("animals", jarray); // Let's create a new object element for the first penguin TJSONObject *jelement = new TJSONObject(); // Let's add some info in JSON Pair form jelement->AddPair( new TJSONPair("title", "Penguin") ); jelement->AddPair( new TJSONPair("origin", "Madagascar") ); jelement->AddPair( new TJSONPair("age", "4") ); // Let's add this firt penguin element to animals array jarray->AddElement(jelement); // Let's create another object element for the other penguin jelement = new TJSONObject(); // Let's add some info in JSON Pair form jelement->AddPair( new TJSONPair("title", "Penguin") ); jelement->AddPair( new TJSONPair("origin", "Antarctica") ); jelement->AddPair( new TJSONPair("age", "5") ); // Let's add this second penguin element to animals array jarray->AddElement(jelement); } __finally { // Let's output Memo1->Lines->Add( jobject->ToString() ); jobject->Free(); } } |
If we run this example with a C++ Builder VCL or FMX application, we will have same JSON result.
|
1 2 3 |
{"animals":[{"title":"Penguin","origin":"Madagascar","age":"4"},{"title":"Penguin","origin":"Antarctica","age":"5"}]} |
JSON Parser Example in C++ Builder
We can parse each objects and elements of arrays as given example below. Let’s get this JSON output above from the Memo component and parse.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
void __fastcall TForm1::Button2Click(TObject *Sender) { TJSONObject *jobject = (TJSONObject*) TJSONObject::ParseJSONValue(Memo1->Lines->Text, 0); __try { TJSONArray *jarray = (TJSONArray*) jobject->Get("animals")->JsonValue; Memo1->Lines->Add(""); Memo1->Lines->Add("Parsing:"); for (int a = 0; a < jarray->Size(); a++) { TJSONObject *jelement = (TJSONObject*) jarray->Get(a); for (int e = 0; e < jelement->Count; e++) { Memo1->Lines->Add( jelement->Pairs[e]->JsonString->ToString() + " is" + jelement->Pairs[e]->JsonValue->ToString() ); } } } __finally { Memo1->Lines->Add("done."); jobject->Free(); } } |
Here is the example output,
You can check Official DockWiki http://docwiki.embarcadero.com/ for more details and latest news about JSON format. Also don’t forget to check JSON.org for more details about JSON format. If you still have questions JSON in C++ Builder and Delphi is well explained here ChapmanWorld with examples.
