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.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,40 +1,42 @@
---
date: '2025-12-29'
description: 了解如何使用 GroupDocs.Redaction for Java 对扫描的文档图像进行编辑。一步一步的指南,涵盖设置、图像区域编辑以及验证
date: '2026-03-22'
description: 了解如何使用 GroupDocs.Redaction Java 扫描图像进行脱敏。本分步指南涵盖设置、图像区域脱敏以及验证
keywords:
- Java image redaction
- GroupDocs.Redaction for Java
- image area redaction
title: 如何使用 GroupDocs 在 Java 中对扫描的文档图像进行脱敏
title: 如何使用 GroupDocs 在 Java 中对扫描图像进行脱敏
type: docs
url: /zh/java/image-redaction/java-image-redaction-groupdocs-tutorial/
weight: 1
---

# 如何使用 GroupDocs Java 中编辑扫描文档图像
# 如何使用 GroupDocs 对扫描图像进行 Java 敏感信息遮盖

在当今的数字环境中,对**编辑扫描文档**图像是保护隐私和满足合规要求的关键。无论您需要在扫描的合同中隐藏个人数据,还是在医学图像中遮蔽患者信息,本教程将向您展示如何使用 **GroupDocs.Redaction for Java** 快速且可靠地**如何编辑图像**内容。我们将从项目设置一直讲解到验证编辑是否成功,帮助您自信地将该解决方案集成到任何 Java 应用程序中
在当今的数字环境中,**redact scanned image java** 对于保护隐私和满足合规要求至关重要。无论是需要在扫描的合同中隐藏个人数据,还是在医学图像中遮盖患者信息,本教程都将展示如何使用 **GroupDocs.Redaction for Java** 快速且可靠地 **redact image** 内容。我们将从项目设置一直讲解到验证遮盖是否成功,帮助你自信地将该方案集成到任何 Java 应用中

