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

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

快速解答

• 「add border」在光柵化中是什麼意思？ 它會在內容光柵化後，於每一頁繪製視覺框線。
• 哪個函式庫提供此功能？ GroupDocs.Redaction for Java。
• 我需要授權嗎？ 免費試用可用於評估；正式環境需購買完整授權。
• 我能有效處理大型文件嗎？ 可以 — 啟用光柵化並及時關閉 Redactor，以釋放記憶體。
• 邊框顏色可以自訂嗎？ 當然可以；您可以透過 HashMap 來設定任意顏色與寬度。

什麼是光柵化，為什麼我要 添加邊框？

光柵化會將文件的每一頁轉換為影像，當您需要徹底隱藏底層文字或圖形時非常有用。在光柵化影像上加上自訂邊框，可讓編輯區域顯而易見且具專業外觀，特別是在合規性要求嚴格的產業中。

前置條件

• 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;

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

實作指南

如何使用自訂光柵化選項添加邊框

載入與準備文件

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

此程式碼會建立一個 Redactor 實例，用以管理後續的所有操作。

設定儲存選項並加入邊框

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 像素的黑色邊框。

疑難排解提示

• 確認檔案路徑正確，否則會拋出 FileNotFoundException。
• 確認 Maven 坐標與您加入的版本相符；版本不匹配會導致 NoClassDefFoundError。

為什麼在 process large documents java 中使用此方法？

對大型 PDF 進行光柵化可能會佔用大量記憶體。透過將邊框設為進階選項，讓引擎在單一次處理中完成繪製，可減少暫存物件數量並提升處理速度。務必如範例所示即時關閉 Redactor 物件，以釋放原生資源。

實務應用

1. 法律文件： 在已編輯區段加上明顯邊框，可向審核者傳達合規訊號。
2. 醫療紀錄： 隱藏患者資料的同時，保留原始版面以供稽核。
3. 財務報告： 突顯需進一步審查的區段，且不會改變底層資料。

效能考量

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

結論

您現在已掌握使用 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 風格的 API，或將 Java 函式庫嵌入微服務，以建立文件處理後端。

資源

• GroupDocs.Redaction Documentation
• API Reference
• Download Latest Version
• GitHub Repository
• Free Support Forum
• Temporary License

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