在日常開發和辦公中，PDF 文件的處理需求日益增長，其中“合併 PDF”無疑是常見且棘手的問題之一。無論是將多份報告整合成一份，還是將掃描件與電子文檔拼接，高效、準確地合併 PDF 都是提升工作效率的關鍵。本文旨在為廣大 Java 開發者提供一套實用、原創且準確的解決方案，幫助您輕鬆實現 PDF 文件的合併操作。我們將深入探討如何利用 Spire.PDF for Java 這個強大的庫，實現多種場景下的 PDF 合併需求，讓您的 PDF 處理工作事半功倍。

Spire.PDF for Java 庫介紹與安裝

Spire.PDF for Java 是一個功能豐富的 PDF 處理庫，專為 Java 應用程序設計，可用於創建、讀取、編輯、轉換和打印 PDF 文檔。它提供了廣泛的 API，支持各種 PDF 操作，包括文本提取、圖像處理、表格操作、數字簽名等。其在 PDF 合併方面的表現尤為出色，能夠處理複雜場景下的合併需求。

安裝 Spire.PDF for Java

要使用 Spire.PDF for Java，您可以通過 Maven 或 Gradle 引入其依賴。

Maven 依賴：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.pdf</artifactId>
        <version>11.8.3</version>
    </dependency>
</dependencies>

引入依賴後，您就可以在 Java 項目中開始使用 Spire.PDF for Java 了。

Java 將多個 PDF 文件合併為一個

最常見的合併需求是將多個完整的 PDF 文件順序合併成一個。Spire.PDF for Java 提供了簡潔的 API 來實現這一功能。

import com.spire.pdf.FileFormat;
import com.spire.pdf.PdfDocument;
import com.spire.pdf.PdfDocumentBase;

public class MergePdfs {
    public static void main(String[] args) {

        // 獲取待合併的PDF文檔路徑
        String[] files = new String[] {"Sample1.pdf", "Sample2.pdf", "Sample3.pdf"};

        // 合併這些PDF文檔
        PdfDocumentBase pdf = PdfDocument.mergeFiles(files);

        // 保存合併後的PDF文件
        pdf.save("合併PDF文檔.pdf", FileFormat.PDF);
    }
}

上述代碼演示瞭如何將三個不同的 PDF 合併為一個新的 PDF。PdfDocument.mergeFiles() 是實現這一功能的核心方法，它會按照數組順序合併所有文檔。

Java 將多個 PDF 中的指定頁合併為新的 PDF

有時我們不需要合併整個 PDF 文件，而只需要提取其中某些頁進行合併。Spire.PDF for Java 同樣提供了靈活的頁面操作功能。

import com.spire.pdf.PdfDocument;

public class MergeSelectedPages {

    public static void main(String[] args) {

        // 獲取待合併的PDF文檔路徑
        String[] files = new String[] {"Sample1.pdf", "Sample2.pdf", "Sample3.pdf"};

        // 創建PdfDocument類型的數組
        PdfDocument[] pdfs = new PdfDocument[files.length];

        // 遍歷文檔數組
        for (int i = 0; i < files.length; i++)
        {
            // 加載指定的PDF文檔
            pdfs[i] = new PdfDocument(files[i]);
        }

        // 創建一個新的PDF文檔
        PdfDocument pdf = new PdfDocument();

        // 將不同PDF中的指定頁面插入到新PDF中
        pdf.insertPage(pdfs[0], 0);
        pdf.insertPageRange(pdfs[1], 1, 3);
        pdf.insertPage(pdfs[2], 0);

        // 保存合併後的PDF文件
        pdf.saveToFile("合併指定頁面.pdf");
    }
}

此示例展示瞭如何從三個不同的 PDF 文件中選取指定頁面，並將它們合併到一個新的 PDF 文件中。insertPage() 方法用於將單個頁面添加到新文檔的指定位置，而 insertPageRange() 則提供了更精細的插入控制。

Java 合併 PDF 文件流

在某些場景下，我們可能需要處理的是 PDF 文件的輸入流（InputStream），而不是直接的文件路徑。Spire.PDF for Java 也支持通過流進行合併操作，這在處理網絡文件或內存中的文件時非常有用。

import com.spire.pdf.*;
import java.io.*;

public class mergePdfsByStream {
    public static void main(String[] args) throws IOException {
        // 為每個PDF文檔創建對應的FileInputStream對象
        FileInputStream stream1 = new FileInputStream(new File("Template_1.pdf"));
        FileInputStream stream2 = new FileInputStream(new File("Template_2.pdf"));
        FileInputStream stream3 = new FileInputStream(new File("Template_3.pdf"));

        // 初始化InputStream數組，統一管理所有文件輸入流
        InputStream[] streams = new FileInputStream[]{stream1, stream2, stream3};

        // 將輸入流合併為單個PdfDocumentBase對象
        PdfDocumentBase pdf = PdfDocument.mergeFiles(streams);

        // 保存合併後的PDF文件
        pdf.save("MergePdfsByStream.pdf", FileFormat.PDF);

        // 釋放合併後文檔佔用的系統資源
        pdf.close();
        pdf.dispose();

        // 關閉所有輸入流，避免資源泄漏
        stream1.close();
        stream2.close();
        stream3.close();
    }
}

此代碼片段演示瞭如何將多個 PDF 文件的 FileInputStream 合併。PdfDocument.mergeFiles() 方法是處理流合併的關鍵，它能夠直接從輸入流中讀取 PDF 數據並進行合併，避免了文件路徑的依賴。

總結

本文詳細介紹瞭如何使用 Spire.PDF for Java 庫在 Java 應用程序中實現 PDF 文件的合併操作。我們探討了三種核心場景：將多個完整 PDF 文件合併為一個、將多個 PDF 中的指定頁面合併為一個新 PDF，以及通過文件流進行 PDF 合併。Spire.PDF for Java 以其強大的功能和簡潔的 API，為 Java 開發者提供了高效、可靠的 PDF 處理解決方案。無論是簡單的文件合併，還是複雜的頁面選取，該庫都能提供靈活的實現方式。希望本教程能幫助您更好地應對 PDF 處理挑戰，提升開發效率。