探究Gson轉對象

一、Gson簡介

Gson是Google提供的用來轉換Java對象與JSON數據格式的Java類庫。它可以將JSON數據轉換為Java對象，也可以將Java對象轉換為JSON數據。Gson的作用類似於Java中的序列化和反序列化。

Gson提供了簡單易用的API來實現JSON數據的序列化和反序列化，同時也提供了高級功能，如通過註解自定義序列化和反序列化，以及通過TypeAdapter在某些場景下更精細地控制序列化和反序列化過程。

二、Gson基本用法

使用Gson將Java對象轉換為JSON數據格式的代碼如下：

Gson gson = new Gson();
String json = gson.toJson(object); //object為待轉換的Java對象

將JSON數據格式轉化為Java對象的代碼如下：

Gson gson = new Gson();
Object object = gson.fromJson(json, Object.class); //json為待轉換的JSON數據

其中，Gson提供了很多toJson()和fromJson()的重載方法，可以根據不同的需求進行轉換。例如，toJson()方法還可以接受一個Writer對象，用於將JSON數據格式輸出到文件或網路流中。

三、Gson註解

使用註解可以更精細地控制Gson的序列化和反序列化過程。Gson提供了以下注解：

• @SerializedName：用於將Java對象的欄位名與JSON中的欄位名相對應。
• @Expose：用於標識哪些Java對象的欄位需要進行序列化和反序列化。
• @JsonAdapter：用於指定通過TypeAdapter自定義的序列化和反序列化方式。

舉個例子，下面是一個使用@SerializedName註解的示例：

public class Person {
  @SerializedName("name")
  private String mName;
  @SerializedName("age")
  private int mAge;
}

在這個示例中，Person類中的成員變數mName和mAge分別對應JSON格式中的”name”和”age”欄位。

四、Gson TypeAdapter

有時候，在處理JSON格式數據時，我們需要針對某些數據類型進行更加細緻的轉換。例如，Gson默認將Date類型轉換為毫秒數，而我們可能需要將其轉換為指定的日期格式。這時候，我們可以使用TypeAdapter來自定義轉換方式。

下面是一個使用TypeAdapter自定義轉換Long型時間戳為Java Date類型的示例：

public class DateTypeAdapter extends TypeAdapter {
 
  @Override
  public void write(JsonWriter out, Date value) throws IOException {
    if (value == null) {
      out.nullValue();
      return;
    }
    out.value(value.getTime());
  }
 
  @Override
  public Date read(JsonReader in) throws IOException {
    if (in.peek() == JsonToken.NULL) {
      in.nextNull();
      return null;
    }
    return new Date(in.nextLong());
  }
}

以上代碼定義了一個名為DateTypeAdapter的TypeAdapter，實現了將Java Date類型轉換為Long型時間戳的功能。

下面是一個使用自定義TypeAdapter的示例：

public class Person {
  private String mName;
  @JsonAdapter(DateTypeAdapter.class)
  private Date mBirthday;
}

在這個示例中，Person類中的mBirthday欄位通過@JsonAdapter註解指定了DateTypeAdapter作為轉換方式。

五、Gson高級用法

除上面說到的基礎功能和註解功能外，Gson還提供了很多高級用法，如泛型支持、json轉換Promise、支持自定義Instance Creators等。

關於Gson的更多高級用法，可以查看官方文檔。

六、總結

本文從Gson的基本用法、註解、TypeAdapter和高級用法四個方面對Gson進行了詳細的介紹。其中，註解和TypeAdapter可以幫助我們更精細地控制Gson的序列化和反序列化過程，而高級用法則可以滿足一些更為複雜的需求。