JSON Tutorial: Introduction and A Complete Guide for Beginners

An Introduction to JSON: A Comprehensive Tutorial Series for Newcomers

JavaScript Object Notion, commonly known as JSON, is one of the most popular formats for data transmission. It is a lightweight and text-based data format. JSON was initially developed by Douglas Crockford.

Being text-based, JSON is easy to read and write for users, and its lightweight nature makes it an efficient option for machines to process. Although JSON is based on JavaScript, it can be used independently of any specific programming language, as most languages can easily handle JSON data.

Its properties, such as being text-based, lightweight, and independent of programming languages, make it an ideal choice for data interchange operations.

---

List of JSON Tutorials in this series:

Tutorial #1: Introduction to JSON (This Tutorial)
Tutorial #2: Creating JSON Objects Using C#
Tutorial #3: Creating JSON Structure Using C#
Tutorial #4: Using JSON for Interface Testing
Tutorial #5: JSON Interview Questions

---

This tutorial provides a complete overview of JSON, covering its objects, properties, usage, and arrays, with examples for better understanding.

Usage of JSON

JSON is primarily used for data transfer between systems. It can transmit data between computers, databases, and programs.

• It is commonly used for sending serialized data over network connections.
• JSON can be used with all major programming languages.
• It is useful for data transition from web applications to servers.
• Most web services utilize JSON for data transfers.

Properties of JSON

Key properties of JSON:

• JSON is a lightweight text-based data interchange format.
• It is an extension of the JavaScript language.
• JSON files have the extension .json.
• Being text-based, it is readable and writable for both users/programmers and machines.
• JSON is independent of programming languages, but it adopts conventions from C-family languages like C, C++, C#, JavaScript, Java, Python, Perl, etc.

So far, we have discussed the properties and usage of JSON. Let’s now explore the JSON structure, starting with JSON Objects.

Syntax of JSON

By this point, you should have a basic understanding of JSON. Now let’s take a look at the basic syntax used in JSON.

JSON consists of two main structural entities: collections of name-value pairs and ordered lists of values.

JSON is a universal data structure supported by most programming languages today, making it easier for programmers to work with interchangeable data types across different languages.

Let’s learn more about these data types:

• A collection of name-value pairs is represented as an object, struct, record, or dictionary.
• An ordered list of values is represented as an array or list.

We have covered the basic concepts so far. Now let’s explore the basic JSON structure. In this Example, we will consider a JSON representing car details.

Let’s assume we have a car object with the following properties and attributes:

Make and Model = Maruti Suzuki Swift
Make Year = 2017
Color = Red
Type = Hatchback

If we want to transfer this data using a JSON file, the serialization of this data will create a JSON.

The JSON representation will look something like this:

We have covered the usage of JSON, its basic structure, and the representation of data in JSON format. Now let’s explore the structure of JSON in more detail.

What is a JSON Object?

A JSON object is a set of key-value pairs without any specific order.

The key-value pairs are grouped using curly braces, represented by opening and closing “{ }”. Therefore, when creating a JSON with a car attribute, we create a JSON Car Object. There are certain rules to follow when creating a JSON structure, which we will discuss when talking about key-value pairs.

To create a JSON object, we need to define an attribute. Let’s create an “Employee” JSON object. We can then specify the properties of the object, such as “First Name,” “Last Name,” “Employee ID,” and “Designation.” These properties are represented as “keys” in the JSON structure.

Let’s create a JSON object:

Everything within the curly braces represents the JSON Employee Object.

A basic JSON object consists of key-value pairs. In the previous Example, we used a JSON to represent employee data.

We represented different properties of the employee, such as “First Name,” “Last Name,” “Employee ID,” and “Designation.” Each of these “keys” has a corresponding value in the JSON. For example, “First Name” is represented by the value “Sam.” Similarly, other keys are represented by different values.

Here are some generic rules to follow when creating a JSON:

• JSON objects should start and end with curly braces “{ }”.
• Key fields should be enclosed in double quotes.
• Values should be separated from the keys using a colon “:”.
• JSON key-value pairs should be separated by a comma “,”.
• Values can be of any data type, such as strings, integers, or booleans.

