gson介紹 - JavaShuo

Gson介紹：java

gson，其實就是google官方的一個解析json裏的數據的庫。方便咱們從json中提取數據。使用它，只須要幾行代碼，就能把json轉換成一個Java數據類。spring

特色： 
    a、快速、高效
    b、代碼量少、簡潔
    c、面向對象
    d、數據傳遞和解析方便
複製代碼

Gson的build.gradle依賴：json

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
複製代碼

Gson的建立方式：api

　　方式一：數組

Gson gson = new Gson();
複製代碼

　　方式二：經過GsonBuilder()，能夠配置多種配置。markdown

Gson gson = new GsonBuilder()
                        .setLenient()// json寬鬆  
                        .enableComplexMapKeySerialization()//支持Map的key爲複雜對象的形式  
                        .serializeNulls() //智能null  
                        .setPrettyPrinting()// 調教格式  
                        .disableHtmlEscaping() //默認是GSON把HTML 轉義的
                        .create();  
複製代碼

Gson的基本用法：ide

注：JavaBean：spring-boot

@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString
@Builder
public class PersonJson {
    private String name;
    private Integer age;
    private String hobby;
}
複製代碼

//hobby是在後面的例子中添加的。要麼就name,age兩個屬性，要麼就三個。 //上面的註解是lombok的註解，起到簡化Bean類的做用。測試

Gson提供了public String toJson(Objcet obj)方法，能夠將對象轉化爲json字符串。 JavaBean轉化爲json字符串gradle

public class IndexTest {
    PersonJson person;
    @Before
    public void prepare() {
        person = new PersonJson("慄霖",18);
    }

    @Test
    public void index() {
        Gson gson = new Gson();
        System.out.println(gson.toJson(person));
        System.out.println("---------------");
        Gson gson1 = new GsonBuilder().create();
        System.out.println(gson1.toJson(person));
    }
}
複製代碼

List Map 轉化爲json字符串

public class IndexTest {
    PersonJson person;
    List<PersonJson> list = new ArrayList<>();
    Map<String,PersonJson> map = new HashMap<>();
    @Before
    public void prepare() {
        person = new PersonJson("慄霖",18);
        list.add(person);
        map.put(person.getName(),person);
    }

    @Test
    public void index() {
        Gson gson = new Gson();
        System.out.println("---->List convert json" + gson.toJson(list));
        System.out.println("------------------------");
        System.out.println("---->map convert json" + gson.toJson(map));
    }
}
複製代碼

Gson提供了public T fromJson(String jsonStr,T.class)方法，能夠將json字符串轉化爲Java對象 json字符串轉化爲JavaBean

public class SecondTest {
    @Test
    public void index() {
        String jsonStr = "{\"name\":\"慄霖\",\"age\":\"18\"}";
        Gson gson = new GsonBuilder().create();
        PersonJson p = gson.fromJson(jsonStr,PersonJson.class);
        System.out.println("---->jsonStr convert javaBean " + p.getName() + " " + p.getAge());
    }
}
複製代碼

json字符串轉化爲list集合

public class SecondTest {
    @Test
    public void index() {
        String listJsonStr = "[{\"name\":\"慄霖\",\"age\":\"18\"},{\"name\":\"慄霖之雨\",\"age\":\"18\"}]";
        Gson gson = new GsonBuilder().create();
        List<PersonJson> list = gson.fromJson(listJsonStr,new TypeToken<ArrayList<PersonJson>>(){}.getType());
        System.out.println("---->listJsonStr convert List " + list);
    }
}
複製代碼

json的抽象基類JsonElemetn:

JsonNull其實就是Null字段

public class SecondTest {
    @Test
    public void index() {
        //JsonNull jsonNull = new JsonNull();該方法已通過時
        JsonNull jsonNull = JsonNull.INSTANCE;
        System.out.println("---->jsonNull  " + jsonNull);
    }
}
複製代碼

jsonPrimitive能夠幫助咱們獲取帶轉義字符的字符串。這個就不寫了。感受沒啥用到。建立JsonObject：

　　能夠經過addProperty(String,Object)向JsonObject添加屬性，跟hashmap相似。

public class SecondTest {
    @Test
    public void index() {
        JsonObject jsonObject = new JsonObject();
        jsonObject.addProperty("name","慄霖");
        jsonObject.addProperty("age",18);
        System.out.println("---->create jsonObject  " + jsonObject);
    }
}

複製代碼

建立JsonArray

