Deserializing JSON to Java Records

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

In the world of Java programming, JSON (JavaScript Object Notation) is a widely used format for data interchange. It's common to receive JSON data from a web service or API and then deserialize it into Java objects. With the introduction of Java records in Java 16, the process of deserializing JSON data has become more streamlined and efficient. In this blog post, we'll explore how to deserialize JSON into Java records, a feature that greatly simplifies data handling in Java applications. 

Introduction to Java Records 

Java Records, introduced in Java 16, is a special type of data class in the Java language. They provide a concise and straightforward way to declare classes that are primarily used to hold immutable data. 

Records automatically generate boilerplate code like constructors, getters, equals(), hashCode(), and toString() methods based on the fields declared. A record is defined with the record keyword, followed by a list of fields. This feature simplifies the creation of data transfer objects and value-based classes, promoting cleaner and more readable code.

Example of a Java Record:

public record User(Long id, String firstName, String lastName, String email) {}

Advantages of Using Java Records for JSON Deserialization 

Immutable Data: Records ensure immutability, which is a good practice for data transfer objects. 

Less Boilerplate: They reduce the boilerplate code required for defining POJOs (Plain Old Java Objects). A record can declare fields, and the compiler automatically generates the corresponding constructor, getters, toString(), equals(), and hashCode() methods.

Data Integrity: Since records are immutable, they provide a higher level of data integrity.

Setting Up the Environment 

To deserialize JSON into a Java record, you'll need a JSON processing library. Jackson is a popular choice for its ease of use and flexibility. 

Maven Dependency for Jackson 

Add the following dependencies to your pom.xml:

<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.16.1</version>
</dependency>

Deserializing JSON to Java Record 

Now, let's write a simple Java program to deserialize a JSON string into a User record. 

package net.javaguides.quizapp.automation;

import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.IOException;

record User(Long id, String firstName, String lastName, String email) {}

public class JsonToRecord {
    public static void main(String[] args) {
        String json = """
                      {
                          "id": 1,
                          "firstName": "Ramesh",
                          "lastName": "Fadatare",
                          "email": "ramesh@example.com"
                      }
                      """;

        ObjectMapper mapper = new ObjectMapper();
        try {
            User user = mapper.readValue(json, User.class);
            System.out.println("Deserialized User Record: " + user);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Output:

Deserialized User Record: User[id=1, firstName=Ramesh, lastName=Fadatare, email=ramesh@example.com]

Java Records for Complex Structures 

Let's consider an example where we have a JSON structure representing a User and their associated Address. The User record will have a reference to the Address record. 

Defining the Records 

First, define the Address record:

public record Address(String street, String city, String zipCode, String country) {}

Next, define the User record, which includes an Address:

public record User(Long id, String firstName, String lastName, String email, Address address) {}

Deserializing Nested JSON 

Assume we have the following JSON:

{
    "id": 1,
    "firstName": "Ramesh",
    "lastName": "Fadatare",
    "email": "ramesh@example.com",
    "address": {
        "street": "Main street",
        "city": "Pune",
        "zipCode": "12345",
        "country": "India"
    }
}

The Deserialization Process 

Here’s how you can deserialize the above JSON into Java records: 

package net.javaguides.quizapp.automation;

import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.IOException;

record Address(String street, String city, String zipCode, String country) {}

record User(Long id, String firstName, String lastName, String email, Address address) {}
public class ComplexJsonToRecord {
    public static void main(String[] args) {
        String json = """
                        {
                             "id": 1,
                             "firstName": "Ramesh",
                             "lastName": "Fadatare",
                             "email": "ramesh@example.com",
                             "address": {
                                 "street": "Main street",
                                 "city": "Pune",
                                 "zipCode": "12345",
                                 "country": "India"
                             }
                         }
                      """;

        ObjectMapper mapper = new ObjectMapper();
        try {
            User user = mapper.readValue(json, User.class);
            System.out.println("Deserialized User Record: " + user);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

Output:

Deserialized User Record: User[id=1, firstName=Ramesh, lastName=Fadatare, email=ramesh@example.com, address=Address[street=Main street, city=Pune, zipCode=12345, country=India]]

Conclusion 

Java records, combined with a library like Jackson, make the task of deserializing JSON into Java objects much more straightforward and cleaner. This approach is particularly useful when dealing with data transfer objects in APIs and web services. Records bring the benefits of immutability, less boilerplate, and data integrity, making them an excellent choice for modern Java applications. 

Stay tuned for more insights on leveraging new features in Java for efficient and effective programming. 

Happy coding!

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF