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.
Let's first see how to convert Java object into it's JSON representation with an example.
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:
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
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