GsonMap：一個便捷的Gson轉換工具

一、簡介

GsonMap 是一個基於 Google 的 Gson 庫封裝的工具類，以實例化鏈為基礎，提供了一種更方便的使用方式。它不僅可以對普通對象和列表進行序列化/反序列化，還可以將對象嵌套在嵌套的 Map 中並進行序列化/反序列化。

二、使用方式

GsonMap 的使用方式非常簡單，只需要像下面的代碼一樣，將 GsonMap 實例化，然後使用 toGson() 和 fromGson() 方法即可實現 Gson 庫的序列化和反序列化功能。

GsonMap myMap = new GsonMap();
String json = "{\"name\":\"John\", \"age\":30, \"city\":\"New York\"}";

// 將 JSON 字元串轉換為 Map
Map<String, Object> map = myMap.fromGson(json);

// 將 Map 轉換為 JSON 字元串
String newJson = myMap.toGson(map);

三、支持的類型

除了基本類型和對象外，GsonMap 還支持將嵌套的 Map 轉換為 JSON 字元串。

如下面的例子，如果我們有一個名為 user 的 Map，其中包含另一個名為 address 的 Map，我們可以將整個 user Map 轉換為 JSON 字元串，該字元串包括 name、age 和一個包含 address 的子 Map。同樣，我們還可以從 JSON 字元串中反序列化為一個 Map，其中包含嵌套的 Map。

GsonMap myMap = new GsonMap();
String json = "{\n" +
            "  \"name\": \"John\",\n" +
            "  \"age\": 30,\n" +
            "  \"address\": {\n" +
            "    \"street\": \"Lane 3\",\n" +
            "    \"city\": \"New York\",\n" +
            "    \"state\": \"NY\"\n" +
            "  }\n" +
            "}";

// 將 JSON 轉換為 Map
Map<String, Object> map = myMap.fromGson(json);

// 從 Map 序列化為 JSON
String newJson = myMap.toGson(map);

四、自定義序列化和反序列化

GsonMap 還支持自定義序列化和反序列化。可以通過實現 GsonMapDeserializer 和 GsonMapSerializer 介面來實現。例如，假設我們有一個複雜的 User 對象，例如：

class User {
    String name;
    int age;
    List hobbies;
    Address address;
}

class Address {
    String street;
    String city;
    String state;
}

我們可以通過實現 GsonMapSerializer 和 GsonMapDeserializer 介面來擴展 GsonMap 以支持自定義序列化和反序列化，例如：

class UserSerializer implements GsonMapSerializer<User> {
    public Map<String, Object> serialize(User user) {
        Map<String, Object> result = new HashMap<>();
        result.put("name", user.name);
        result.put("age", user.age);
        result.put("hobbies", user.hobbies);
        result.put("address", new GsonMap().serialize(user.address));

        return result;
    }
}

class UserDeserializer implements GsonMapDeserializer<User> {
    public User deserialize(Map<String, Object> map) {
        User user = new User();
        user.name = (String) map.get("name");
        user.age = (int) map.get("age");
        user.hobbies = (List) map.get("hobbies");
        user.address = new GsonMap().deserialize((Map) map.get("address"), Address.class);

        return user;
    }
}

然後，我們可以使用下面的代碼將自定義的序列化器和反序列化器傳遞給 GsonMap 構造函數：

GsonMap myMap = new GsonMap(new UserSerializer(), new UserDeserializer());
String json = "{\n" +
            "  \"name\": \"John\",\n" +
            "  \"age\": 30,\n" +
            "  \"hobbies\": [\"Hiking\", \"Reading\"],\n" +
            "  \"address\": {\n" +
            "    \"street\": \"Lane 3\",\n" +
            "    \"city\": \"New York\",\n" +
            "    \"state\": \"NY\"\n" +
            "  }\n" +
            "}";
User myUser = myMap.deserialize(json, User.class);

五、結論

GsonMap 提供了一個便捷的使用方式，可以讓我們更方便地序列化和反序列化 JSON 數據。它支持基本類型、嵌套的對象、嵌套的列表和嵌套的 Map，並支持自定義序列化和反序列化。在處理 JSON 數據時，使用 GsonMap 可以提高代碼的可讀性和可維護性，使代碼更加簡潔和易於理解。