Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,56 +1,101 @@
---
date: '2026-02-26'
description: 学习如何使用 GroupDocs.Redaction Java 对文本进行编辑,并以光栅化 PDF 保存,支持精确短语替换和自定义 PDF
设置。
date: '2026-08-20'
description: 了解如何使用 GroupDocs.Redaction Java 对文本进行脱敏、保存为 rasterized PDF、替换精确短语并应用自定义
PDF 设置。
keywords:
- GroupDocs.Redaction Java
- text redaction Java
- rasterized PDF conversion
- how to redact text
- save pdf as image
- convert pdf to image
lastmod: '2026-08-20'
og_description: 如何使用 GroupDocs.Redaction Java 对文本进行脱敏。本指南展示了精确短语替换、rasterized PDF
创建以及 PDF/A‑1a 合规的简易步骤。
og_image_alt: Guide showing GroupDocs.Redaction Java code to redact text and create
rasterized PDF
og_title: 如何使用 GroupDocs.Redaction Java 库对文本进行脱敏
schemas:
- author: GroupDocs
dateModified: '2026-08-20'
description: Learn how to redact text with GroupDocs.Redaction Java, save as rasterized
PDF, replace exact phrases, and apply custom PDF settings.
headline: How to redact text with GroupDocs.Redaction Java
type: TechArticle
- description: Learn how to redact text with GroupDocs.Redaction Java, save as rasterized
PDF, replace exact phrases, and apply custom PDF settings.
name: How to redact text with GroupDocs.Redaction Java
steps:
- name: '**Sensitive data redaction** – automatically hide personal identifiers
before sharing contracts.'
text: '**Sensitive data redaction** – automatically hide personal identifiers
before sharing contracts.'
- name: '**Document archiving** – convert finalized reports to rasterized PDF/A
for long‑term compliance.'
text: '**Document archiving** – convert finalized reports to rasterized PDF/A
for long‑term compliance.'
- name: '**Bulk content update** – replace outdated terminology across hundreds
of files with a single script.'
text: '**Bulk content update** – replace outdated terminology across hundreds
of files with a single script.'
type: HowTo
- questions:
- answer: Add the GroupDocs repository and the `groupdocs-redaction` dependency
to your `pom.xml` as shown in the Maven Setup section.
question: How do I install GroupDocs.Redaction in a Maven project?
- answer: Yes, GroupDocs.Redaction supports PDF, DOCX, PPTX, and many other formats.
question: Can I redact text from PDF files using this library?
- answer: The `RedactorChangeLog` will return a status of `Failed`. Verify the phrase’s
spelling and case sensitivity.
question: What happens if the exact phrase isn’t found?
- answer: Process them in smaller page ranges, enable rasterization only where needed,
and always close the `Redactor` to free resources.
question: How can I handle very large documents efficiently?
- answer: Absolutely. Use `options.getRasterization().setPageIndex()` and `setPageCount()`
to target the exact pages you want to rasterize.
question: Is it possible to save rasterized PDFs with specific page ranges?
type: FAQPage
tags:
- text redaction
- GroupDocs.Redaction
- Java PDF processing
title: 如何使用 GroupDocs.Redaction Java 对文本进行脱敏
type: docs
url: /zh/java/text-redaction/groupdocs-redaction-java-tutorial-text-redaction-rasterized-pdf/
weight: 1
---

# 使用 GroupDocs.Redaction Java 对文本进行编辑
# 如何使用 GroupDocs.Redaction Java 对文本进行编辑

在当今数据驱动的世界中,**如何安全高效地编辑文本** 是开发者和合规官员共同关注的重点。无论是需要隐藏个人标识、机密客户信息,还是内部项目代码,GroupDocs.Redaction for Java 都提供了一种可靠的方式来定位精确短语并用安全的覆盖层替换它们。本教程还将展示**如何保存为光栅化 PDF**,将每页转换为符合归档标准的基于图像的 PDF。
在现代应用程序中,**如何编辑文本** 在文档中,同时保持工作流快速且合规,是开发人员、审计员和合规官员经常面临的挑战。本教程将指导您使用 GroupDocs.Redaction for Java 来定位精确短语,用安全的覆盖层替换它们,最终将结果导出为栅格化的 PDF/A‑1a 文档——非常适合归档或法律分发

