如何在 GroupDocs Redaction Java 中为文件名添加后缀

在本 groupdocs redaction java tutorial 中,您将学习在使用 GroupDocs.Redaction 对文档进行脱敏时,如何自动在输出文件名后追加后缀。添加后缀可消除手动重命名的需求,降低泄露未脱敏文件的风险,并且可以无缝集成到依赖命名约定的 CI/CD 流程中。本文指南将带您完成 Maven 配置、流式文档加载、注释删除以及保存选项配置——全部使用简洁的生产级代码。

快速回答

  • “add suffix to filename” 是什么作用?
    启用后缀选项后,SDK 会在输出文件的基础名称(扩展名前)自动追加预定义字符串(默认 “_redacted”)。这能立刻表明文件已被处理,帮助防止意外分发原始内容,并简化依赖命名模式的下游自动化流程。
  • 我可以从流中加载文档吗?
    可以——GroupDocs.Redaction 支持从任意 InputStream 加载,适用于云存储或内存处理。
  • 使用此功能需要许可证吗?
    免费试用可满足基本脱敏需求;临时或正式许可证可解锁包括后缀处理在内的全部高级选项。
  • 支持哪些格式?
    该库支持 DOCX、PDF、PPTX、XLSX 等多种格式。
  • PDF 输出是否必须光栅化?
    光栅化是可选的;在需要将文档扁平化以提升安全性时启用即可。

“add suffix to filename” 是什么作用?

启用后缀选项后,SDK 会在输出文件的基础名称(扩展名前)自动追加预定义字符串(默认 “_redacted”)。这能立刻表明文件已被处理,帮助防止意外分发原始内容,并简化依赖命名模式的下游自动化流程。

为什么在此任务中使用 GroupDocs.Redaction?

GroupDocs.Redaction 提供高性能的 Java API,将脱敏操作与灵活的文件处理选项(如自动添加后缀、流式支持和批处理)相结合。它支持超过 50 种输入和输出格式,能够在不将整个文件加载到内存的情况下处理上百页的文档,确保低内存占用和快速执行。

前置条件

  • Java Development Kit (JDK): 8 版或更高。
  • GroupDocs.Redaction Library: 用于脱敏任务的核心库。
  • IDE: IntelliJ IDEA、Eclipse 或任意支持 Java 的编辑器。
  • Maven: 用于依赖管理。

知识前置条件

熟悉 Java I/O 和基本面向对象概念会使示例更易于理解。

为 Java 设置 GroupDocs.Redaction

Maven 配置

在 pom.xml 文件中加入以下配置,以通过 Maven 获取 GroupDocs 库:

<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 下载最新版本。

许可证获取

  1. Free trial: 在不受限制的情况下访问基本功能。
  2. Temporary license: 获取临时许可证以探索高级特性。
  3. Purchase: 长期使用请考虑购买正式许可证。

基本初始化和设置

通过添加必要的导入来初始化项目:

import com.groupdocs.redaction.Redactor;

完成上述设置后,您即可实现文档脱敏功能。

实现指南

Feature 1: load document from stream

Overview: 学习如何将文档加载到 InputStream 中进行处理。

InputStream 是 Java I/O 类,表示字节流,允许您从文件、网络连接或其他来源读取数据,而无需将整个内容加载到内存中。

Step 1.1: create inputstream

import java.io.FileInputStream;
import java.io.InputStream;

try (InputStream stream = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    final Redactor redactor = new Redactor(stream);
    try {
        // Document is now loaded and ready for further processing
    } finally {
        redactor.close();
    }
}
  • Why: 使用 InputStream 可处理存放在云存储桶、数据库或内存缓冲区等各种位置的文档,而无需先写入磁盘。这在微服务架构中需要 load document from stream 时尤为关键。

Feature 2: apply annotation deletion redaction

Overview: 使用 DeleteAnnotationRedaction 删除文档中的注释。

DeleteAnnotationRedaction 是一种脱敏操作,可移除文档中的所有注释——包括评论、高亮和批注。

Step 2.1: apply deleteannotationredaction

import com.groupdocs.redaction.redactions.DeleteAnnotationRedaction;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply the DeleteAnnotationRedaction to remove annotations from the document
    redactor.apply(new DeleteAnnotationRedaction());
}
  • Why: 此步骤确保任何敏感注释(评论、高亮或隐藏批注)被从文档中剔除,提升隐私和合规性。