public class SecondTest {
    @Test
    public void index() {
        JsonArray jsonArray = new JsonArray();
        jsonArray.add("a");
        jsonArray.add("b");
        jsonArray.add("c");
        jsonArray.add("d");
        System.out.println("---->create jsonArray: " + jsonArray);
    }
}
複製代碼

JsonObject嵌套數組或者說JsonObject嵌套JsonArray

public class SecondTest {
    @Test
    public void index() {
        JsonObject jsonObject = new JsonObject();
        jsonObject.addProperty("name","慄霖");
        jsonObject.addProperty("age",18);
        JsonArray jsonArray = new JsonArray();
        jsonArray.add("是碼農");
        jsonArray.add("之前喜歡玩遊戲");
        jsonArray.add("如今只敢當心積累");
        jsonArray.add("只怕忽然白了頭");
        jsonObject.add("status",jsonArray);
        System.out.println("---->create jsonArray: " + jsonObject);
    }
}
複製代碼

Gson註解

重命名註解：@SerializedName
複製代碼

當你調用其餘服務時，他們返回的json KEY值與你的Bean屬性名稱不對應怎麼辦？

這時候就須要@SerializedName啦。他能夠幫助你解決這個問題！

實體類：

@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString
@Builder
public class PersonJson {
    private String name;
    private Integer age;
    //這裏只是隨便舉個例子，千萬不要用中文！！！
    @SerializedName(value = "愛好")
    private String hobby;
}
複製代碼

示例：

public class SecondTest {
    JsonObject jsonObject;
    JsonArray jsonArray;

    @Before
    public void index() {
        jsonObject = new JsonObject();
        jsonObject.addProperty("name","慄霖");
        jsonObject.addProperty("age",18);
        jsonArray = new JsonArray();
        jsonArray.add("是碼農");
        jsonArray.add("之前喜歡玩遊戲");
        jsonArray.add("如今只敢當心積累");
        jsonArray.add("只怕忽然白了頭");
        jsonObject.addProperty("愛好",jsonArray.toString());
    }

    @Test
    public void formal() {
        Gson gson = new GsonBuilder().create();
        PersonJson personJson = gson.fromJson(jsonObject.toString(),PersonJson.class);
        System.out.println("---->String: " + personJson);
    }
}
複製代碼

@serializedName

除了value屬性外，還可使用alternate屬性，這個值能夠替換前面的值，將傳入的json進行修改。

注：value的值不能出如今alternate中，alternate是備選字段。

@SerializedName(value = "hobby", alternate = {"interest","be fond of"})

過濾註解@Expose

注：默認是既能夠序列化，也能夠反序列化。必定要配合GsonBuilder一塊兒使用

　　該註解是加在JavaBean的屬性上使用的。

　　配合這個使用哦Gson gson = new GsonBuilder().excludeFieldWithoutExposeAnnotation().create();

有四種使用方式：

　　1）不使用@Expose註解等同於@Expose(deserialize = false, serialize = false)不作任何解析

　　2）@Expose(deserialize = true, serialize = false)只解析使用，能夠反序列化，不能夠序列化。

　　3）@Expose(deserialize = false, serialize = true)能夠序列化，不能夠反序列化。

　　4）@Expose(deserialize = false, serialize = true)既能夠序列化，也能夠反序列化。

注：這裏的序列化指：將對象轉化爲json字符串。反序列化指：將json字符串轉化成對象。版本控制註解@Since(float v)

結合GsonBuilder().serVersion(n)使用。當n>=v時，纔會解析。

注：也是加在JavaBean屬性上使用的。版本控制註解@Util(float v)

與@Since相反，此次是n<v時纔可以解析。

使用TypeAdapter來實現序列化與反序列化。使用TypeAdapter來序列化和反序列化

代碼：

public class FiveTest {
    @Test
    public void index() {
        Gson gson = new GsonBuilder().create();
        TypeAdapter<PersonJson> typeAdapter = gson.getAdapter(PersonJson.class);
        String json = "{\"name\":\"慄霖\",\"age\":\"18\",\"hobby\":\"我非常很喜歡FromSoftWare的。大愛宮崎英高，讚美太陽\"}";
        PersonJson p = new PersonJson("慄霖",18,"混系列忠實粉絲");

        System.out.println("---->序列化:是將對象轉化爲字符串 : " + typeAdapter.toJson(p));
        try {
            System.out.println("---->反序列化：是將字符串轉化爲對象 : "+ typeAdapter.fromJson(json));
        }catch (Exception e) {
            e.printStackTrace();
        }
    }
}
複製代碼