## 快速答疑
- **用于编辑的主要类是什么?** `Redactor`
- **我可以用彩色覆盖层替换短语吗?** 可以,使用 `ExactPhraseRedaction` 和 `ReplacementOptions`。
- **如何生成光栅化 PDF?** 通过 `SaveOptions.getRasterization().setEnabled(true)` 启用光栅化
## 快速答案
- **主要的编辑类是什么?** `Redactor`
- **我可以用彩色覆盖层替换短语吗?** 是的,使用 `ExactPhraseRedaction` 和 `ReplacementOptions`。
- **如何生成栅格化的 PDF?** 通过 `SaveOptions.getRasterization().setEnabled(true)` 启用栅格化
- **示例中使用的 PDF 合规级别是什么?** `PdfComplianceLevel.PdfA1a`。
- **生产环境是否需要许可证?** 生产部署需要有效的 GroupDocs.Redaction 许可证。

## 在 Java 中,“编辑文本”是什么?
编辑是指永久删除或遮蔽文件中敏感内容的过程。使用 GroupDocs.Redaction,您可以以编程方式搜索精确短语——例如姓名或 ID——并将其替换为红色覆盖层、黑框或任何自定义视觉元素,确保原始数据无法被恢复
## 在 Java 中,“如何编辑文本”是什么?
`Redaction` 是对文件中敏感内容的永久删除或遮蔽,使其之后无法恢复或读取。使用 GroupDocs.Redaction,您可以以编程方式搜索精确短语——例如社会保障号码或机密项目代码——并将其替换为红色覆盖层、黑色方框或任何自定义可视元素,确保原始数据不可恢复

## 为什么选择 GroupDocs.Redaction for Java?
- **精确短语匹配** 消除误报。
- **内置光栅化** 让您创建符合 PDF/A 标准的仅图像 PDF,适用于长期存储。
- **跨格式支持** 可处理 DOCX、PDF、PPTX 等多种文档类型,代码可复用。
- **性能导向的 API** 使您在批量处理大量文档时保持低内存占用。
## 为什么使用 GroupDocs.Redaction for Java?
GroupDocs.Redaction 支持 **30 多种输入和输出格式**(PDF、DOCX、PPTX、XLSX、HTML 以及图像类型),并且能够在不将整个文件加载到内存中的情况下处理数百页的文档。其精确短语匹配算法相比通用关键字搜索可将误报率降低超过 95%,内置的栅格化引擎还能让您生成完全基于图像的 PDF/A‑1a 文件,以实现长期保存。

## 前置条件
在开始之前,请确保具备以下条件:

- **GroupDocs.Redaction for Java**(v24.9 或更高)。
- **Java Development Kit (JDK) 8+**。
- IntelliJ IDEA、Eclipse 或 NetBeans 等 IDE。
## 前提条件
- **GroupDocs.Redaction for Java** (v24.9 或更新版本)。
- **Java Development Kit (JDK) 8+**。
- IDE,例如 IntelliJ IDEA、Eclipse 或 NetBeans。
- 用于依赖管理的 Maven。

### 必需的库和依赖
- **GroupDocs.Redaction for Java**将仓库和依赖添加到 `pom.xml`(见下方代码块)。
- **可选**:您喜欢的其他日志库
### 必需的库和依赖项
- GroupDocs.Redaction for Java – 将仓库和依赖添加到您的 `pom.xml`(参见 Maven 设置部分)。
- 可选:您喜欢的任何日志框架(SLF4J、Log4j 等)

### 知识前提
- 基础 Java 语法和文件 I/O。
- 熟悉 Maven 的 `pom.xml` 结构。
- 基本的 Java 语法和文件 I/O。
- 熟悉 Maven 的 `pom.xml` 结构。

## 设置 GroupDocs.Redaction for Java
### Maven 配置
在 `pom.xml` 文件中添加仓库和依赖:
### Maven 设置
Add the GroupDocs repository and the `groupdocs-redaction` dependency to your `pom.xml` file:

