Java PDF 渲染器庫（開發者教程）

Java PDF庫簡介，IronPDF

如果您正在從事 Java 項目，並需要從 HTML 生成 PDF 文件或從 PDF 中提取文本，您應該尋找一個可靠且高效的 Java PDF 庫。 您可能會發現 IronPDF - The Java PDF Library，這可以簡化 PDF 文件的生成和操作，使您作為開發人員的生活更加輕鬆。 市場上有多個 PDF 庫，例如 PDF Clown 或 iText 庫，但本文將深入探討 IronPDF 的世界，並探索它如何幫助您的 Java 專案。

入門 IronPDF

IronPDF 是一個 Java 庫，允許您在 Java 應用程式中創建、閱讀和編輯 PDF 文件。 這個多功能的庫支援使用 IronPDF 從 HTML 產生 PDF、現有的 PDF 檔案和網址。 您可以使用IronPDF從PDF中提取文字，這使其成為任何處理PDF文件的Java開發者必備工具。

在 Maven 專案中安裝 IronPDF

Maven 是一個受歡迎的 Java 專案建置自動化和相依性管理工具。 要在您的 Maven 專案中安裝 IronPDF，您需要在 pom.xml 檔案中添加必要的依賴項。

以下是將 IronPDF 及其所需的日誌依賴項 SLF4J 添加到您的 Maven 專案中的方法：

1. 開啟專案的pom.xml檔案。

2. 找到dependencies部分。 如果不存在，則創建一個。

3. 為 IronPDF 和 SLF4J 添加以下依賴項條目：

   <dependency>
      <groupId>com.ironsoftware</groupId>
      <artifactId>com.ironsoftware</artifactId>
      <version>2025.4.4</version>
   </dependency>

   XML

4. 保存pom.xml檔案。

5. 在您的 IDE 中運行 Maven 專案，或在專案的根目錄中執行 mvn install 指令。 Maven 會自動下載並將 IronPDF 和 SLF4J 相依性新增到您的專案中。

   現在，您已成功將 IronPDF 添加到您的 Maven 項目中，您可以開始使用這個強大的 Java PDF 庫在您的 Java 應用程式中創建、編輯和操作 PDF 文件。 別忘了查看IronPDF 說明文件，以獲取更多範例和有關該庫功能及功能的詳細資訊。 讓我們在此探索一些功能。

將 HTML 轉換為 PDF

處理 PDF 時最常見的任務之一是使用 IronPDF 將 HTML 轉換為 PDF。 IronPDF 只需幾行代碼即可輕鬆實現這一點。 以下是一個範例，演示如何將簡單的 HTML 字串轉換為 PDF 文件：

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument;
PdfDocument myPdf = PdfDocument.renderHtmlAsPdf(" ~Hello World~  Made with IronPDF!");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_saved.pdf"));

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument;
PdfDocument myPdf = PdfDocument.renderHtmlAsPdf(" ~Hello World~  Made with IronPDF!");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_saved.pdf"));

此程式碼片段匯入必要的 IronPDF 類別並應用授權金鑰。 接下來，它會設置一個用於調試的日誌路徑。 renderHtmlAsPdf 方法將 HTML 字串作為輸入並將其轉換為 PDF 文件，然後您可以將其儲存到檔案。

輸出 PDF 檔案

將 HTML 文件轉換為 PDF

IronPDF 還支持將 HTML 文件轉換為 PDF 文件。 該過程與之前的例子非常相似，但使用的方法有一個小改變：

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument;
PdfDocument myPdf = PdfDocument.renderHtmlFileAsPdf("example.html");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_file_saved.pdf"));

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument;
PdfDocument myPdf = PdfDocument.renderHtmlFileAsPdf("example.html");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_file_saved.pdf"));

