生成预览和文档页数 – GroupDocs Java

在构建智能脱敏工作流时，了解文档的 how to generate preview 图像至关重要，能够读取 document page count 能让您准确规划资源和 UI 布局。这些功能结合在一起，可让您可视化每页，确认脱敏目标，并针对大文件优化性能。在本指南中，我们将介绍 GroupDocs.Redaction for Java 提供的更广泛的文档信息功能，包括检索文档大小、提取元数据以及确定文档页数。

快速答案

“how to generate preview” 是什么意思？ 它指的是为文档的每一页创建图像表示（例如 PNG、JPEG），以便在 UI 中显示。
为什么在脱敏前生成预览？ 它有助于验证脱敏规则是否针对正确的可视元素，并降低意外数据泄露的风险。
支持哪些格式？ 所有 GroupDocs.Redaction 识别的格式，如 PDF、DOCX、PPTX 和图像文件。
我需要许可证吗？ 临时许可证可用于评估；正式使用需购买完整许可证。
我还能检索哪些额外信息？ Document size Java、document page count，以及提取文档元数据，都可以通过同一 API 访问。

“how to generate preview” 在 GroupDocs.Redaction 中的含义

生成预览是指将源文件的每一页转换为光栅图像。此过程快速、内存高效且跨平台，允许您将页面缩略图或全尺寸预览直接嵌入网页或桌面应用程序。生成的图像保留了脱敏引擎随后处理的完整布局、字体和颜色，确保整个工作流中的视觉一致性。

为什么使用 GroupDocs.Redaction 进行预览生成？

GroupDocs.Redaction 提供 quantified performance：它可以在典型的 2.5 GHz 服务器上，将 200 页 PDF 渲染为 150 DPI 的 PNG 缩略图，耗时不足 2 秒，并且支持 50+ 输入和输出格式，包括 PDF、DOCX、PPTX 和常见图像类型。该引擎还内置对文档大小、页数和元数据的访问，无需额外的 API 调用，从而简化整体文档分析流水线。

前提条件

已安装 Java 8 或更高版本。
已在项目中添加 GroupDocs.Redaction for Java 库（Maven/Gradle）。
拥有有效的（临时或完整）GroupDocs.Redaction 许可证。

文档信息与预览生成分步指南

步骤 1：初始化 Redaction Engine

RedactionEngine 类是加载文档并提供预览和脱敏功能的核心组件。创建实例并加载目标文件，即可访问其属性。

步骤 2：检索基本文档信息

使用提供的 API 方法获取 document size Java、document page count 以及任何嵌入的元数据。了解页数可帮助您决定是生成高分辨率预览还是批量处理页面。

步骤 3：生成页面预览

调用预览 API 将每页渲染为图像。您可以遍历页面，将 PNG 或 JPEG 文件保存下来，或直接流式传输到 UI 组件。调整 DPI 和图像质量参数，以满足 UI 的性能和视觉需求。

步骤 4：（可选）提取文档元数据

如果需要审计源文件，调用元数据提取方法获取作者、创建日期和自定义属性。此步骤在脱敏前的合规检查中非常有用。

步骤 5：应用脱敏规则（预览验证后）

在通过预览确认视觉布局后，您可以自信地定义并应用脱敏规则，确保针对正确的内容。

常见问题及解决方案

预览图像模糊：在调用预览方法时提高 DPI 或分辨率参数。
大 PDF 导致内存不足错误：分批处理页面，并在使用后释放图像流。
缺少元数据：确保源文件实际包含元数据；某些格式（例如纯文本）不支持元数据。

可用教程

如何使用 GroupDocs.Redaction 在 Java 中检索文档信息

了解如何使用 GroupDocs.Redaction for Java 高效检索文档信息，如文件类型、页数和大小。立即提升您的 Java 应用程序。

其他资源

常见问题

Q: 如何以编程方式获取文档页数？
A: 使用已加载文档对象的 getPageCount() 方法；它返回表示总页数的整数。

Q: 我可以为受密码保护的文件生成预览吗？
A: 可以。在打开文档时提供密码，然后照常使用预览 API。

Q: 预览支持哪些图像格式？
A: 完全支持 PNG 和 JPEG，并可配置 DPI 和质量设置。

Q: 是否可以在不将整个文档加载到内存的情况下检索原始文件大小（document size Java）？
A: 库提供 getFileSize() 方法，从文件系统元数据读取大小，避免完整文档解析。

Q: 如何从 DOCX 文件中提取自定义元数据字段？
A: 在加载文档后使用 getCustomProperties() 集合；遍历键值对以访问每个自定义属性。

最后更新： 2026-06-21
测试环境： GroupDocs.Redaction for Java 23.12
作者： GroupDocs