基于Jackson封裝Json工具類：Java對象與JSON字元串的高效轉換

在現代的Web開發和API設計中，JSON（JavaScript Object Notation）作為一種輕量級的資料交換格式被廣泛使用。它易于人閱讀和編寫，同時也易于機器解析和生成。在Java生态系統中，Jackson庫是處理JSON資料最為流行且功能強大的工具之一。本文将詳細介紹如何基于Jackson庫封裝一個簡單易用的JSON工具類，以實作Java對象與JSON字元串之間的互相轉換。

一、引言：Jackson 庫簡介

Jackson 是一款高性能的 JSON 處理庫，它提供了對 JSON 的序列化（Object to JSON）與反序列化（JSON to Object）能力。通過使用 Jackson，我們可以輕松地将 Java 對象轉換為 JSON 字元串發送給前端或者服務端，反之亦然，可以将接收到的 JSON 資料解析成對應的 Java 對象。

二、建立 JsonUtil 工具類

首先，我們需要建立一個名為 JsonUtil 的工具類，并在其中初始化一個全局的 ObjectMapper 執行個體。ObjectMapper 是 Jackson 中的核心元件，負責執行實際的序列化和反序列化操作。

import com.fasterxml.jackson.databind.ObjectMapper;

public class JsonUtil {

    // 單例模式下的 ObjectMapper 執行個體
    private static final ObjectMapper mapper = new ObjectMapper();

    // 私有構造函數防止執行個體化
    private JsonUtils() {}
    
    // ... 其他方法定義 ...
}           

三、序列化：Java 對象轉 JSON 字元串

接下來，我們為 JsonUtil 添加一個靜态方法 toJson()，用于将 Java 對象轉換為 JSON 字元串：

/**
 * 将 Java 對象轉換為 JSON 字元串
 * @param object 需要轉換的 Java 對象
 * @return JSON 格式的字元串
 * @throws JsonProcessingException 在轉換過程中如果發生錯誤抛出此異常
 */
public static String toJson(Object object) throws JsonProcessingException {
    return mapper.writeValueAsString(object);
}
           

這個方法利用了 ObjectMapper 的 writeValueAsString() 方法，它可以接受任意類型的 Java 對象，并将其轉化為 JSON 字元串。

四、反序列化：JSON 字元串轉 Java 對象

為了實作從 JSON 字元串到 Java 對象的轉換，我們在工具類中添加另一個靜态方法 toObject()：

/**
 * 将 JSON 字元串反序列化為指定類型的 Java 對象
 * @param jsonStr JSON 格式的字元串
 * @param clazz 目标Java對象的Class類型
 * @param <T> 泛型标記，用于指定傳回的對象類型
 * @return 反序列化後的Java對象
 * @throws IOException 如果 JSON 解析失敗，則抛出此異常
 */
public static <T> T jsonToObject(String jsonStr, Class<T> clazz) throws IOException {
    return mapper.readValue(jsonStr, clazz);
}           

該方法調用了 ObjectMapper 的 readValue() 方法，傳入 JSON 字元串和目标 Java 類型的 Class 對象，進而将 JSON 資料還原為對應類型的 Java 對象。

五、總結與應用示例

通過以上步驟，我們已經成功地基于 Jackson 庫封裝了一個 JSON 工具類。現在，在實際項目中，無論是将自定義的 Java 對象轉換為 JSON 字元串發送至用戶端，還是接收 JSON 請求并轉換回相應的 Java 對象，都可以非常友善地調用 JsonUtil 類中的方法進行處理。

例如：

// 定義一個簡單的 User 類
public class User {
    private String name;
    private int age;

    // 構造方法、getter 和 setter 省略...
}

// 使用 JsonUtils 進行序列化和反序列化
User user = new User("John Doe", 30);

String jsonString = JsonUtil.toJson(user);  // 将 User 對象轉換為 JSON 字元串

User deserializedUser = JsonUtil.toObject(jsonString, User.class);  // 将 JSON 字元串轉換回 User 對象
           

這樣，我們就借助 Jackson 的強大功能，實作了在 Java 中靈活、高效的 JSON 資料處理