## 快速答案
- **什么库在 Java 中处理图像编辑?** GroupDocs.Redaction for Java
- **我可以选择编辑颜色吗?** Yesany `java.awt.Color` (e.g., `Color.BLUE`)
- **生产环境需要许可证吗?** Yes, a valid GroupDocs license is needed
- **原始图像会被覆盖吗?** Noyou save the result to a new file
- **支持的 Java 版本是什么?** Java 8+ (compatible with modern JDKs)
## 快速回答
- **哪个库负责 Java 中的图像遮盖?** GroupDocs.Redaction for Java
- **可以选择遮盖颜色吗?** 可以任意 `java.awt.Color`(例如 `Color.BLUE`
- **生产环境需要许可证吗?** 需要,有效的 GroupDocs 许可证是必需的
- **原始图像会被覆盖吗?** 不会结果会保存为新文件
- **支持的 Java 版本是?** Java 8+(兼容现代 JDK)

## 什么是图像编辑以及为何要编辑扫描文档图像
图像编辑指永久遮蔽敏感的视觉信息——例如姓名、号码或签名——使其无法恢复。处理扫描文档时,数据以像素形式嵌入,这使得传统的文本编辑工具失效。使用 GroupDocs.Redaction 可以精准定位像素区域并用纯色替代,确保信息被真正删除
## 什么是图像遮盖,为什么要在 Java 中遮盖扫描图像
图像遮盖指永久性地模糊敏感的视觉信息——如姓名、号码或签名——使其无法恢复。处理扫描文档时,数据以像素形式嵌入,这使得传统的文本遮盖工具失效。使用 GroupDocs.Redaction 可以精准定位像素区域并用纯色替换,确保信息真正被移除

## 前置条件
- **JDK 8 或更高** 已安装
在开始之前,请确保你已具备:

- **JDK 8 或更高版本** 已安装
- **Maven**(或其他构建工具)用于依赖管理
- 如 **IntelliJ IDEA**、**Eclipse** 或 **NetBeans** IDE
- 基本的 Java 知识以及对文件 I/O 的熟悉
- 如 **IntelliJ IDEA**、**Eclipse** 或 **NetBeans** IDE
- 基础的 Java 知识以及文件 I/O 的基本了解

## 设置 GroupDocs.Redaction for Java

### Maven 设置
在您的 `pom.xml` 中添加 GroupDocs 仓库和依赖:
`pom.xml` 中添加 GroupDocs 仓库和依赖:

```xml
<repositories>
Expand All @@ -60,20 +62,21 @@ weight: 1
### 许可证获取
- **免费试用:** 注册试用以探索 API。
- **临时许可证:** 使用临时密钥进行扩展测试。
- **完整购买:** 获取生产许可证以无限制使用。
- **正式购买:** 获取生产许可证以实现无限制使用。

## 实现指南
我们将实现分为两个核心功能:**图像区域编辑**(实际遮蔽)和**编辑状态检查**(验证成功)。

### 如何编辑扫描文档图像 – 步骤 1:初始化 Redactor
首先,创建指向要处理图像的 `Redactor` 实例。
我们将实现分为两个核心功能:**图像区域遮盖**(实际遮盖)和 **遮盖状态检查**(验证成功)。

### 如何遮盖扫描文档图像 – 步骤 1:初始化 Redactor
首先,创建指向待处理图像的 `Redactor` 实例。

```java
final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_JPG");
```

### 步骤 2:定义编辑参数
指定要隐藏矩形的左上角 (`Point`) 和大小 (`Dimension`)。在本例中我们使用蓝色填充
### 步骤 2:定义遮盖参数
指定要隐藏的矩形左上角 (`Point`) 和尺寸 (`Dimension`)。本例使用蓝色填充

```java
// Define the position on the image where redaction starts.
Expand All @@ -83,8 +86,8 @@ Point samplePoint = new Point(385, 485);
Dimension sampleSize = new Dimension(1793, 2069);
```

### 步骤 3:应用编辑
使用 `RegionReplacementOptions` 创建 `ImageAreaRedaction` 对象并执行。该方法返回 `RedactorChangeLog`,告知操作是否成功
### 步骤 3:应用遮盖
创建带有 `RegionReplacementOptions` `ImageAreaRedaction` 对象并执行。该方法返回 `RedactorChangeLog`,用于指示操作是否成功

```java
RedactorChangeLog result = redactor.apply(
Expand All @@ -98,14 +101,14 @@ if (result.getStatus() != RedactionStatus.Failed) {
```

### 步骤 4:释放资源
完成后务必关闭 `Redactor` 以释放本地资源。
完成后务必关闭 `Redactor`以释放本地资源。

```java
redactor.close();
```

### 如何验证编辑 – 状态检查
应用编辑后,您可以检查 `RedactorChangeLog` 以确认操作未失败。
### 如何验证遮盖 – 状态检查
应用遮盖后,可检查 `RedactorChangeLog` 以确认操作未失败。

```java
if (result != null && result.getStatus() != RedactionStatus.Failed) {
Expand All @@ -115,54 +118,53 @@ if (result != null && result.getStatus() != RedactionStatus.Failed) {
}
```

## 实际应用
- **机密文档处理:** 在与外部方共享之前,自动在扫描的合同中遮蔽个人数据
- **法律文档:** 通过编辑证据图像中的标识符,确保符合 GDPR 或 HIPAA。
- **医疗记录:** 通过遮蔽放射图像中的面部或手写笔记,保护患者隐私。
## 实际应用场景
- **机密文档处理:** 在向外部共享扫描合同前自动遮盖个人数据
- **法律文档:** 通过遮盖证据图像中的标识符,确保符合 GDPR 或 HIPAA。
- **医疗记录:** 通过遮盖放射图像中的面部或手写笔记,保护患者隐私。

## 性能考虑
- **批量处理:** 将图像分小批次加载并编辑,以保持低内存使用
- **高效数据结构:** 在处理大量图像时复用 `Point` `Dimension` 对象。
- **保持更新:** 定期升级到最新的 GroupDocs.Redaction 版本,以获得性能提升和错误修复。
- **批量处理:** 将图像分批加载并遮盖,以保持低内存占用
- **高效数据结构:** 在处理大量图像时复用 `Point` `Dimension` 对象。
- **保持更新:** 定期升级至最新的 GroupDocs.Redaction 版本,以获取性能提升和错误修复。

## 常见问题与解决方案

| 问题 | 原因 | 解决方案 |
|-------|-------|-----|
| **编辑失败,状态为 `Failed`** | 文件路径错误或不支持的图像格式 | 确认图像存在且为支持的格式(JPG、PNG、BMP)。 |
| **输出文件为空** | `redactor.save()` 在编辑完成前被调用 | 确保 `apply()` 在保存前返回成功状态。 |
| **颜色未应用** | 使用了透明颜色 | 选择不透明的 `Color`(例如 `Color.BLACK` 或 `Color.BLUE`)。 |
|------|------|----------|
| **遮盖返回 `Failed` 状态** | 文件路径错误或不支持的图像格式 | 确认图像存在且为支持的格式(JPG、PNG、BMP)。 |
| **输出文件为空** | 在遮盖完成前调用了 `redactor.save()` | 确保 `apply()` 返回成功状态后再保存。 |
| **颜色未生效** | 使用了透明颜色 | 选择不透明的 `Color`( `Color.BLACK` 或 `Color.BLUE`)。 |

## 常见问答

**Q: `ImageAreaRedaction` 与文本编辑有什么区别?**
A: `ImageAreaRedaction` 基于像素坐标工作,而文本编辑会解析 OCR 层以定位并删除文本内容
**Q: `ImageAreaRedaction` 与文本遮盖有什么区别?**
A: `ImageAreaRedaction` 基于像素坐标工作,而文本遮盖会解析 OCR 层以定位并移除文本内容

**Q: 我可以在单个图像中编辑多个区域吗?**
A: 可以——在保存之前,使用不同的 `ImageAreaRedaction` 对象多次调用 `redactor.apply()`。
**Q: 能在单张图像中遮盖多个区域吗?**
A: 可以——在保存之前,对不同的 `ImageAreaRedaction` 对象多次调用 `redactor.apply()`。

**Q: GroupDocs.Redaction 是否支持 TIFF 等其他图像格式?**
A: 该库支持常见的光栅格式(JPG、PNG、BMP、GIF)。对于 TIFF,请先转换为受支持的格式
A: 该库支持常见的光栅格式(JPG、PNG、BMP、GIF)。对于 TIFF,需要先转换为受支持的格式

**Q: 如何为一文件夹的扫描 PDF 自动化编辑?**
A: 遍历从 PDF 中提取的每页图像,应用相同的编辑逻辑,然后使用 PDF 库重新生成 PDF。
**Q: 如何为一个文件夹中的扫描 PDF 自动化遮盖?**
A: 逐页提取 PDF 中的图像,应用相同的遮盖逻辑,然后使用 PDF 库重新生成 PDF。

**Q: 是否有办法在保存前预览编辑效果?**
A: 您可以将 `Redactor` 渲染为 `BufferedImage`,并在 Swing 或 JavaFX 界面中显示,以在提交更改前预览
**Q: 是否可以在保存前预览遮盖效果?**
A: 可以将 `Redactor` 渲染为 `BufferedImage`,并在 Swing 或 JavaFX 界面中显示,以在提交更改前进行预览

## 结论
现在,您已经拥有一份完整、可投入生产的指南,介绍了 **如何编辑图像** 内容,以及使用 GroupDocs.Redaction for Java **编辑扫描文档** 图像的具体方法。按照上述步骤,您可以在各行各业保护敏感的视觉数据。探索其他 API——如文本编辑或 PDF 页面编辑——以为您的组织构建全面的数据隐私解决方案
现在,你已经拥有一套完整的、可投入生产的指南,了解 **how to redact image** 内容以及如何使用 GroupDocs.Redaction for Java **redact scanned image java**。按照上述步骤,你可以在各行业中保护敏感的视觉数据。进一步探索其他 API——如文本遮盖或 PDF 页面遮盖——以构建面向组织的全方位数据隐私解决方案

**资源**
- [文档](https://docs.groupdocs.com/redaction/java/)
- [API 参考](https://reference.groupdocs.com/redaction/java)
- [下载](https://releases.groupdocs.com/redaction/java/)
- [GitHub 仓库](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
- [免费支持论坛](https://forum.groupdocs.com/c/redaction/33)
- [临时许可证](https://purchase.groupdocs.com/temporary-license/)
- [Documentation](https://docs.groupdocs.com/redaction/java/)
- [API Reference](https://reference.groupdocs.com/redaction/java)
- [Download](https://releases.groupdocs.com/redaction/java/)
- [GitHub Repository](https://github.com/groupdocs-redaction/GroupDocs.Redaction-for-Java)
- [Free Support Forum](https://forum.groupdocs.com/c/redaction/33)
- [Temporary License](https://purchase.groupdocs.com/temporary-license/)

---

**最后更新:** 2025-12-29
**最后更新:** 2026-03-22
**测试环境:** GroupDocs.Redaction 24.9 (Java)
**作者:** GroupDocs
**作者:** GroupDocs
Loading
Loading