Now, here’s a small exercise for you:

Try creating a sample JSON describing an “Employee” with your own set of keys and values.

By now, you should have a basic understanding of what JSON is, its usage, and how it looks. Now, let’s dive deeper into more complex JSON structures.

JSON Arrays

Arrays in JSON are similar to arrays in other programming languages. They are ordered collections of data. Arrays in JSON are enclosed in square brackets “[” and “]”. Values inside the array are separated by commas. There are some rules to follow when using arrays in a JSON structure.

Let’s look at an example JSON with an array. We will use the same Employee object as before and add another property called “Language Expertise.” An employee can have expertise in multiple programming languages, so we can use an array to record multiple language expertise values more effectively.

As mentioned earlier, there are rules to follow when including an array in a JSON.

Here are the rules:

• An array in JSON starts with a left square bracket and ends with a right square bracket.
• Values inside the array are separated by commas.

Objects, key-value pairs, and arrays combine to form different components of a JSON. They can be used together to record any data in a JSON.

Now let’s consider a scenario where there are multiple employees, and each employee has a car. In order to create a complete record, we need to include the car JSON within the Employee JSON. This means creating a nested Car JSON object inside the Employee JSON.

To include the car in the Employee JSON, we initially need to add a key called “car” in the JSON.

It would look like this:

Once we have added the “car” key in the employee JSON, we can then assign a value to it using the Car JSON.

{
"FirstName": "Sam",
"LastName": "Jackson",
"EmployeeID": 5698523,
"Designation": "Manager",
"LanguageExpertise": ["Java", "C#", "Python"],

"Car": 
{
"Make&Model": "Maruti Suzuki Swift",
"MakeYear": 2017,
"Color": "Red",
"Type": "Hatchback",
}
}

This way, we can create nested JSON structures.

Now, let’s assume a situation where there are multiple employees, so we need to create a JSON structure that can hold data for several employees.

{
"FirstName": "Sam",
"LastName": "Jackson",
"EmployeeID": 5698523,
"Designation": "Manager",
"LanguageExpertise": ["Java", "C#", "Python"],
"Car": {
"Make&Model": "Maruti Suzuki Swift",
"MakeYear": 2017,
"Color": "Red",
"Type": "Hatchback"
}

},
{
"FirstName": "Tam",
"LastName": "Richard",
"EmployeeID": 896586,
"Designation": "Senior Manager",
"LanguageExpertise": ["Ruby", "C#"],
"Car": {
"Make&Model": "Hyundai Verna",
"MakeYear": 2015,
"Color": "Black",
"Type": "Sedan"
}
}

In the above example, you can see that we included data for two employees. Remember to enclose all JSON structures in square brackets “[ ]”. Use commas to separate different sets of data in a JSON, whether they are key-value pairs or JSON objects.

As we conclude this tutorial, here’s a small exercise for you all:

Create a JSON representing a company with different key-value pairs.

Follow these steps:

#1) Open a text editor.

#2) Create a JSON structure representing a company with various key-value pairs.

#3) Add data for at least two companies.

#4) Include an array field in the JSON.

#5) Use a nested JSON structure.

#6) Use a JSON validator to validate your JSON structure.

#7) Paste your JSON structure into the validator, and click on validate to ensure its validity.

Make sure you follow the provided guidelines and rules when creating a JSON structure.

Next Tutorial #2: Creating JSON Objects Using C# (Part 1)

Conclusion

JSON is a popular format for data transmission. It is commonly used for data exchange between different networks. The text-based structure of JSON allows easy interpretation by both users and machines.

Although JSON is often associated with JavaScript, it can be read and modified by any programming language. JSON files have the .json extension and can be created using any programming language.

We can create simple JSON structures by assigning key-value pairs directly or using arrays to assign multiple values to a key. JSON can also have nested structures, allowing for the transmission of more complex data.

If you have any queries or need further clarification, please let us know.