Gson – How to convert Java object to / from JSON

In this tutorial, we will show you how to use the GSON library to convert Java object to/from JSON.

Gson is a Java library that can be used to convert Java Objects into their JSON representation. It can also be used to convert a JSON string to an equivalent Java object.

GSON Maven Dependency

To use Gson with Maven2/3, you can use the Gson version available in Maven Central by adding the following dependency:

<dependencies>
    <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.8.5</version>
      <scope>compile</scope>
    </dependency>
</dependencies>

GSON Video Tutorial

This video tutorial is explained in below YouTube video:

Let's first see how to convert Java object into it's JSON representation with an example.

Convert Java Object to JSON using GSON

package net.javaguides.gson;

import java.util.HashSet;
import java.util.Set;

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;

/**
 * 
 * @author Ramesh Fadatare
 *
 */
public class GSONComplexObjectExample {
    public static void main(String[] args) {
        serializeStudentObject();
    }

    private static void serializeStudentObject() {
        Gson gson = new GsonBuilder().setPrettyPrinting().create();
        Student student = createStudent();
        String jsonStr = gson.toJson(student);
        System.out.println(jsonStr);
    }

    private static Student createStudent() {
        Student student = new Student();
        student.setStudentId(1000);
        student.setStudentName("Ramesh");
        Set < Phone > phones = new HashSet < Phone > ();
        Phone phone = new Phone();
        phone.setPhoneId(100);
        phone.setPhoneNumber("1234567890");
        phone.setPhoneType("Mobile Phone");
        phones.add(phone);

        Phone phone1 = new Phone();
        phone1.setPhoneId(101);
        phone1.setPhoneNumber("2222 3333 44");
        phone1.setPhoneType("Landline Phone");
        phones.add(phone1);

        student.setStudentPhoneNumbers(phones);
        return student;
    }
}

class Student {

    private long studentId;
    private String studentName;
    private Set < Phone > studentPhoneNumbers = new HashSet < Phone > (0);

    public long getStudentId() {
        return studentId;
    }

    public void setStudentId(long studentId) {
        this.studentId = studentId;
    }

    public String getStudentName() {
        return studentName;
    }

    public void setStudentName(String studentName) {
        this.studentName = studentName;
    }

    public Set < Phone > getStudentPhoneNumbers() {
        return studentPhoneNumbers;
    }

    public void setStudentPhoneNumbers(Set < Phone > studentPhoneNumbers) {
        this.studentPhoneNumbers = studentPhoneNumbers;
    }

    @Override
    public String toString() {
        return "Student [studentId=" + studentId + ", studentName=" + studentName + ", studentPhoneNumbers=" +
            studentPhoneNumbers + "]";
    }

}

class Phone {

    private long phoneId;
    private String phoneType;
    private String phoneNumber;

    public Phone() {}

    public Phone(String phoneType, String phoneNumber) {
        this.phoneType = phoneType;
        this.phoneNumber = phoneNumber;
    }

    public long getPhoneId() {
        return phoneId;
    }

    public void setPhoneId(long phoneId) {
        this.phoneId = phoneId;
    }

    public String getPhoneType() {
        return phoneType;
    }

    public void setPhoneType(String phoneType) {
        this.phoneType = phoneType;
    }

    public String getPhoneNumber() {
        return phoneNumber;
    }

    public void setPhoneNumber(String phoneNumber) {
        this.phoneNumber = phoneNumber;
    }
}

Output:

{
  "studentId": 1000,
  "studentName": "Ramesh",
  "studentPhoneNumbers": [
    {
      "phoneId": 100,
      "phoneType": "Mobile Phone",
      "phoneNumber": "1234567890"
    },
    {
      "phoneId": 101,
      "phoneType": "Landline Phone",
      "phoneNumber": "2222 3333 44"
    }
  ]
}

Deserialize or Convert JSON to Java Object using GSON

package net.javaguides.gson;

import java.util.HashSet;
import java.util.Set;

import com.google.gson.Gson;

/**
 * 
 * @author Ramesh Fadatare
 *
 */
public class GSONComplexObjectExample {
    public static void main(String[] args) {
        deserializeUserObject();
    }

    private static void deserializeUserObject() {
        Gson gson = new Gson();
        String jsonStr = "{\r\n" +
            "  \"studentId\": 1000,\r\n" +
            "  \"studentName\": \"Ramesh\",\r\n" +
            "  \"studentPhoneNumbers\": [\r\n" +
            "    {\r\n" +
            "      \"phoneId\": 100,\r\n" +
            "      \"phoneType\": \"Mobile Phone\",\r\n" +
            "      \"phoneNumber\": \"1234567890\"\r\n" +
            "    },\r\n" +
            "    {\r\n" +
            "      \"phoneId\": 101,\r\n" +
            "      \"phoneType\": \"Landline Phone\",\r\n" +
            "      \"phoneNumber\": \"2222 3333 44\"\r\n" +
            "    }\r\n" +
            "  ]\r\n" +
            "}";
        Student student = gson.fromJson(jsonStr, Student.class);
        System.out.println(student.toString());
    }
}

class Student {

    private long studentId;
    private String studentName;
    private Set < Phone > studentPhoneNumbers = new HashSet < Phone > (0);

    public long getStudentId() {
        return studentId;
    }

    public void setStudentId(long studentId) {
        this.studentId = studentId;
    }

    public String getStudentName() {
        return studentName;
    }

    public void setStudentName(String studentName) {
        this.studentName = studentName;
    }

    public Set < Phone > getStudentPhoneNumbers() {
        return studentPhoneNumbers;
    }

    public void setStudentPhoneNumbers(Set < Phone > studentPhoneNumbers) {
        this.studentPhoneNumbers = studentPhoneNumbers;
    }

    @Override
    public String toString() {
        return "Student [studentId=" + studentId + ", studentName=" + studentName + ", studentPhoneNumbers=" +
            studentPhoneNumbers + "]";
    }

}

class Phone {

    private long phoneId;
    private String phoneType;
    private String phoneNumber;

    public Phone() {}

    public Phone(String phoneType, String phoneNumber) {
        this.phoneType = phoneType;
        this.phoneNumber = phoneNumber;
    }

    public long getPhoneId() {
        return phoneId;
    }

    public void setPhoneId(long phoneId) {
        this.phoneId = phoneId;
    }

    public String getPhoneType() {
        return phoneType;
    }

    public void setPhoneType(String phoneType) {
        this.phoneType = phoneType;
    }

    public String getPhoneNumber() {
        return phoneNumber;
    }

    public void setPhoneNumber(String phoneNumber) {
        this.phoneNumber = phoneNumber;
    }
}

Output:

Student [studentId=1000, studentName=Ramesh, studentPhoneNumbers=[net.javaguides.gson.Phone@5ce65a89, net.javaguides.gson.Phone@25f38edc]]

GitHub Repository

The source code of this tutorial hosted on my GitHub repository at https://github.com/RameshMF/gson-tutorial.

Reference

• https://www.javaguides.net/p/google-gson-tutorial.html
• GSON User Guide
• GSON Java DOC

Free Spring Boot Tutorial | Full In-depth Course | Learn Spring Boot in 10 Hours

---

Watch this course on YouTube at Spring Boot Tutorial | Fee 10 Hours Full Course