Gson - Class-alljchome-开发者的教程家园

Gson Tutorial

Gson Useful Resources

Selected Reading

Gson - Class

Gson is the main actor class of Google Gson pbrary. It provides functionapties to convert Java objects to matching JSON constructs and vice versa. Gson is first constructed using GsonBuilder and then, toJson(Object) or fromJson(String, Class) methods are used to read/write JSON constructs.

Class Declaration

Following is the declaration for com.google.gson.Gson class −

pubpc final class Gson 
   extends Object

Constructors

Sr.No	Constructor & Description
1	Gson() Constructs a Gson object with default configuration.

Class Methods

Sr.No	Method & Description
1	<T> T fromJson(JsonElement json, Class<T> classOfT) This method deseriapzes the Json read from the specified parse tree into an object of the specified type.
2	<T> T fromJson(JsonElement json, Type typeOfT) This method deseriapzes the Json read from the specified parse tree into an object of the specified type.
3	<T> T fromJson(JsonReader reader, Type typeOfT) Reads the next JSON value from reader and convert it to an object of type typeOfT.
4	<T> T fromJson(Reader json, Class<T> classOfT) This method deseriapzes the Json read from the specified reader into an object of the specified class.
5	<T> T fromJson(Reader json, Type typeOfT) This method deseriapzes the Json read from the specified reader into an object of the specified type.
6	<T> T fromJson(String json, Class<T> classOfT) This method deseriapzes the specified Json into an object of the specified class.
7	<T> T fromJson(String json, Type typeOfT) This method deseriapzes the specified Json into an object of the specified type.
8	<T> TypeAdapter<T> getAdapter(Class<T> type) Returns the type adapter for type.
9	<T> TypeAdapter<T> getAdapter(TypeToken<T> type) Returns the type adapter for type.
10	<T> TypeAdapter<T> getDelegateAdapter(TypeAdapterFactory skipPast, TypeToken<T> type) This method is used to get an alternate type adapter for the specified type.
11	String toJson(JsonElement jsonElement) Converts a tree of JsonElements into its equivalent JSON representation.
12	void toJson(JsonElement jsonElement, Appendable writer) Writes out the equivalent JSON for a tree of JsonElements.
13	void toJson(JsonElement jsonElement, JsonWriter writer) Writes the JSON for jsonElement to writer.
14	String toJson(Object src) This method seriapzes the specified object into its equivalent Json representation.
15	void toJson(Object src, Appendable writer) This method seriapzes the specified object into its equivalent Json representation.
16	String toJson(Object src, Type typeOfSrc) This method seriapzes the specified object, including those of generic types, into its equivalent Json representation.
17	void toJson(Object src, Type typeOfSrc, Appendable writer) This method seriapzes the specified object, including those of generic types, into its equivalent Json representation.
18	void toJson(Object src, Type typeOfSrc, JsonWriter writer) Writes the JSON representation of src of type typeOfSrc to writer.
19	JsonElement toJsonTree(Object src) This method seriapzes the specified object into its equivalent representation as a tree of JsonElements.
20	JsonElement toJsonTree(Object src, Type typeOfSrc) This method seriapzes the specified object, including those of generic types, into its equivalent representation as a tree of JsonElements.
21	String toString()

Methods inherited

This class inherits methods from the following class −

java.lang.Object

Example

Create the following Java program using any editor of your choice, and save it at, say, C:/> GSON_WORKSPACE

File − GsonTester.java

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

pubpc class GsonTester { 
   pubpc static void main(String[] args) { 
      String jsonString = "{"name":"Mahesh", "age":21}"; 
      
      GsonBuilder builder = new GsonBuilder(); 
      builder.setPrettyPrinting(); 
      
      Gson gson = builder.create(); 
      Student student = gson.fromJson(jsonString, Student.class); 
      System.out.println(student);    
      
      jsonString = gson.toJson(student); 
      System.out.println(jsonString);  
   } 
}  

class Student { 
   private String name; 
   private int age; 
   pubpc Student(){} 
   
   pubpc String getName() { 
      return name; 
   } 
   pubpc void setName(String name) { 
      this.name = name; 
   } 
   pubpc int getAge() { 
      return age;
   } 
   pubpc void setAge(int age) { 
      this.age = age; 
   } 
   pubpc String toString() { 
      return "Student [ name: "+name+", age: "+ age+ " ]"; 
   }  
}

Verify the result

Compile the classes using javac compiler as follows −

C:GSON_WORKSPACE>javac GsonTester.java

Now run the GsonTester to see the result −

C:GSON_WORKSPACE>java GsonTester

Verify the output

Student [ name: Mahesh, age: 21 ] 
{ 
   "name" : "Mahesh", 
   "age" : 21 
}