to keep bold formatting.

Proceed.

Tables: keep same structure but translate content.

Let’s craft.

在 Java 中使用 GroupDocs.Redaction 对文档进行脱敏时添加文件名后缀

对机密数据进行脱敏只是成功的一半——您还需要确保保存的文件能够清晰地表明已被处理。使用 groupdocs Maven 依赖可以轻松实现，只需几行代码即可为输出文件名添加后缀。在本指南中，您将学习在保存脱敏文档时如何为文件名添加后缀，以及如何使用 GroupDocs.Redaction for Java 进行加载、注释和保存。无论是保护法律合同、医疗记录还是财务报告，这些步骤都能让您的工作流既安全又可审计。

快速回答

“添加文件名后缀”有什么作用？
它会在输出文件名后追加自定义后缀（例如 “_redacted”），从而让您能够立即识别已处理的文件。
我可以从流中加载文档吗？
可以——GroupDocs.Redaction 支持从任意 InputStream 加载，适用于云存储或内存处理。
使用此功能需要许可证吗？
免费试用版可满足基础脱敏需求；临时或正式许可证可解锁所有高级选项，包括后缀处理。
支持哪些格式？
库支持 DOCX、PDF、PPTX、XLSX 等多种格式。
PDF 输出是否必须光栅化？
光栅化是可选的；当您需要将文档扁平化以提升安全性时可启用。

什么是为文件名添加后缀？

为文件名追加后缀是一种简单的命名约定，用于标识文件已完成脱敏。它可以防止意外共享原始未脱敏版本，并帮助自动化流水线跟踪处理状态。

为什么使用 GroupDocs.Redaction 完成此任务？

GroupDocs.Redaction 提供流式的 Java API，能够将脱敏操作与文件处理选项（如 为文件名添加后缀）结合在几行代码内完成。这既节省了开发时间，又降低了手动错误的风险。

前置条件

Java Development Kit (JDK)： 8 版或更高。
GroupDocs.Redaction 库： 用于脱敏任务的核心库。
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 下载最新版本。

许可证获取

免费试用： 可无限制使用基础功能。
临时许可证： 获取临时许可证以体验高级功能。
购买： 长期使用请考虑购买正式许可证。

基本初始化与设置

添加必要的导入语句以初始化项目：

import com.groupdocs.redaction.Redactor;

完成上述设置后，即可开始实现文档脱敏功能。

实现指南

功能 1：从流中加载文档

概述： 了解如何将文档加载到 InputStream 进行处理。

步骤实现

步骤 1.1：创建 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();
    }
}

原因： 使用 InputStream 可以无缝处理存储于各种介质的文档，这在云端或微服务场景下 从流中加载文档 时尤为重要。

功能 2：应用注释删除脱敏

概述： 使用 DeleteAnnotationRedaction 删除文档中的注释。

步骤实现

步骤 2.1：应用 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());
}

原因： 此步骤确保所有敏感注释被移除，提升文档隐私性。

功能 3：使用选项保存文档

概述： 了解如何使用特定选项（如光栅化和 为文件名添加后缀）保存处理后的文档。

步骤实现

步骤 3.1：配置 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());
    }
}

原因： 自定义保存选项可灵活控制输出格式和命名约定。启用 setAddSuffix(true) 会 为文件名添加后缀，明确标识文件已被脱敏。

groupdocs maven 依赖概览

groupdocs maven 依赖 只需在 pom.xml 中添加一个 <dependency> 条目，即可将完整的 Redaction SDK 引入项目。它会自动处理传递依赖、保持库最新，并简化构建自动化。通过声明该依赖，您无需手动管理 JAR 包，也能确保使用最新的安全补丁。

为什么添加后缀很重要

可审计性： 团队可以立即辨别哪些文件可以安全分发。
自动化： 脚本可根据后缀过滤文件，防止误处理原始文档。
合规性： 多项法规要求对已清理的文档进行明确标记。

实际应用场景

探索以下真实业务案例：

法律文档脱敏： 在向客户共享前对合同进行安全处理。
医疗记录处理： 保护患者身份信息。
财务报告： 隐藏敏感数字。
CRM 集成： 导出前自动脱敏客户数据。
协作工具： 确保共享草稿不泄露隐藏评论。

性能考量

性能优化

使用流式方式（load document from stream）避免一次性将整个文件加载到内存。
及时关闭 Redactor 实例以释放资源。

资源使用指南

在批处理期间监控 CPU 与内存使用情况。
处理体积适中的文件时，推荐使用 ByteArrayOutputStream 进行内存保存。

Java 内存管理最佳实践

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

常见问题与解决方案

问题	原因	解决方案
后缀未出现	`setAddSuffix(false)` 或未调用相应方法	确保在 `save()` 前调用 `options.setAddSuffix(true)`。
大 DOCX 导致 OutOfMemoryError	将整个文件加载到内存	切换为 `InputStream` 加载（参见功能 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 获取专家帮助。

资源

文档： 在 GroupDocs Documentation 查看详细指南。
API 参考： 访问 GroupDocs API Reference 获取完整 API 说明。
下载： 前往 GroupDocs Downloads 获取最新版本。
GitHub 仓库： 在 GroupDocs GitHub 贡献代码或浏览源码。

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