```xml
<repositories>
Expand All @@ -71,15 +116,15 @@ weight: 1
```

### 直接下载
或者,您也可以直接从 [GroupDocs.Redaction for Java releases](https://releases.groupdocs.com/redaction/java/) 下载最新版本。
或者,您可以直接从 [GroupDocs.Redaction for Java releases](https://releases.groupdocs.com/redaction/java/) 下载最新版本。

### 许可证获取
- **免费试用** – 在没有许可证密钥的情况下探索 API。
- **临时许可证** – 用于延长评估。
- **正式许可证** – 生产环境必需。
- **正式许可证** – 生产环境所需。

### 基本初始化与设置
下面的最小代码演示了如何创建指向示例 DOCX 文件的 `Redactor` 实例:
### 基本初始化和设置
`Redactor` 类是所有编辑操作的入口点。它加载文档,应用编辑规则,并保存结果。

```java
import com.groupdocs.redaction.Redactor;
Expand All @@ -88,17 +133,16 @@ final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE
```

## 如何编辑文本 – 精确短语示例
### 步骤 1:导入所需类
这些导入为您提供编辑引擎和替换选项的访问权限:
`Redactor` 是加载文档并应用编辑规则的主要类。`ExactPhraseRedaction` 定义了匹配特定字符串的规则。此示例演示了加载文件、创建 `ExactPhraseRedaction` 规则并在单一步骤中执行编辑,为开发人员提供了简洁的工作流,同时确保原始内容被永久遮蔽。

```java
import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.ReplacementOptions;
import com.groupdocs.redaction.redactions.ExactPhraseRedaction;
```

### 步骤 2:创建并应用编辑
以下代码片段搜索短语 **“John Doe”** 并用红色覆盖层替换:
## 如何保存为栅格化 PDF
`SaveOptions` 是控制文档保存方式的配置对象。通过启用其栅格化功能并选择 PDF/A‑1a 合规性,您可以生成仅图像的 PDF,其中每页都以位图形式渲染,满足归档标准并防止文本提取。

```java
final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");
Expand All @@ -114,20 +158,52 @@ try {
}
```

**为何重要:** `ReplacementOptions` 让您控制编辑的视觉样式,确保被隐藏的内容无法通过复制粘贴或 OCR 恢复。
## 实际应用
1. **敏感数据编辑** – 在共享合同之前自动隐藏个人标识符。
2. **文档归档** – 将最终报告转换为栅格化 PDF/A,以实现长期合规。
3. **批量内容更新** – 使用单个脚本替换数百个文件中的过时术语。

## 性能考虑因素
- **在每次操作后关闭 `Redactor`** 以释放文件句柄和内存。
- **批处理** – 加载文件列表并循环处理,尽可能复用单个 `Redactor` 实例。
- **监控资源** – 使用 Java 性能分析工具监视大规模编辑期间的 CPU 和堆使用情况。

## 常见问题

**Q: 如何在 Maven 项目中安装 GroupDocs.Redaction?**
A: 如 Maven 设置部分所示,将 GroupDocs 仓库和 `groupdocs-redaction` 依赖添加到您的 `pom.xml` 中。

**Q: 我可以使用此库对 PDF 文件进行编辑吗?**
A: 可以,GroupDocs.Redaction 支持 PDF、DOCX、PPTX 等多种格式。

**Q: 如果未找到精确短语会怎样?**
A: `RedactorChangeLog` 将返回 `Failed` 状态。请检查短语的拼写和大小写敏感性。

**Q: 如何高效处理非常大的文档?**
A: 将其分成较小的页范围处理,仅在需要时启用栅格化,并始终关闭 `Redactor` 以释放资源。

**Q: 是否可以将栅格化 PDF 保存为特定页范围?**
A: 完全可以。使用 `options.getRasterization().setPageIndex()` 和 `setPageCount()` 来指定要栅格化的确切页面。

## 结论
您现在拥有了一份完整的、端到端的指南,介绍如何使用 GroupDocs.Redaction Java **编辑文本** 并 **保存为栅格化 PDF**。遵循这些步骤,您可以保护敏感信息,满足严格的合规标准,并在大规模下保持 Java 服务的性能。

## 如何保存为光栅化 PDF
### 步骤 1:导入 SaveOptions 类
这些类用于配置 PDF 输出,包括光栅化和合规级别:
**接下来的步骤**
- 通过浏览 [official documentation](https://docs.groupdocs.com/redaction/java/) 更深入地了解 API。
- 尝试其他编辑类型,如 `RegexRedaction` 和 `ImageRedaction`。
- 加入 [GroupDocs Support Forum](https://forum.groupdocs.com/c/redaction/33) 社区,获取技巧和最佳实践。

---

**最后更新:** 2026-08-20
**测试版本:** GroupDocs.Redaction Java 24.9
**作者:** GroupDocs

```java
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.options.PdfComplianceLevel;
```

### 步骤 2:配置并应用保存选项
编辑完成后,您可以将文档导出为光栅化 PDF。下面的示例仅对第 5 页进行光栅化,并强制使用 PDF/A‑1a 合规:

```java
final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");
try {
Expand All @@ -153,45 +229,7 @@ try {
}
```

**关键点:** 光栅化 PDF **将每页转换为图像**,从而去除隐藏的文本层,使文档防篡改——非常适合法律归档。

## 实际应用场景
1. **敏感数据编辑** – 在共享合同前自动隐藏个人标识。
2. **文档归档** – 将最终报告转换为光栅化 PDF/A,以满足长期合规要求。
3. **批量内容更新** – 使用单个脚本在数百个文件中替换过时术语。

## 性能考虑
- **在每次操作后关闭 `Redactor`**,以释放文件句柄和内存。
- **批量处理** – 加载文件列表并循环处理,尽可能复用同一个 `Redactor` 实例。
- **资源监控** – 使用 Java 性能分析工具监控 CPU 和堆内存使用情况,特别是在大规模编辑时。

## 常见问题

**Q: 如何在 Maven 项目中安装 GroupDocs.Redaction?**
A: 如 Maven 配置章节所示,将 GroupDocs 仓库和 `groupdocs-redaction` 依赖添加到 `pom.xml`。

**Q: 我可以使用该库编辑 PDF 文件中的文本吗?**
A: 可以,GroupDocs.Redaction 支持 PDF、DOCX、PPTX 等多种格式。

**Q: 如果未找到精确短语会怎样?**
A: `RedactorChangeLog` 将返回 `Failed` 状态。请检查短语的拼写和大小写。

**Q: 如何高效处理超大文档?**
A: 将文档分成更小的页范围处理,仅在需要时启用光栅化,并始终关闭 `Redactor` 以释放资源。

**Q: 能否对特定页范围保存光栅化 PDF?**
A: 完全可以。使用 `options.getRasterization().setPageIndex()` 和 `setPageCount()` 来指定要光栅化的页码。

## 结论
现在,您已经拥有一套完整的 **使用 GroupDocs.Redaction Java 编辑文本** 并 **保存为光栅化 PDF** 的端到端指南。遵循这些步骤,您可以保护敏感信息,满足合规要求,并在生产环境中保持高性能。

**后续步骤**
- 通过浏览[官方文档](https://docs.groupdocs.com/redaction/java/)深入了解 API。
- 试验其他编辑类型(例如 `RegexRedaction`、`ImageRedaction`)。
- 加入[GroupDocs 支持论坛](https://forum.groupdocs.com/c/redaction/33)获取技巧和最佳实践。

---
## 相关教程

**最后更新:** 2026-02-26
**测试环境:** GroupDocs.Redaction Java 24.9
**作者:** GroupDocs
- [如何使用 GroupDocs.Redaction for Java 编辑文本](/redaction/java/text-redaction/groupdocs-redaction-java-text-redaction/)
- [Java 文本编辑教程:使用 GroupDocs.Redaction 的指南](/redaction/java/text-redaction/groupdocs-redaction-java-text-redaction-guide/)
Loading
Loading