Gson的容錯機制

爲何容錯：

　　若是Bean中定義的是int，可是返回的json對應的是一個""空字串怎麼辦？這就依賴到了Gson的容錯機制。

1）建立寬鬆Gson

遇到問題，中止解析，以防止報錯，功能相對較弱。

Gson gson = new GsonBuilder()
                        .setLenient()//寬鬆
                        .create();
複製代碼

2)自定義TypeAdapter

該方法更傾向於總體防止出現異常。

public class ThirdTest {

    public static class PersonTypeAdapter extends TypeAdapter<PersonJson> {
        @Override
        public void write(JsonWriter jsonWriter, PersonJson personJson) throws IOException {
            jsonWriter.beginObject();
            jsonWriter.name("name").value(personJson.getName());
            jsonWriter.name("age").value(personJson.getAge());
            jsonWriter.name("hobby").value(personJson.getHobby());
            jsonWriter.endObject();
        }

        @Override
        public PersonJson read(JsonReader jsonReader) throws IOException {
            PersonJson personJson = new PersonJson();
            jsonReader.beginObject();
            while (jsonReader.hasNext()) {
                switch (jsonReader.nextName()) {
                    case "name":
                        personJson.setName(jsonReader.nextString());
                        break;
                    case "age":
                        try {
                            personJson.setAge(Integer.valueOf(jsonReader.nextString()));
                        } catch (Exception e) {
                        }
                        break;
                    case "hobby":
                        personJson.setHobby(jsonReader.nextString());
                }
            }
            jsonReader.endObject();
            return personJson;
        }
    }

    @Test
    public void index() {
        Gson gson = new Gson();

        String json = "{\"name\":\"慄霖\",\"age\":\"\",\"hobby\":\"籃球吧，讀書吧，steam吧\"}";

        System.out.println("----> " + json );

        try {
            PersonJson p1 = gson.fromJson(json,PersonJson.class);
            System.out.println("---->默認解析 " + p1);
        }catch (Exception e) {
            System.out.println("---->異常解析，這裏json字符串缺失了age的值，真的是怕一轉眼就白了頭啊" +e);
        }

        Gson gson1 = new GsonBuilder().registerTypeAdapter(PersonJson.class,new PersonTypeAdapter()).create();

        try {
            PersonJson p2 = gson1.fromJson(json,PersonJson.class);
            System.out.println("---->自定義Adapter 默認解析 "+p2);
        }catch (Exception e) {
            System.out.println("---->自定義adapter 異常解析" + e);
        }

        try {
            PersonTypeAdapter personTypeAdapter = new PersonTypeAdapter();
            PersonJson p3 = personTypeAdapter.fromJson(json);
            System.out.println("---->自定義Adapter 默認解析 " + p3);
        }catch (Exception e){
            System.out.println("---->自定義Adapter 異常解析 " +e);
        }
    }
}
複製代碼

3）使用註解jsonAdapter，其實質也是自定義Adapter

　　該方法更傾向於某一個屬性的保護。

實體類:

public class PersonJson {
    private String name;
    @JsonAdapter(IntegerTypeAdapter.class)
    private Integer age;
    private String hobby;
}
複製代碼

Adapter：

public class IntegerTypeAdapter extends TypeAdapter<Integer>{
    @Override
    public void write(JsonWriter jsonWriter, Integer integer) throws IOException {
        jsonWriter.value(integer);
    }

    @Override
    public Integer read(JsonReader jsonReader) throws IOException {
        int i = 0;
        try {
            i = Integer.valueOf(jsonReader.nextString());
        }catch (Exception e){}
        return i;
    }
}
複製代碼

測試類：

public class FourTest {

    @Test
    public void index() {
        Gson gson = new Gson();
        String json = "{\"name\":\"慄霖\",\"age\":\"\",\"hobby\":\"籃球吧，讀書吧，steam吧\"}";

        try {
            PersonJson p1 = gson.fromJson(json,PersonJson.class);
            System.out.println("---->默認解析 " + p1);
        }catch (Exception e) {
            System.out.println("---->異常解析，這裏json字符串缺失了age的值，真的是怕一轉眼就白了頭啊" +e);
        }

        try {
            PersonJson p2 = gson.fromJson(json,PersonJson.class);
            System.out.println("---->默認解析 " + p2);
        }catch (Exception e) {
            System.out.println("---->異常解析" + e);
        }
    }
}
複製代碼