如何在 Java 中使用 GroupDocs 添加光柵化邊框

在本教學中，您將了解 如何在文件中添加邊框，同時使用 GroupDocs.Redaction for Java 進行進階光柵化。無論是保護法律檔案、醫療記錄或財務報告，添加自訂邊框都有助於突顯已遮蔽區域並保持視覺版面完整。我們將逐步說明設定、所需程式碼以及處理大型文件的效能技巧。

快速答案

  • What does “add border” mean in rasterization? 它在內容光柵化之後於每頁繪製視覺框架，提供明確的視覺提示以標示已遮蔽區域。
  • Which library provides this feature? GroupDocs.Redaction for Java 提供內建的光柵化和邊框選項。
  • Do I need a license? 免費試用可用於評估；正式使用需購買完整授權。
  • Can I process large documents efficiently? 可以 — 啟用光柵化、設定適當的 DPI，並及時關閉 Redactor 以釋放本機記憶體。
  • Is the border color and width configurable? 絕對可以；您可以設定任何顏色，並透過 HashMap 選項使用 set border width java。

什麼是光柵化，為何我要 add border？

光柵化會將文件的每一頁轉換為圖像，當需要完全隱藏底層文字或圖形時非常有用。在光柵化圖像上添加自訂邊框可使遮蔽效果明顯且具專業外觀，特別是在合規性要求高的行業。

Direct answer: 光柵化會將每個 PDF 頁面轉換為位圖，而 add border 選項會在每個位圖頁面周圍繪製矩形框，立即顯示該頁已被遮蔽，同時保留原始版面配置。

前置條件

  • 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 檔案。

取得授權

  • Free Trial: 在未購買的情況下探索 API。
  • Temporary License: 使用限時金鑰進行延長測試。
  • Full License: 正式部署時必須取得完整授權。

基本初始化與設定

首先，匯入您需要的核心類別：

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

現在您已準備好添加自訂邊框。

實作指南

如何使用自訂光柵化選項 add border

載入與準備文件

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. Legal Documents: 在被遮蔽的區段加上明顯邊框，可向審核者顯示合規性。
  2. Medical Records: 隱藏患者資料，同時保留原始版面以供稽核。
  3. Financial Reports: 突顯需進一步審查的部分，且不改變底層資料。

效能考量

  • Memory Management: 完成儲存後立即關閉 Redactor。
  • Batch Processing: 依序處理文件或使用受限併發的執行緒池，以避免記憶體不足錯誤。
  • Monitoring: 記錄處理時間與記憶體使用情況；若效能下降，可調整 borderWidth 或光柵化 DPI。

可量化的效益

GroupDocs.Redaction 支援 60 多種輸入與輸出格式——包括 PDF、DOCX、XLSX、PPTX、HTML 以及常見影像類型——且可在不將整個檔案載入記憶體的情況下光柵化 2000 頁文件，得益於其串流架構。相較於手動影像轉換，對大型批次可提升至 40 % 更快的處理速度。

結論

您現在已了解如何使用 GroupDocs.Redaction for Java 的進階光柵化 add border 文件。此技術提升文件安全性、改善遮蔽內容的可讀性，且能良好擴展至大型文件工作負載。

後續步驟

  • 將邊框邏輯整合至您現有的文件處理流程中。
  • 嘗試其他 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 風格的 API，或將 Java 函式庫嵌入微服務，以建立文件處理後端。

資源

最後更新： 2026-06-06
測試環境： GroupDocs.Redaction 24.9 for Java
作者： GroupDocs

相關教學