Java的JSON轉換類庫GSON的基本應用教程。本站提示廣大學習愛好者:(Java的JSON轉換類庫GSON的基本應用教程)文章只能為提供參考,不一定能成為您想要的結果。以下是Java的JSON轉換類庫GSON的基本應用教程正文
Gson (GitHub:https://github.com/谷歌/gson)是 Google 供給的用來在 Java 對象和 JSON 數據之間停止映照的 Java 類庫。可以將一個 JSON 字符串轉成一個 Java 對象,或許反過去。
Gson裡最主要的對象有2個Gson 和 GsonBuilder。
Gson有2個最根本的辦法
(1)toJson() – 轉換java 對象到JSON
(2)fromJson() – 轉換JSON到java對象
編寫實體類:
public class People { String name; int age; boolean setName; public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } public boolean getSetName() { return setName; } public void setSetName(boolean setName) { this.setName = setName; } @Override public String toString() { return "name=" + name + " age=" + age + " setName=" +setName; } }
編寫測試類GsonTest
import com.谷歌.gson.ExclusionStrategy; import com.谷歌.gson.FieldAttributes; import com.谷歌.gson.Gson; import com.谷歌.gson.GsonBuilder; /** * Convert java object to json. */ public class GsonTest { public static void main(String[] args) { People p = new People(); p.setAge(20); p.setName("People"); p.setSetName(true); Gson gson = new Gson(); System.out.println(gson.toJson(p)); } }
輸入成果:
{"name":"People","age":20,"setName":true}
這只是最簡略的Gson的應用。假如我們須要將bool類型的屬性setName在轉換成json的時刻不轉換,怎樣完成呢?
在Gson的包中找半天,發明com.谷歌.gson包上面有這麼一個接口:ExclusionStrategy ,固然不清晰是干甚麼的,然則依據名字,可以揣摸,這個接口是用來設置Gson轉換的消除戰略的,因而在官網http://谷歌-gson.谷歌code.com/svn/trunk/gson/docs/javadocs/index.html查了一下這個接口,發明只需完成這個接口,並將完成類的對象塞給Gson,在轉換成json的時刻,Gson就會過濾失落指定的類或許屬性。因而有了上面的代碼:
import com.谷歌.gson.ExclusionStrategy; import com.谷歌.gson.FieldAttributes; import com.谷歌.gson.Gson; import com.谷歌.gson.GsonBuilder; /** * Convert java object to json, skip specific fileds. */ public class GsonTest { public static void main(String[] args) { People p = new People(); p.setAge(20); p.setName("People"); p.setSetName(true); ExclusionStrategy excludeStrategy = new SetterExclusionStrategy(); Gson gson1 = new GsonBuilder() .setExclusionStrategies(excludeStrategy) .create(); Gson gson2 = new Gson(); String json1 = gson1.toJson(p); String json2 = gson2.toJson(p); System.out.println(json1); System.out.println(json2); People p1 = gson1.fromJson(json1, People.class); People p2 = gson2.fromJson(json2, People.class); System.out.println(p1); System.out.println(p2); } private static class SetterExclusionStrategy implements ExclusionStrategy { public boolean shouldSkipClass(Class<?> clazz) { return false; } public boolean shouldSkipField(FieldAttributes f) { return f.getName().startsWith("set"); } } }
本來,Gson對象的創立有兩種方法:new Gson()表現應用默許的設置裝備擺設創立一個Gson對象,而假如應用GsonBuilder.create()辦法創立,則可以自界說一些設置,這重要是為了使創立的Gson更合適於某些特定的情形。上例中第一段藍色的代碼創立了一個Gson對象,這個對象具有對以“set”字樣開首的屬性的過濾的設置裝備擺設(假如須要過濾失落某品種型,則重寫ExclusionStrategy接口的shouldSkipClass(Class<?> clazz)辦法便可,假如須要過濾失落多種情形,則可以多創立幾個ExclusionStrategy的完成類對象,並在創立Gson對象的時刻設置出來便可),是以在本例中,將People對象轉換成Json的時刻,屬性setName將被過濾失落。因為json1中沒有屬性setName,所以將json1反序列化成People對象的時刻,boolean類型的setName就沒有了值,所以打印的時刻取了boolean類型的默許值。因而有了以下成果:
{"name":"People","age":20} {"name":"People","age":20,"setName":true} name=People age=20 setName=false name=People age=20 setName=true
Gson還支撐應用注解,在com.谷歌.gson.annotation包中,有幾個注解Expose, SerializedName, Since和Until,他們各有各的感化,上面應用官方例子引見經常使用的注解:
Expose:
此注解感化在屬性上,注解當序列化和反序列化的時刻,這個屬性將會裸露給Gson對象。這個注解只要當創立Gson對象時應用GsonBuilder方法創立並挪用了GsonBuilder.excludeFieldsWithoutExposeAnnotation() 辦法的時刻才有用,不然有效。上面是一個引見@Expose注解若何應用的例子:
public class User { @Expose private String firstName; @Expose(serialize = false) private String lastName; @Expose (serialize = false, deserialize = false) private String emailAddress; private String password; }
假如你以new Gson()的方法創立Gson對象,toJson()辦法和fromJson() 辦法在序列化和反序列化的時刻將會操作這4個屬性。但是,假如你應用 Gson gson = new GsonBuilder().excludeFieldsWithoutExposeAnnotation().create()來創立Gson對象,Gson 的 toJson() 和 fromJson() 辦法將會消除失落 password 字段,這是由於 password 字段沒有被注解 @Expose 所標志。 這個 Gson 對象異樣會消除 lastName 和 emailAddress 字段,由於注解@Expose的屬性 serialize 被設置成了 false。相似的,Gson 將會在反序列化時消除失落 emailAddress 字段,由於 deserialize被設置成了 false。
SerializedName:
此注解感化在屬性上,注解這個屬性在序列化成Json的時刻,須要將名字序列化成注解的value屬性指定的值。
這個注解將會籠罩任何的FieldNamingPolicy, 包含默許的定名戰略。上面是一個引見@SerializedName注解若何應用的例子: ,
public class SomeClassWithFields { @SerializedName("name") private final String someField; private final String someOtherField; public SomeClassWithFields(String a, String b) { this.someField = a; this.someOtherField = b; } }
上面的代碼展現了序列化下面這個測試類的成果:
SomeClassWithFields objectToSerialize = new SomeClassWithFields("a", "b"); Gson gson = new Gson(); String jsonRepresentation = gson.toJson(objectToSerialize); System.out.println(jsonRepresentation);
履行成果是:
{"name":"a","someOtherField":"b"}
因而可知,屬性"someField"曾經被序列化成了"name"。
留意:在@SerializedName的value中指定的屬性名必需為有用的Json屬性名。