如何在 Java 中使用 GroupDocs 添加光栅化边框

在本教程中，您将了解 如何添加边框 到文档，同时使用 GroupDocs.Redaction for Java 应用高级光栅化。无论是保护法律文件、医疗记录还是财务报告，添加自定义边框都有助于突出已编辑区域并保持视觉布局完整。我们将逐步演示设置过程、所需的完整代码以及处理大文档的性能技巧。

快速回答

  • “add border” 在光栅化中是什么意思？ 它在内容光栅化后在每页周围绘制一个可视框架，为已编辑区域提供清晰的视觉提示。
  • 哪个库提供此功能？ GroupDocs.Redaction for Java 提供内置的光栅化和边框选项。
  • 我需要许可证吗？ 免费试用可用于评估；生产环境需要完整许可证。
  • 我可以高效处理大型文档吗？ 可以——启用光栅化，设置合适的 DPI，并及时关闭 Redactor 以释放本机内存。
  • 边框颜色和宽度可以配置吗？ 当然；您可以设置任意颜色，并通过 HashMap 选项使用 set border width java。

什么是光栅化，为什么我要 添加边框？

光栅化将文档的每一页转换为图像，这在需要完全隐藏底层文本或图形时非常有用。在光栅化图像之上添加自定义边框，使编辑效果显而易见且专业，尤其在合规性要求严格的行业中。

直接回答： 光栅化将每个 PDF 页面转换为位图，添加边框 选项在每个位图页面周围绘制矩形框，立即表明该页面已被编辑，同时保留原始布局。

前置条件

  • GroupDocs.Redaction for Java 版本 24.9 或更高。
  • 已安装 Java Development Kit (JDK)。
  • 如 IntelliJ IDEA 或 Eclipse 等 IDE。
  • 基本的 Java 知识（类、方法、异常处理）。

设置 GroupDocs.Redaction for Java

Maven 安装

如果您使用 Maven 管理依赖，请在 pom.xml 中添加仓库和依赖：

<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 下载 JAR。

许可证获取

  • 免费试用： 在不购买的情况下探索 API。
  • 临时许可证： 使用限时密钥进行扩展测试。
  • 完整许可证： 生产部署所需。

基本初始化和设置

首先，导入您需要的核心类：

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.options.AdvancedRasterizationOptions;

现在您可以添加自定义边框了。

实现指南

使用自定义光栅化选项添加边框

加载和准备文档

Redactor 类是 GroupDocs.Redaction 的核心引擎，用于在内存中加载、修改和保存文档。

// Load the document you want to process.
final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/MULTIPAGE_SAMPLE_DOCX");

这将创建一个 Redactor 实例，用于管理所有后续操作。

设置保存选项并添加边框

AdvancedRasterizationOptions.Border 属性告诉引擎在每个光栅化页面周围绘制边框。

try {
    // Create SaveOptions and set a suffix for the saved file name.
    SaveOptions so = new SaveOptions();
    so.setRedactedFileSuffix("_scan");

    // Enable rasterization to apply advanced options.
    so.getRasterization().setEnabled(true);

    // Add custom border settings as an advanced option.
    so.getRasterization().addAdvancedOption(
        AdvancedRasterizationOptions.Border,
        new HashMap<String, String>() {
{
            put("borderColor", "black");
            put("borderWidth", "2");
        }
}
    );
    
    redactor.save(so);
} finally {
    redactor.close();
}

关键行解释

  • so.getRasterization().setEnabled(true); 为文档启用光栅化。
  • AdvancedRasterizationOptions.Border 告诉引擎在每个光栅化页面周围绘制边框。
  • HashMap 定义了视觉样式：一个宽度为 2 像素的黑色边框。
  • 您可以通过更改映射中的 borderWidth 条目来 set border width java，例如，将 borderWidth = 4 用于更粗的框架。

故障排除提示

  • 确认文件路径正确；否则会出现 FileNotFoundException。
  • 确保 Maven 坐标与您添加的版本匹配；版本不匹配会导致 NoClassDefFoundError。

为什么在 process large documents java 中使用此方法？

对大型 PDF 进行光栅化可能会消耗大量内存。通过将边框设为高级选项，您让引擎在一次传递中完成绘制，从而减少临时对象数量并加快处理速度。始终如示例所示关闭 Redactor 对象，以及时释放本机资源。

实际应用

  1. 法律文件： 在已编辑部分周围的清晰边框向审阅者表明合规性。
  2. 医疗记录： 隐藏患者数据的同时保留原始布局以供审计。
  3. 财务报告： 突出需要额外审查的部分，而不更改底层数据。

性能考虑因素

  • 内存管理： 完成保存后尽快关闭 Redactor。
  • 批处理： 顺序处理文档或使用受限并发的线程池，以避免内存不足错误。
  • 监控： 记录处理时间和内存使用；如果性能下降，调整 borderWidth 或光栅化 DPI。

量化收益

GroupDocs.Redaction 支持 60+ 输入和输出格式——包括 PDF、DOCX、XLSX、PPTX、HTML 以及常见图像类型——并且能够在不将整个文件加载到内存中的情况下光栅化 2000‑页文档，这归功于其流式架构。相较于手动图像转换，可实现高达 40 % 更快的处理，特别适用于大批量任务。

结论

您现在已经了解 如何添加边框 到文档，使用 GroupDocs.Redaction for Java 的高级光栅化。这一技术提升文档安全性，改善已编辑内容的可读性，并能很好地扩展到大文档工作负载。

下一步

  • 将边框逻辑集成到现有的文档处理流水线中。
  • 尝试其他 AdvancedRasterizationOptions，如水印或自定义 DPI 设置。
  • 查看 GroupDocs.Redaction API 以获取更多编辑功能。

常见问题

Q: 我可以在非 Microsoft Office 文档中使用此功能吗？
A: 可以，GroupDocs.Redaction 支持 PDF、图像以及许多其他格式。

Q: 在光栅化过程中如何处理错误？
A: 将保存逻辑包装在 try‑catch 块中，验证库版本，并再次检查文件路径。

Q: 同时处理的文档数量是否有限制？
A: 没有硬性限制，但顺序处理或受控并发可获得最佳性能。

Q: 能否动态自定义边框颜色和宽度？
A: 完全可以——在调用 save() 之前修改 HashMap 中的 borderColor 和 borderWidth 条目。

Q: 如何将 GroupDocs.Redaction 与其他系统集成？
A: 使用其 REST‑style API，或将 Java 库嵌入微服务，构建文档处理后端。

资源

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

相关教程