信息圖標
跳過到頁腳內容
  1. IronPDF for Java
  2. IronPDF for Java 博客
  3. Java 幫助
  4. Jackson Java
JAVA 幫助

Jackson Java（開發者運作原理）

Darrius Serrant
Darrius Serrant
更新日期:

在現代編程的領域中，以 JSON (JavaScript Object Notation) 形式處理數據已成為一項關鍵任務。 JSON 的簡單性和易用性使其成為服務器與客戶端之間數據交換的熱門選擇。 對於 Java 開發人員來說，Jackson 庫成為 JSON 處理的強大工具。 本文深入探討 Jackson Java 的功能、用法和優勢，並提供代碼示例來說明其功能。 此外，我們還將探索IronPDF for Java，並演示如何將其與 Jackson 集成，從 JSON 數據生成 PDF 文檔。

什麼是 Jackson？

Jackson 是一個高性能的 Java JSON 處理器。 它提供全面的 JSON 支持，提供了一套將 Java 對象序列化為 JSON 並將 JSON 反序列化為 Java 對象的工具。 由 FasterXML 開發，Jackson 因其穩健性、靈活性和易用性而廣泛應用於 Java 社區。

Jackson 的核心功能

  1. 數據綁定：Jackson 在將 Java 對象轉換為 JSON 和反之亦然方面表現出色，使得序列化和反序列化數據變得簡單直接。
  2. 樹模型：此功能允許將 JSON 解析為類似樹的結構，從而無需將其綁定到特定的 Java 對象即可操作 JSON 數據。
  3. 流 API：對於大型 JSON 文件的處理，Jackson 提供了一個低級 API，可以將 JSON 內容讀寫為離散的標記。
  4. 註解支持：Jackson 支持各種註解來控制序列化和反序列化過程，提供對 JSON 處理的細粒度控制。
  5. 擴展性：擁有各種數據格式和額外功能的模塊，Jackson 具有高度擴展性。

Jackson Java (How It Works For Developers): 圖 1

如何開始使用 Jackson

要在您的 Java 項目中開始使用 Jackson，您需要添加必要的依賴項。 對於使用 Maven 的用戶，將以下代碼添加到您的 pom.xml 中：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.2</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.2</version>
</dependency>
XML

Jackson 的基本用法

1. 數據綁定

Jackson 最常見的用法是將 JSON 數據綁定到 Java 對象（POJO）並反之亦然。 這是一個簡單的示例來演示這一點：

import com.fasterxml.jackson.databind.ObjectMapper;

