Just Learn Code

Mastering JSON Data Interchange: Converting Creating and Reading in Java

Introduction to JSON

JSON, or JavaScript Object Notation, is a lightweight data format that is widely used for exchanging data across the web. This language-independent format is ideal for data interchange, and its popularity has surged in recent years due to the growth of web applications and APIs. JSON is designed to be easy to read and write, making it a popular alternative to XML.

In this article, we will learn about the characteristics of JSON and its conversion to string. We will also explore how to create JSON data from a string in Java.

The Characteristics of JSON

JSON is a self-describing format, which means that it includes information about the data it holds within itself. This characteristic makes it easy for computers to understand and interpret JSON data, thereby enabling fast and efficient communication between systems.

JSON is a lightweight format, meaning that it is easy to transmit over the network. It is also human-readable, making it easy for developers to understand and debug.

JSON is also language-independent, meaning that it can be used in any programming language, making it an incredibly versatile data format.

Converting JSON to String

JSON data can be converted to a string format using a variety of techniques. The simplest way to achieve this is by calling the toString() method on a JSON object or JSON array.

Another method involves using the CDL class to convert the JSON object into comma-separated values. The JSONTokener class can also be used to read JSON data and to create a new JSON object or array from a string, respectively.

You can also use the toJSONArray() method to convert a JSON object into a JSON array.

Creating JSON Data from String in Java

Now that we have a basic understanding of JSON and how to convert JSON data to a string, let’s explore how to create JSON data from a string in Java. To create JSON data from a string in Java, we will use the JSONObject and JSONArray classes available in the java.lang package.

Converting JSON Data to String

Before we can create JSON data from a string, we need to convert the JSON data into a string format. To achieve this, we can use the stringify() method provided by JavaScript Object Notation (JSON).

This will convert the JSON object or array into a string, respectively.

Example Code and Explanation

In this example, we will create a JSON data string in Java using the JSONObject and JSONArray classes. We will begin by creating a new JSONObject, which will contain the data to be converted into a JSON string.

We will then populate the JSONObject with data using the put() method. Finally, we will create a JSONArray and add the JSONObject to it using the put() method.

Here is the code:

JSONObject json = new JSONObject();

json.put(“name”, “John”);

json.put(“age”, 30);

json.put(“city”, “New York”);

JSONArray jsonArray = new JSONArray();


String jsonString = jsonArray.toString();

In this code, we create a new JSONObject and add three key-value pairs to it using the put() method. The key in each pair corresponds to the property name, while the value represents the property value.

We then create a new JSONArray object and add the JSONObject to it using the put() method. Finally, we convert the JSONArray object into a string format using the toString() method.


In conclusion, we have learned about JSON and its characteristics, including its self-describing, language-independent, and lightweight format. We have also explored how to convert JSON data to a string and how to create JSON data from a string in Java using the JSONObject and JSONArray classes.

By following the example code, you can easily create JSON data strings from within your Java code and pass them to other systems for easy data interchange. With its simplicity and versatility, JSON is an ideal data format for modern web applications and APIs.

Reading JSON File as a String

JSON file is typically used for storing and exchanging data between various systems. JSON files can be used for tracking inventories, customizing user experience, or simply for reading configuration elements.

Reading a JSON file from within a Java application can be achieved with the help of libraries such as Google’s Gson, or manually through Java APIs.

Extracting Content from a JSON File

The first step in reading a JSON file as a string is to extract its content. The simplest way to achieve this is by using a FileReader object to open the file location within the file system.

Once the file location is established, the content of the JSON file can be extracted using the FileInputStream object. Here is the code:


File jsonFile = new File(“location_of_file.json”);

String content = “”;

try {

content = new String(Files.readAllBytes(jsonFile.toPath()));

} catch (IOException e) {





In the code snippet above, we declare a file object with the location of the JSON file, read the contents of the file using the readAllBytes() method from the java.nio.file.Files package, and then convert the byte data into a string.

Finally, the extracted content of the JSON file is printed in the console as output. Another way to extract data from a JSON file is to use the Apache Commons IO library, which provides a simple method for reading file contents as strings:


File jsonFile = new File(“location_of_file.json”);

String content = “”;

try {

content = FileUtils.readFileToString(jsonFile, StandardCharsets.UTF_8);

} catch (IOException e) {





In this code, we use the FileUtils object, which is part of the Apache Commons IO library, to read the file contents.

The readFilString() method takes a file object and a character encoding as input, and returns the file contents as a string. The string is then printed to the console as output.

Note that this is only one approach to parse the JSON file. The libraries you use to read and parse JSON files will differ depending on the desired functionalities and the libraries you are already using in your application.

Note on Including .jar File

In software development, a Java Archive (.jar) is a packaged file format that aggregates bytecode and related metadata into a single archive file. This format is used to store and distribute Java libraries and components such as the Gson and Apache Commons IO that we’ve used in our code snippets.

Including a .jar file in your Java project is important since most libraries are distributed in .jar files and have dependencies to other libraries. When these dependencies are not resolved, it can cause errors, ultimately leading to application crashes.

The best practice is to include these .jar files within your Java project explicitly, either manually or through dependency management tools such as Maven or Gradle.

In manual inclusion, we add the .jar files preferences in the build path of the project.

This provides access to the functionalities of the library within the project environment. In Gradle, we specify the desired library as a dependency, and Gradle will handle downloading and including the library, along with any dependencies, into the project environment.

Maven operates in a similar way, where you define dependencies in the pom.xml file, and Maven will download and include the dependency artifacts in the project environment. In conclusion, inclusion of .jar files is crucial for using third-party libraries within your Java projects.

It is essential to include the correct libraries explicitly to ensure error-free project environment. While both manual inclusion and dependency management tools can be used to include .jar files in the project, the latter is recommended due to its automation of package management and version control.

Overall, this article has covered the basics of working with JSON in Java, including converting JSON data to and from string format, extracting content from JSON files, and best practices for including .jar files in Java projects. Understanding these concepts is essential for any developer working with JSON data, as it ensures error-free and efficient data interchange between systems.

Takeaways from this article include the importance of self-describing, language-independent, and lightweight format of JSON, the various ways to read and extract content from JSON files, and the significance of including .jar files to prevent errors. Developers who can implement these practices effectively will be better equipped to navigate the complexities of working with JSON data in their Java projects.

Popular Posts