Feature 3: save document with options

Overview: 学习如何使用光栅化和 add suffix filename java 等特定选项保存处理后的文档。

SaveOptions 封装了控制脱敏文档写入方式的设置,包括格式、光栅化以及命名约定。

Step 3.1: configure saveoptions

import java.io.ByteArrayOutputStream;
import com.groupdocs.redaction.options.SaveOptions;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply necessary redactions before saving
    redactor.apply(new DeleteAnnotationRedaction());
    try (ByteArrayOutputStream bA = new ByteArrayOutputStream()) {
        SaveOptions options = new SaveOptions();
        options.setRasterizeToPDF(true);  // Option to rasterize document to PDF format
        options.setAddSuffix(true);      // Option to add a suffix to the saved file name
        redactor.save(bA, options.getRasterization());
    }
}
  • Why: 自定义保存选项可实现灵活的输出格式和命名约定。启用 setAddSuffix(true) adds suffix to filename,使文件已脱敏一目了然。

如何在保存文档时为文件名添加后缀?

Redactor 类是加载文档并执行脱敏操作的核心组件。SaveOptions 定义了脱敏文档的保存方式,包括格式、光栅化和命名约定。创建 Redactor 实例,应用所需的脱敏操作,然后使用 setAddSuffix(true) 配置 SaveOptions 对象。调用 redactor.save(outputPath, options) 时,SDK 会自动在文件名后追加 “_redacted”(或自定义后缀),无需手动重命名。

GroupDocs Maven 依赖概览

groupdocs maven dependency 通过单个 <dependency> 条目将整个 Redaction SDK 引入项目,处理传递依赖、保持库最新,并简化构建自动化。将依赖声明在 pom.xml 中,可避免手动管理 JAR 并确保兼容最新安全补丁。

为什么添加后缀很重要

添加后缀可立即提供文件已被处理的视觉确认,这对审计追踪、自动化工作流和合规性至关重要。它使脚本能够过滤脱敏文件,防止原始内容意外分发,并满足许多行业标准对已清理文档的明确标记要求。

实际应用场景

  1. Legal document redaction: 在向客户共享前安全处理合同。
  2. Medical record handling: 保护患者身份信息,同时保留临床数据。
  3. Financial reporting: 在外部审计期间保密敏感数字。
  4. CRM integration: 在导出至第三方工具前自动脱敏客户数据。
  5. Collaboration tools: 确保共享草稿不泄露隐藏评论或元数据。

性能考虑

优化性能

  • 使用流式(load document from stream)避免将整个文件加载到内存。
  • 及时关闭 Redactor 实例以释放资源。

资源使用指南

  • 在批量运行时监控 CPU 和内存。
  • 处理较小文件时,使用 ByteArrayOutputStream 进行内存保存。

Java 内存管理最佳实践

  • 在处理同类型多个文件时复用 Redactor 对象。
  • 在 try‑with‑resources 块中调用 close(),防止泄漏。

常见问题及解决方案

问题原因解决方案
后缀未出现setAddSuffix(false) 或缺少调用确保在 save() 前设置 options.setAddSuffix(true)。
大型 DOCX 导致 OutOfMemoryError将整个文件加载到内存切换为 InputStream 加载(参见 Feature 1)。
注释仍然可见保存前未应用脱敏在 save() 前调用 redactor.apply(new DeleteAnnotationRedaction())。
PDF 未进行光栅化setRasterizeToPDF(false) 或遗漏设置需要扁平化 PDF 时设置 options.setRasterizeToPDF(true)。

常见问答

Q:我可以使用 GroupDocs.Redaction 脱敏 PDF 文档吗?
A:可以,库支持 PDF、DOCX、PPTX、XLSX 等多种格式。

Q:处理大文件的最佳方式是什么?
A:使用流式(load document from stream)并及时关闭资源,以保持低内存占用。

Q:可以自定义后缀文本吗?
A:API 会自动添加默认后缀(如 “_redacted”)。如需自定义后缀,请在保存后自行重命名输出文件。

Q:如何获取 GroupDocs.Redaction 的临时许可证?
A:访问 Temporary License page 并按照说明操作。

Q:遇到问题时可以在哪里获得帮助?
A:加入 GroupDocs Support Forum 获取专家支持。

资源


最后更新: 2026-11-02
测试版本: GroupDocs.Redaction 24.9 for Java
作者: GroupDocs

相关教程