How to Read a JSON File in Java Using the Simple JSON Lib


By squashlabs, Last Updated: November 2, 2023

How to Read a JSON File in Java Using the Simple JSON Lib

Reading a JSON file in Java is a common task when working with JSON data. In this guide, we will explore how to read a JSON file in Java using the Simple JSON library. Simple JSON is a lightweight Java library for parsing and manipulating JSON data. It provides a simple and straightforward API for reading and writing JSON data.

Step 1: Add Simple JSON Dependency

Before we can start reading a JSON file, we need to add the Simple JSON library as a dependency in our Java project. Here’s an example of how to add the Simple JSON dependency using Maven:


Step 2: Import Required Classes

To read a JSON file using Simple JSON, we need to import the required classes from the library. Here are the classes we need to import:

import org.json.simple.JSONArray;
import org.json.simple.JSONObject;
import org.json.simple.parser.JSONParser;
import org.json.simple.parser.ParseException;

Step 3: Read JSON File

Once we have added the Simple JSON dependency and imported the required classes, we can proceed to read the JSON file. Here’s an example of how to read a JSON file using Simple JSON:

try {
    // Create a JSONParser object
    JSONParser parser = new JSONParser();

    // Parse the JSON file
    Object obj = parser.parse(new FileReader("path/to/json/file.json"));

    // Convert the parsed object to a JSONObject
    JSONObject jsonObject = (JSONObject) obj;

    // Access the JSON data
    String name = (String) jsonObject.get("name");
    int age = (int) jsonObject.get("age");

    // Process the JSON data
    System.out.println("Name: " + name);
    System.out.println("Age: " + age);

    // Access nested <a href="">JSON objects</a> or arrays
    JSONArray hobbies = (JSONArray) jsonObject.get("hobbies");
    for (Object hobby : hobbies) {
        System.out.println("Hobby: " + hobby);
} catch (FileNotFoundException e) {
} catch (IOException e) {
} catch (ParseException e) {

In the above code snippet, we first create a JSONParser object to parse the JSON file. We then use the parse() method of the JSONParser class to parse the JSON file and convert it into a generic Object.

Next, we cast the parsed object to a JSONObject so that we can access the JSON data. We can then use the get() method of the JSONObject class to retrieve specific values from the JSON file.

In the example code, we access the “name” and “age” fields from the JSON file. We also demonstrate how to access nested JSON objects or arrays by accessing the “hobbies” field, which is an array in this case.

A better way to build and deploy Web Apps

  Cloud Dev Environments
  Test/QA enviroments

One-click preview environments for each branch of code.

Step 4: Handle Exceptions

When reading a JSON file, it is important to handle exceptions properly. In the example code above, we catch three types of exceptions: FileNotFoundException, IOException, and ParseException.

FileNotFoundException is thrown when the specified JSON file is not found. IOException is thrown when there is an error reading the JSON file. ParseException is thrown when there is an error parsing the JSON data.

It is a good practice to handle these exceptions gracefully by logging or displaying appropriate error messages.

Step 5: Best Practices

Here are some best practices to keep in mind when reading a JSON file in Java using the Simple JSON library:

1. Always close the file reader after reading the JSON file to release system resources. You can use a finally block to ensure the file reader is closed even if an exception occurs.

2. Validate the JSON data before accessing specific fields to avoid potential ClassCastException or NullPointerException. You can use the containsKey() method of the JSONObject class to check if a specific field exists in the JSON object.

3. Use appropriate data types to store the JSON values. Simple JSON provides methods like getAsString(), getAsInt(), getAsBoolean(), etc., to retrieve specific field values in the desired data type.

4. Handle large JSON files efficiently by using streaming parsers instead of loading the entire JSON file into memory. Simple JSON provides a JSONParser constructor that accepts a Reader object, allowing you to use a BufferedReader for efficient reading.

Step 6: Alternative Libraries

While Simple JSON is a popular choice for reading JSON files in Java, there are also other libraries available that provide similar functionalities. Some alternative libraries for reading JSON files in Java include:

– Gson: A useful library developed by Google that provides both reading and writing capabilities for JSON data. Gson offers a rich set of features and is widely used in Java projects.
– Jackson: Another popular JSON library that provides high-performance JSON processing capabilities. Jackson offers a variety of features and supports both streaming and tree models.
– JSON-B: A standard JSON binding library introduced in Java EE 8. JSON-B provides a set of annotations and APIs for mapping Java objects to JSON and vice versa.

When choosing a JSON library for your Java project, consider factors such as ease of use, performance, community support, and compatibility with your project requirements.

More Articles from the How to Write Java Code: From Basics to Advanced Concepts series: