概述

对于从事文档处理的开发者来说，合并 PDF 文件是一个常见的需求。在这篇博文中，我们将探讨如何使用 GroupDocs.Merger for Node.js via Java 将多个 PDF 文件合并为一个文档。这个库允许您编程方式合并 PDF 文件，而无需任何第三方软件，从而简化了工作流程并提高了生产力。

在我们的逐步指南中，您将学习如何：

  • 用源 PDF 文件初始化合并类。
  • 将其他 PDF 文件添加到合并中。
  • 保存合并后的 PDF 文件。

如何在 Node.js 中合并 PDF 文件

要在 Node.js 中合并 PDF 文件，您首先需要使用源 PDF 文件的路径实例化 Merger 类。之后，您可以添加其他要包括在合并文档中的 PDF 文件，最后保存结果 PDF 文件。

合并 PDF 文件的步骤：

  1. 加载源 PDF 文件 - 使用第一个 PDF 的路径创建 Merger 类的实例。
  2. 添加其他 PDF 文件 - 使用 join 方法将其他 PDF 文件包含在合并中。
  3. 保存合并后的 PDF 文件 - 调用 save 方法将最终合并文档输出到所需位置。

以下是演示这些步骤的示例代码片段：

// 导入 GroupDocs.Merger for Node.js 库
const GroupDocs = require("groupdocs-merger");

// 合并 PDF 文件的函数
async function mergePdf(groupdocs, inputFilePath) {
    // 使用源 PDF 文件创建新的 Merger 实例
    const merger = new groupdocs.merger.Merger(inputFilePath);
    
    // 定义合并 PDF 的输出文件路径
    const outputPath = `${groupdocs.outputFolder}/MergePdf.pdf`;
    
    console.log(`合并到 ${outputPath}`);
    
    // 添加另一个 PDF 文件进行合并
    merger.join("path/to/your/secondPDF.pdf");
    
    // 将合并后的 PDF 保存到指定的输出路径
    await merger.save(outputPath);
}

// 示例用法
mergePdf(GroupDocs, "path/to/your/firstPDF.pdf");

合并 PDF 的代码示例

在上述代码示例中，我们执行以下主要步骤：

  • 导入必要的库：此步骤确保 GroupDocs.Merger 可用于您的应用程序。
  • 实例化 Merger 类：第一个 PDF 文件的路径被传递给 Merger 构造函数以初始化合并过程。
  • 加入其他 PDF：使用 join 方法连接每个额外的 PDF 文件。此方法允许您将多个 PDF 文档合并为一个文件。
  • 保存最终文档：通过调用 save 方法，我们将新的合并 PDF 写入磁盘。

在合并 PDF 时使用书签

如果您希望在合并的 PDF 中保留书签，您可以通过使用某些选项来配置合并过程以包括此功能。

下面的示例演示如何在保留书签的同时合并 PDF 文件：

// 导入 GroupDocs.Merger for Node.js 库
const GroupDocs = require("groupdocs-merger");

// 合并带书签的 PDF 的函数
async function mergePdfWithBookmarks(groupdocs, inputFilePath) {
    // 创建新的 Merger 实例
    const merger = new groupdocs.merger.Merger(inputFilePath);
    
    // 定义输出文件路径
    const outputPath = `${groupdocs.outputFolder}/MergePdfWithBookmarks.pdf`;
    
    // 创建使用书签的选项
    const pdfJoinOptions = {
        useBookmarks: true // 启用书签
    };

    console.log(`合并到 ${outputPath}`);
    
    // 添加带书签的第二个 PDF
    merger.join("path/to/your/secondPDF.pdf", pdfJoinOptions);
    
    // 将合并后的 PDF 保存到指定的输出路径
    await merger.save(outputPath);
}

// 示例用法
mergePdfWithBookmarks(GroupDocs, "path/to/your/firstPDF.pdf");

在此更新的示例中，我们指定选项以保留合并 PDF 时的书签。添加 useBookmarks: true 确保原始文件中的书签被保留在合并文档中。

结论

使用 GroupDocs.Merger for Node.js via Java 在 Node.js 中合并 PDF 文件是一个简单的过程，可以显著简化您的文档管理任务。无论您是需要将各种文档组合在一起以进行报告，还是作为单个附件发送多个文件，该库都提供了以编程方式执行这些任务所需的工具，而无需第三方软件。

另见

别忘了，您可以从 releases.groupdocs.com 下载免费试用，并在 这里 获取临时许可证。临时许可证允许您在没有任何限制的情况下尝试我们的库。

示例

为了方便您理解如何使用 GroupDocs.Merger for Node.js via Java 合并 PDF 文件，这里有几个实际示例，展示了该库的功能。

基本 PDF 合并示例

在此示例中，我们将合并两个简单的 PDF 文件为一个。

// 导入 GroupDocs.Merger for Node.js 库
const GroupDocs = require("groupdocs-merger");

// 合并两个 PDF 文件的函数
async function mergeTwoPdfFiles(groupdocs) {
    // 定义源 PDF 文件的路径
    const firstPdfPath = "path/to/your/firstPDF.pdf";
    const secondPdfPath = "path/to/your/secondPDF.pdf";
    
    // 为第一个 PDF 创建新的 Merger 实例
    const merger = new groupdocs.merger.Merger(firstPdfPath);
    
    // 将第二个 PDF 合并到第一个 PDF 中
    merger.join(secondPdfPath);
    
    // 定义合并 PDF 的输出路径
    const outputPath = `${groupdocs.outputFolder}/MergedTwoPdfFiles.pdf`;
    
    // 将结果保存到指定的输出路径
    await merger.save(outputPath);
    console.log(`合并文件已保存到：${outputPath}`);
}

// 示例用法
mergeTwoPdfFiles(GroupDocs);

合并多个文件的示例

在这种情况下，我们将三个 PDF 文件合并为一个文档。

// 导入 GroupDocs.Merger for Node.js 库
const GroupDocs = require("groupdocs-merger");

// 合并多个 PDF 文件的函数
async function mergeMultiplePdfFiles(groupdocs) {
    // 定义源 PDF 文件的路径
    const pdfPaths = [
        "path/to/your/firstPDF.pdf",
        "path/to/your/secondPDF.pdf",
        "path/to/your/thirdPDF.pdf"
    ];
    
    // 用第一个 PDF 创建新的 Merger 实例
    const merger = new groupdocs.merger.Merger(pdfPaths[0]);
    
    // 循环合并所有额外的 PDF
    for (let i = 1; i < pdfPaths.length; i++) {
        await merger.join(pdfPaths[i]);
    }
    
    // 定义合并 PDF 的输出路径
    const outputPath = `${groupdocs.outputFolder}/MergedMultiplePdfFiles.pdf`;
    
    // 将结果保存到指定的输出路径
    await merger.save(outputPath);
    console.log(`多个文件已合并到：${outputPath}`);
}

// 示例用法
mergeMultiplePdfFiles(GroupDocs);

这些示例向您展示了如何高效地使用 GroupDocs.Merger for Node.js via Java 合并一个或多个 PDF 文档。该库的灵活性允许开发者根据具体需求自定义合并过程。

另见

免费试用下载和临时许可证信息

您可以通过从 releases.groupdocs.com 下载免费试用来开始使用 GroupDocs.Merger for Node.js via Java。免费试用允许您在没有限制的情况下探索库的功能。

如果您希望在没有限制的情况下测试该库，您可以通过访问 此链接 获取临时许可证。临时许可证使您能够在评估期间充分利用我们的库。