// Class demonstrating JSON data binding using Jackson
class Main {
    public static void main(String[] args) {
        ObjectMapper objectMapper = new ObjectMapper();

        // Try-catch block to handle potential exceptions during JSON processing
        try {
            // Create a User object and serialize it to a JSON string
            User user = new User("John", "Doe", 30);
            String jsonString = objectMapper.writeValueAsString(user);
            System.out.println("JSON String: " + jsonString);

            // Deserialize JSON string back into a User object
            String jsonInput = "{\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"age\":25}";
            User userFromJson = objectMapper.readValue(jsonInput, User.class);
            System.out.println("User from JSON: " + userFromJson);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

// A simple User class with basic attributes
class User {
    public String firstName;
    public String lastName;
    public int age;

    // Default constructor
    public User() {
    }

    // Parameterized constructor
    public User(String firstName, String lastName, int age) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.age = age;
    }

    // Override toString for easier printing
    @Override
    public String toString() {
        return "User [firstName=" + firstName + ", lastName=" + lastName + ", age=" + age + "]";
    }
}
import com.fasterxml.jackson.databind.ObjectMapper;

// Class demonstrating JSON data binding using Jackson
class Main {
    public static void main(String[] args) {
        ObjectMapper objectMapper = new ObjectMapper();

        // Try-catch block to handle potential exceptions during JSON processing
        try {
            // Create a User object and serialize it to a JSON string
            User user = new User("John", "Doe", 30);
            String jsonString = objectMapper.writeValueAsString(user);
            System.out.println("JSON String: " + jsonString);

            // Deserialize JSON string back into a User object
            String jsonInput = "{\"firstName\":\"Jane\",\"lastName\":\"Doe\",\"age\":25}";
            User userFromJson = objectMapper.readValue(jsonInput, User.class);
            System.out.println("User from JSON: " + userFromJson);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

// A simple User class with basic attributes
class User {
    public String firstName;
    public String lastName;
    public int age;

    // Default constructor
    public User() {
    }

    // Parameterized constructor
    public User(String firstName, String lastName, int age) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.age = age;
    }

    // Override toString for easier printing
    @Override
    public String toString() {
        return "User [firstName=" + firstName + ", lastName=" + lastName + ", age=" + age + "]";
    }
}
JAVA

Jackson Java (How It Works For Developers): 圖 2 - 綁定 JSON 數據到 Java 對象的示例輸出

2. 樹模型

Jackson 的樹模型對於無需創建 Java 類即可操作 JSON 數據很有用。 這裡是一個示例：

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;

// Example of utilizing the Tree Model feature of Jackson
class TreeModelExample {
    public static void main(String[] args) {
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // JSON string that we need to parse
            String jsonString = "{\"name\":\"John\", \"age\":30}";

            // Parse JSON string into a JsonNode (tree structure)
            JsonNode rootNode = objectMapper.readTree(jsonString);
            System.out.println("Name: " + rootNode.get("name").asText());
            System.out.println("Age: " + rootNode.get("age").asInt());

            // Modify the JSON structure using Tree Model
            ((ObjectNode) rootNode).put("age", 31);
            System.out.println("Modified JSON: " + rootNode.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;

// Example of utilizing the Tree Model feature of Jackson
class TreeModelExample {
    public static void main(String[] args) {
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // JSON string that we need to parse
            String jsonString = "{\"name\":\"John\", \"age\":30}";

            // Parse JSON string into a JsonNode (tree structure)
            JsonNode rootNode = objectMapper.readTree(jsonString);
            System.out.println("Name: " + rootNode.get("name").asText());
            System.out.println("Age: " + rootNode.get("age").asInt());

            // Modify the JSON structure using Tree Model
            ((ObjectNode) rootNode).put("age", 31);
            System.out.println("Modified JSON: " + rootNode.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
JAVA

Jackson Java (How It Works For Developers): 圖 3 - 直接修改 JSON 數據而不使用 Java 類

3. 流 API

對於大型 JSON 文件的處理，流 API 是高效的：

import com.fasterxml.jackson.core.JsonFactory;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.core.JsonToken;
import java.io.File;

// Example of using Jackson's Streaming API for large files
class StreamingAPIExample {
    public static void main(String[] args) {
        JsonFactory factory = new JsonFactory();
        try (JsonParser parser = factory.createParser(new File("large.json"))) {

            // Iterate over JSON tokens for efficient reading
            while (!parser.isClosed()) {
                JsonToken token = parser.nextToken();
                if (token == JsonToken.FIELD_NAME) {
                    // Print each field name as we parse through JSON
                    String fieldName = parser.getCurrentName();
                    System.out.println("Field: " + fieldName);
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
import com.fasterxml.jackson.core.JsonFactory;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.core.JsonToken;
import java.io.File;

// Example of using Jackson's Streaming API for large files
class StreamingAPIExample {
    public static void main(String[] args) {
        JsonFactory factory = new JsonFactory();
        try (JsonParser parser = factory.createParser(new File("large.json"))) {

            // Iterate over JSON tokens for efficient reading
            while (!parser.isClosed()) {
                JsonToken token = parser.nextToken();
                if (token == JsonToken.FIELD_NAME) {
                    // Print each field name as we parse through JSON
                    String fieldName = parser.getCurrentName();
                    System.out.println("Field: " + fieldName);
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
JAVA

輸入 JSON 文件

Jackson Java (How It Works For Developers): 圖 4 - 示例輸入 JSON 數據

輸出圖像

Jackson Java (How It Works For Developers): 圖 5 - 處理後的示例輸出數據欄位

介紹 IronPDF for Java

IronPDF 是 Java 中創建、編輯和呈現 PDF 文檔的綜合庫。 它提供了一個簡單的 API，從各種來源（例如 HTML、URL 或現有文檔）生成 PDF。 IronPDF 尤其在需要從 Jackson 處理的 JSON 數據創建 PDF 時非常有用，例如，當開發人員正在創建一個基於數據生成報告的 Spring Boot 應用程序時，IronPDF 可以顯著簡化工作流程。

Jackson Java (How It Works For Developers): 圖 6 - IronPDF 主頁：Java PDF 庫

將 IronPDF 添加到您的項目中

要在您的項目中使用 IronPDF，請添加以下依賴項：

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2023.6.0</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2023.6.0</version>
</dependency>
XML

將 Jackson 與 IronPDF 集成

通過組合使用 Jackson 和 IronPDF，我們可以創建一個強大的解決方案，從 JSON 數據生成 PDF 文檔。 下面是一個完整的示例，讀取 JSON 數據，用 Jackson 處理它，並使用 IronPDF 生成 PDF 文檔。

import com.fasterxml.jackson.databind.ObjectMapper;
import com.ironsoftware.ironpdf.PdfDocument;
import java.io.File;
import java.util.List;

// Example of integrating Jackson to handle JSON and IronPDF to generate PDFs
class JacksonIronPDFExample {
    public static void main(String[] args) {
        try {
            ObjectMapper objectMapper = new ObjectMapper();

            // Read JSON data from a file and convert it to a List of Person objects
            List<Person> persons = objectMapper.readValue(new File("persons.json"),
                    objectMapper.getTypeFactory().constructCollectionType(List.class, Person.class));

            // Generate HTML content based on JSON data
            StringBuilder htmlContent = new StringBuilder("<h1>Persons List</h1><table border='1'><tr><th>First Name</th><th>Last Name</th><th>Birth Date</th></tr>");
            for (Person person : persons) {
                htmlContent.append("<tr>")
                        .append("<td>").append(person.getFirstName()).append("</td>")
                        .append("<td>").append(person.getLastName()).append("</td>")
                        .append("<td>").append(person.getBirthDate()).append("</td>")
                        .append("</tr>");
            }
            htmlContent.append("</table>");

            // Use IronPDF to create a PDF from the HTML content
            PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlContent.toString());
            pdf.saveAs("persons.pdf");
            System.out.println("PDF created successfully from JSON data!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

// Sample Person class with basic attributes and necessary methods
class Person {
    private String firstName;
    private String lastName;
    private String birthDate;

    // Constructors, getters, and setters (omitted for brevity)
    public String getFirstName() {
        return firstName;
    }
    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }
    public String getLastName() {
        return lastName;
    }
    public void setLastName(String lastName) {
        this.lastName = lastName;
    }
    public String getBirthDate() {
        return birthDate;
    }
    public void setBirthDate(String birthDate) {
        this.birthDate = birthDate;
    }
}
import com.fasterxml.jackson.databind.ObjectMapper;
import com.ironsoftware.ironpdf.PdfDocument;
import java.io.File;
import java.util.List;

// Example of integrating Jackson to handle JSON and IronPDF to generate PDFs
class JacksonIronPDFExample {
    public static void main(String[] args) {
        try {
            ObjectMapper objectMapper = new ObjectMapper();

            // Read JSON data from a file and convert it to a List of Person objects
            List<Person> persons = objectMapper.readValue(new File("persons.json"),
                    objectMapper.getTypeFactory().constructCollectionType(List.class, Person.class));

            // Generate HTML content based on JSON data
            StringBuilder htmlContent = new StringBuilder("<h1>Persons List</h1><table border='1'><tr><th>First Name</th><th>Last Name</th><th>Birth Date</th></tr>");
            for (Person person : persons) {
                htmlContent.append("<tr>")
                        .append("<td>").append(person.getFirstName()).append("</td>")
                        .append("<td>").append(person.getLastName()).append("</td>")
                        .append("<td>").append(person.getBirthDate()).append("</td>")
                        .append("</tr>");
            }
            htmlContent.append("</table>");

            // Use IronPDF to create a PDF from the HTML content
            PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlContent.toString());
            pdf.saveAs("persons.pdf");
            System.out.println("PDF created successfully from JSON data!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

// Sample Person class with basic attributes and necessary methods
class Person {
    private String firstName;
    private String lastName;
    private String birthDate;

    // Constructors, getters, and setters (omitted for brevity)
    public String getFirstName() {
        return firstName;
    }
    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }
    public String getLastName() {
        return lastName;
    }
    public void setLastName(String lastName) {
        this.lastName = lastName;
    }
    public String getBirthDate() {
        return birthDate;
    }
    public void setBirthDate(String birthDate) {
        this.birthDate = birthDate;
    }
}
JAVA

輸入 JSON 文件

Jackson Java (How It Works For Developers): 圖 7 - 示例輸入 JSON 數據

輸出 PDF 文件

Jackson Java (How It Works For Developers): 圖 8 - 使用 IronPDF 生成表格的輸出，Jackson 將 JSON 數據轉換

結論

Jackson 是 Java 開發人員處理 JSON 數據的必備工具。 其多樣性、性能和易用性使其成為 JSON 處理的首選。 當與 IronPDF 結合使用時，它變得更強大，使開發人員能夠輕鬆地將 JSON 數據轉換為格式良好的 PDF 文檔。 通過集成這兩個庫，您可以簡化數據處理和報告流程，以最小的努力創建動態和專業外觀的 PDF。 Java 的生態系統，包括 Jackson databind 項目，不斷隨著小版本和重大更新而演變。 要確保您的項目使用最新工具，請始終檢查中央 Maven 存儲庫以獲取最新的 Jackson 版本和版本號更新。

要了解更多有關如何將 HTML 渲染為 PDF 的信息，請訪問IronPDF 概述。 有關 Jackson Core 和 Jackson 註解的更多詳細信息，請單擊外部鏈接並參考官方Jackson 文檔。

Darrius Serrant
Darrius Serrant
  立即與工程團隊聊天
全棧軟件工程師 (WebOps)

Darrius Serrant 擁有邁阿密大學計算機科學學士學位，目前任職於 Iron Software 的全栈 WebOps 市場營銷工程師。從小就迷上編碼，他認為計算既神秘又可接近，是創意和解決問題的完美媒介。

在 Iron Software，Darrius 喜歡創造新事物，並簡化複雜概念以便於理解。作為我們的駐場開發者之一，他也自願教學生，分享他的專業知識給下一代。

對 Darrius 來說，工作令人滿意因為它被重視且有實際影響。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用