在 Java 中使用 GroupDocs.Redaction 替换 PDF 文本

在现代企业应用中，您经常需要 replace text in pdf java 文件，以在共享之前保护敏感信息。本教程将指导您如何为 Java 设置 GroupDocs.Redaction，创建精确短语的遮蔽，处理阿拉伯语等从右到左的语言，并提供性能方面的最佳实践技巧。完成后，您将能够在 PDF 中将特定短语替换为自定义占位符——非常适用于法律、金融或政府文件。

快速答案

  • 哪个库可以让您在 PDF Java 中替换文本？ GroupDocs.Redaction for Java.
  • 哪个方法执行精确短语替换？ ExactPhraseRedaction with ReplacementOptions.
  • 我需要对阿拉伯文进行特殊处理吗？ Yes—set setRightToLeft(true) on the redaction object.
  • 我可以在一次运行中处理多个 PDF 吗？ Absolutely, by reusing the Redactor instance in a loop.
  • 生产环境是否需要许可证？ A trial license works for evaluation; a paid license is needed for production use.

什么是 “replace text in pdf java”？

在 Java 中替换 PDF 文件中的文本是指以编程方式定位 PDF 内的特定字符串并将其替换为新内容（或进行遮蔽）。GroupDocs.Redaction 提供了高级 API，抽象掉低层的 PDF 解析，使任务可靠且快速。

为什么在精确短语替换中使用 GroupDocs.Redaction？

  • 准确性： 找到精确短语，尊重大小写和文字方向。
  • RTL 支持： 内置对从右到左语言（阿拉伯语、希伯来语）的处理。
  • 性能： 针对大型文档和批处理进行优化。
  • 合规性： 开箱即满足 GDPR、HIPAA 等隐私法规。

前提条件

  • Java 开发工具包 (JDK)： 8 版或更高。
  • GroupDocs.Redaction for Java 库： 版本 24.9（示例中使用）。
  • IDE： IntelliJ IDEA、Eclipse 或任何兼容 Java 的 IDE。

必需的库、版本和依赖项

我们将使用 Maven 管理依赖。请按如下方式添加仓库和依赖：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/redaction/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-redaction</artifactId>
      <version>24.9</version>
   </dependency>
</dependencies>

或者，直接从 GroupDocs.Redaction for Java releases 下载库。

许可证获取

GroupDocs 提供免费试用许可证。有关许可证选项的更多信息，请访问其 purchase page.

为 Java 设置 GroupDocs.Redaction

让我们准备好您的环境：

  1. 添加 Maven 依赖（如上所示）或手动包含 JAR。
  2. 初始化 Redactor 实例，并提供要编辑的 PDF 路径。
import com.groupdocs.redaction.Redactor;

try {
    final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/ARABIC_PDF");
} catch (Exception e) {
    e.printStackTrace();
}

现在您已准备好在 PDF Java 文件中替换文本。

步骤实施指南

步骤 1：导入所需类

这些类允许您定义精确短语遮蔽并指定替换选项。

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.redactions.ExactPhraseRedaction;
import com.groupdocs.redaction.redactions.ReplacementOptions;

步骤 2：初始化 Redactor

加载目标 PDF 文档。（相同的代码在前面出现；此处保留以阐明流程。）

try {
    final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/ARABIC_PDF");
} catch (Exception e) {
    e.printStackTrace();
}

步骤 3：创建精确短语遮蔽

定义您想要替换的短语以及应显示的替换文本。

// Create an ExactPhraseRedaction for the specified phrase "أﺑﺠﺪ" and replace it with "[test]".
ExactPhraseRedaction red = new ExactPhraseRedaction("أﺑﺠﺪ", new ReplacementOptions("[test]"));

步骤 4：配置从右到左的遮蔽

阿拉伯语和其他 RTL 脚本需要特殊处理，以确保搜索正确工作。

// Set the redaction to apply from right to left.
red.setRightToLeft(true);

步骤 5：应用遮蔽并保存结果

执行遮蔽并将更新后的 PDF 写入新文件。

try {
    // Apply the redaction on the document.
    redactor.apply(red);

    // Save the changes to a new file in your output directory.
    redactor.save("YOUR_OUTPUT_DIRECTORY/redacted_output.pdf");
} finally {
    // Close the Redactor resource to free up any system resources.
    redactor.close();
}

实际应用

精确短语替换在许多实际场景中非常有用：

  1. 法律文件： 在共享草稿前隐藏客户姓名或案件编号。
  2. 财务报告： 掩码账户号码、社会安全号码或信用卡信息。
  3. 政府记录： 删除个人身份信息（PII），以符合隐私法要求。

性能考虑

在处理大型 PDF 时保持应用响应性：

  • 优化内存使用： 完成后尽快关闭 Redactor。
  • 批处理： 使用单个 Redactor 实例循环处理文件列表。
  • 监控资源： 使用 Java 性能分析工具（如 VisualVM）监视 CPU 和堆内存使用情况。

常见问题与解决方案

  • 未找到短语： 验证确切的 Unicode 字符，并确保对 RTL 语言设置了 setRightToLeft(true)。
  • 许可证错误： 在调用任何 API 方法之前，请确保已应用有效的试用或付费许可证。
  • 大型 PDF 内存不足： 增加 JVM 堆大小（-Xmx），或在可能的情况下将文档分成更小的块处理。

常见问答

问：我可以在一次操作中应用多个精确短语遮蔽吗？
答：是的。创建额外的 ExactPhraseRedaction 对象，并在保存之前将它们全部传递给 redactor.apply()。

问：GroupDocs.Redaction 能处理包含文本的图像吗？
答：它可以遮蔽图像元数据，但对于嵌入图像中的文本，需要先进行 OCR 预处理。

问：我如何在遮蔽之前保护受密码保护的 PDF？
答：使用相应的 Redactor 构造函数重载并提供密码打开文档，然后像往常一样应用遮蔽。

问：每个文档的遮蔽数量有限制吗？
答：没有硬性限制，但数量非常大可能影响性能；请合理批量处理。

问：在哪里可以找到更高级的遮蔽选项？
答：请查看官方 API 参考，了解基于正则表达式的遮蔽、元数据删除和图像遮蔽功能。

资源

如有进一步问题，欢迎在支持论坛上联系或查阅更详细的文档。祝编码愉快！

最后更新： 2026-04-26
测试环境： GroupDocs.Redaction 24.9 for Java
作者： GroupDocs