在這種情況下，使用[renderHtmlFileAsPdf](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#renderHtmlFileAsPdf(java.lang.String)方法而不是renderHtmlAsPdf，其將HTML文件的路徑作為輸入並創建PDF文檔。

將網址轉換為PDF

IronPDF 能夠將網頁轉換成 PDF 文件。 這在您想從動態網頁生成 PDF 報告時特別有用。 以下程式碼片段演示了如何做到這一點：

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument;
PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("url.pdf"));

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.Paths;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument;
PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("url.pdf"));

renderUrlAsPdf 方法將 URL 作為輸入，並從網頁內容創建 PDF 文件。 此方法可以處理包含 JavaScript 和 CSS 的複雜頁面。

從網址生成的輸出 PDF 文件

從 PDF 提取文本

除了創建 PDF，IronPDF 也提供從現有 PDF 文件中擷取文本的功能。 此功能在您需要搜索、索引或分析 PDF 文件內容時非常有用。以下代碼片段展示了如何從 PDF 文檔中提取文本：

PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://unsplash.com/");
String text = pdf.extractAllText();
System.out.println("Text extracted from the website: " + text);

PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://unsplash.com/");
String text = pdf.extractAllText();
System.out.println("Text extracted from the website: " + text);

在此示例中，從 URL 生成 PDF，然後使用 [extractAllText](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#extractAllText() 方法獲得 PDF 文件的文本內容。 提取的文本可以隨後列印到控制台或根據需要進行操作。

使用 IronPDF 將圖像轉換為 PDF

IronPDF 也可以將圖像轉換為 PDF 文件。 當您需要建立 PDF 資料夾或將多個圖片合併成一個文件時，這會派上用場。以下程式碼片段示範了如何將目錄中的一組圖片轉換成單個 PDF 文件：

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.*;
import java.util.ArrayList;
import java.util.List;

Path imageDirectory = Paths.get("assets/images");

List imageFiles = new ArrayList();

try (DirectoryStream stream = Files.newDirectoryStream(imageDirectory, "*.{png,jpg}")) {
    for (Object entry : stream) {
        imageFiles.add(entry);
    }

    PdfDocument.fromImage(imageFiles).saveAs(Paths.get("assets/composite.pdf"));
} catch (IOException exception) {
    throw new RuntimeException(String.format("Error converting images to PDF from directory: %s: %s",
            imageDirectory,
            exception.getMessage()),
            exception);
}

import com.ironsoftware.ironpdf.*;

import java.io.IOException;
import java.nio.file.*;
import java.util.ArrayList;
import java.util.List;

Path imageDirectory = Paths.get("assets/images");

List imageFiles = new ArrayList();

try (DirectoryStream stream = Files.newDirectoryStream(imageDirectory, "*.{png,jpg}")) {
    for (Object entry : stream) {
        imageFiles.add(entry);
    }

    PdfDocument.fromImage(imageFiles).saveAs(Paths.get("assets/composite.pdf"));
} catch (IOException exception) {
    throw new RuntimeException(String.format("Error converting images to PDF from directory: %s: %s",
            imageDirectory,
            exception.getMessage()),
            exception);
}

只需這段程式碼片段，IronPDF 就可以輕鬆地將多張圖片轉換成單個 PDF 文件，進一步展示了該庫在各種 PDF 相關任務中的多功能性和實用性。

結論

IronPDF 是一個強大且多功能的 Java PDF 庫，可簡化 Java 應用中的 PDF 生成和操作。 透過其易於使用的API，您可以輕鬆使用IronPDF將HTML、HTML檔案和網址轉換為PDF文檔，以及從現有的PDF檔案中提取PDF中的文本。 透過將 IronPDF 整合到您的 Java 專案中，您可以簡化工作流程並輕鬆創建高品質的 PDF。

此外，IronPDF 還能夠在 PDF 中渲染圖表，為 PDF 文件添加浮水印，以程式化方式處理PDF 表單和數位簽名。

IronPDF 提供免費試用，讓您有足夠的時間評估其功能並確定它是否適合您的項目。 如果您決定在試用期後繼續使用IronPDF，授權費用從$749開始。