如何在 Java 中使用 GroupDocs.Redaction 删除批注

如果您曾经在 PDF、Word 文件或 Excel 表格中删除批注时卡住过，您就会知道手动清理是多么耗时。幸运的是，GroupDocs.Redaction for Java 为您提供了一种编程方式，只需几行代码即可剔除不需要的注释、评论或高亮。本指南将从设置 Maven 依赖到应用基于正则表达式的过滤器，完整演示如何仅删除目标批注。

快速答案

哪个库负责批注删除？ GroupDocs.Redaction for Java。
哪个关键字触发删除？ 您定义的正则表达式模式（例如 (?im:(use|show|describe))）。
需要许可证吗？ 试用版可用于评估；生产环境需要商业许可证。
可以用新名称保存清理后的文件吗？ 可以——使用 SaveOptions.setAddSuffix(true)。
Maven 是唯一的添加方式吗？ 不是，您也可以直接下载 JAR 包。

在 Java 环境中“删除批注”是什么意思？

删除批注是指通过程序定位并移除文档中的标记对象（评论、高亮、便签）。使用 GroupDocs.Redaction，您可以按文本内容定位这些对象，非常适合 data anonymization java 项目、legal document redaction 或任何需要生成干净、可共享文件的工作流。

为什么选择 GroupDocs.Redaction 来删除批注？

精准 – 正则表达式让您精确指定要擦除的批注。
快速 – 批量处理数百个文件，无需手动打开每个文件。
合规 – 确保敏感评论永不离开组织。
跨格式支持 – 支持 PDF、DOCX、XLSX 等多种格式。

前置条件

Java JDK 1.8 或更高版本。
IntelliJ IDEA、Eclipse 等 IDE。
对正则表达式有基本了解。

Maven 依赖 GroupDocs

在 pom.xml 中添加 GroupDocs 仓库和 Redaction 构件：

<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>

直接下载（可选）

如果不想使用 Maven，可从官方页面获取最新 JAR 包：GroupDocs.Redaction for Java releases。

获取许可证的步骤

免费试用 – 下载试用版以体验核心功能。
临时许可证 – 申请临时密钥进行完整功能测试。
购买 – 为生产环境获取商业许可证。

基本初始化与设置

以下代码片段展示了如何创建 Redactor 实例并配置基本的保存选项：

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;

public class InitializeRedaction {
    public static void main(String[] args) throws Exception {
        // Load the document using Redactor
        final Redactor redactor = new Redactor("path/to/your/document");
        
        try {
            // Perform your redaction operations here
            
            // Save options can be customized as needed
            SaveOptions saveOptions = new SaveOptions();
            saveOptions.setAddSuffix(true);  // Example option: Add suffix to filename
            
            // Save the modified document
            redactor.save(saveOptions, "path/to/output/document");
        } finally {
            redactor.close();  // Always close resources to prevent memory leaks
        }
    }
}

删除批注的分步指南

步骤 1：加载文档

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/ANNOTATED_XLSX");

步骤 2：应用基于正则表达式的批注删除

redactor.apply(new DeleteAnnotationRedaction("(?im:(use|show|describe))"));

说明 – 模式 (?im:(use|show|describe)) 为不区分大小写（i）且多行匹配（m），匹配任何包含 use、show 或 describe 的批注。

步骤 3：配置保存选项

SaveOptions saveOptions = new SaveOptions();
saveOptions.setAddSuffix(true);  // Append a suffix to the output filename
saveOptions.setRasterizeToPDF(false);  // Do not convert to PDF format

步骤 4：保存并释放资源

redactor.save(saveOptions, "YOUR_OUTPUT_DIRECTORY/RedactedDocument");
redactor.close();  // Always close the Redactor instance

故障排除提示

确认正则表达式确实匹配您想删除的批注文本。
如果 save 调用抛出 IOException，请再次检查文件系统权限。

删除批注 Java – 常见使用场景

Data Anonymization Java – 在共享数据集前剔除包含个人身份信息的审阅者评论。
Legal Document Redaction – 自动删除可能泄露特权信息的内部批注。
批量处理流水线 – 将上述步骤集成到 CI/CD 作业中，实时清理生成的报告。

保存已编辑文档 – 最佳实践

添加后缀（setAddSuffix(true)）以保留原始文件，同时明确标识已编辑的版本。
除非需要平面 PDF，否则避免光栅化；保持文档原生格式可保留可搜索性。
及时关闭 Redactor，释放本机内存，防止长时间运行的服务出现内存泄漏。

性能考虑

优化正则表达式 – 复杂表达式会增加 CPU 时间，尤其在大型 PDF 上。
仅在处理同类型多文件时复用 Redactor 实例；否则每个文件单独实例化，以保持内存占用低。
性能分析 – 使用 Java 性能分析工具（如 VisualVM）定位批量操作的瓶颈。

常见问题

Q: 什么是 GroupDocs.Redaction for Java？
A: 这是一个 Java 库，能够对多种文档格式进行文本、元数据和批注的编辑。

Q: 如何在一次处理中过滤多个正则表达式？
A: 在单个模式中使用管道符（|）组合，或链式调用多个 DeleteAnnotationRedaction。

Q: 库是否支持非文本格式（如图像）？
A: 支持对基于图像的 PDF 和其他光栅格式进行编辑，但批注删除仅适用于受支持的矢量格式。

Q: 如果我的文档类型未列在支持列表中怎么办？
A: 请查阅最新的 Documentation 以获取更新，或先将文件转换为受支持的格式。

Q: 如何处理编辑过程中的异常？
A: 将编辑逻辑放在 try‑catch 块中，记录异常细节，并确保在 finally 中调用 redactor.close()。

其他资源

最后更新： 2025-12-19
测试环境： GroupDocs.Redaction 24.9 for Java
作者： GroupDocs