如何使用 GroupDocs 在 Java 中塗抹 PDF 並遮蔽敏感資料

在當今快速變化的數位環境中，學習 如何塗抹 PDF 以及 在 Java 中遮蔽敏感資料 已不再是可有可無，而是合規的必要條件。無論您是要準備客戶合約、分享醫療記錄，或是清理內部報告，都需要一種可靠的方式來隱藏個人識別資訊，同時保留原始版面。於本教學中，我們將使用功能強大的 GroupDocs.Redaction Java 函式庫，完整示範整個流程。

快速答覆

  • 「在 Java 中遮蔽敏感資料」是什麼意思？ 它指的是在基於 Java 的文件工作流程中，以程式方式定位並隱藏私人資訊（姓名、身分證號等）。
  • 哪個函式庫負責此功能？ GroupDocs.Redaction for Java。
  • 我需要授權嗎？ 免費試用版非常適合測試；正式環境則需購買完整授權。
  • 我也能塗抹個人資料的 PDF 檔案嗎？ 當然可以——GroupDocs.Redaction 支援 PDF、DOCX、XLSX、PPTX 以及其他多種格式。
  • 需要哪個 Java 版本？ JDK 8 或更高版本。

在 Java 中遮蔽敏感資料是什麼？

在 Java 中遮蔽敏感資料是指使用程式碼在文件內定位特定字串或模式，並以佔位符（例如「[personal]」）取代。此過程確保原始內容無法復原，同時保留文件的視覺完整性。

為何使用 GroupDocs.Redaction 進行遮蔽？

GroupDocs.Redaction 提供完整格式支援，讓 PDF、Word、Excel 與 PowerPoint 檔案無需轉換即可直接塗抹。它支援精確字串匹配（如「John Doe」），並可自訂替換方式，例如文字、黑色方框或圖片，亦內建符合 GDPR、HIPAA 及其他隱私法規的合規範本。

前置條件

  • Java Development Kit (JDK) 8+ 已安裝。
  • IDE（如 IntelliJ IDEA 或 Eclipse）用於除錯。
  • GroupDocs.Redaction for Java（版本 24.9 或更新）。
  • 具備基本的 Java 檔案處理知識。

設定 GroupDocs.Redaction for Java

Maven 設定

將 GroupDocs 儲存庫與相依性加入您的 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>

直接下載

如果您偏好手動管理，可從官方發行頁面下載最新的 JAR 檔案：GroupDocs.Redaction for Java releases。

取得授權

  • 免費試用 – 非常適合評估 API。
  • 臨時授權 – 用於延長測試而無需購買。
  • 完整授權 – 商業部署與無限制塗抹時必須使用。

如何在 Java 中使用 GroupDocs.Redaction 塗抹 PDF

要使用 GroupDocs.Redaction 塗抹 PDF，首先將文件載入 Redactor 實例，接著定義一個或多個塗抹規則（例如 ExactPhraseRedaction），最後使用 SaveOptions 儲存修改後的檔案。此三步工作流程在安全移除敏感內容的同時，保留原始版面。

步驟 1：初始化 Redactor

Redactor 類別是載入並準備文件進行塗抹操作的核心引擎。

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.redactions.ExactPhraseRedaction;
import com.groupdocs.redaction.redactions.ReplacementOptions;

// Load the document from YOUR_DOCUMENT_DIRECTORY
final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx");

步驟 2：定義並套用 Exact‑Phrase Redaction

ExactPhraseRedaction 定義匹配文字字串的規則，而 ReplacementOptions 則指定匹配內容的視覺替換方式。

try {
    // Define the phrase to be redacted and its replacement
    ExactPhraseRedaction redaction = new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]"));
    
    // Apply the redaction to the document
    redactor.apply(redaction);
} finally {
    redactor.close();
}

步驟 3：使用自訂選項儲存已塗抹的文件

SaveOptions 設定輸出參數，例如檔案格式、後綴以及已塗抹文件的點陣化行為。

import com.groupdocs.redaction.options.SaveOptions;
import java.text.SimpleDateFormat;
import java.util.Date;

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx");
try {
    // Define save options for the document
    SaveOptions saveOptions = new SaveOptions();
    
    saveOptions.setAddSuffix(true); // Add a suffix to the saved file name
    saveOptions.setRasterizeToPDF(false); // Do not rasterize content into PDF
    
    // Set a date-based suffix for the redacted file
    String suffix = new SimpleDateFormat("dd-MM-yyyy").format(new Date());
    saveOptions.setRedactedFileSuffix(suffix);
    
    // Save the document with specified options
    redactor.save(saveOptions);
} finally {
    redactor.close();
}

如何有效地套用多重塗抹？

applyAll() 方法會一次性執行所有排隊的 Redaction 規則。當需要套用多個塗抹規則時，可建立 Redaction 物件的清單（包括 ExactPhraseRedaction、RegexRedaction 或 ImageRedaction），並將集合傳入 redactor.applyAll()。此批次處理一次完成所有規則，減少 I/O 操作，顯著提升大批量文件的效能。

實務應用

  1. 法律文件管理 – 在與第三方共享合約前，移除客戶姓名。
  2. 醫療資料處理 – 遮蔽患者識別碼，以符合 HIPAA 規範。
  3. 金融服務 – 在報表中隱藏帳號以供審計。
  4. 人力資源 – 在內部審查時保護員工個人資料。

大檔案效能建議

  • 及時關閉 Redactor 實例 以釋放記憶體。
  • 批次處理 多個文件，使用迴圈並盡可能重複使用單一 Redactor。
  • 監控 CPU 與記憶體 在高負載時；若遇到 OutOfMemoryError，請考慮增大 JVM 堆積大小。

常見問題與解決方案

問題解決方案
未套用塗抹確認精確字串匹配大小寫；如有需要，使用帶有 ignoreCase 選項的 ExactPhraseRedaction。
PDF 輸出為空白確保已設定 setRasterizeToPDF(false)；點陣化會移除可搜尋的文字。
授權錯誤確認試用或完整授權檔案已正確放置，且路徑已透過 License.setLicense("path/to/license.lic") 提供。

常見問答

Q: 如何一次處理多個塗抹？
A: 使用 Redaction 物件的清單，呼叫 redactor.applyAll()。API 會一次性處理所有模式，最小化檔案讀取。

Q: 我能將 GroupDocs.Redaction 整合至其他文件管理系統嗎？
A: 可以，該 API 與平台無關，可從 Web 服務、微服務或桌面應用程式呼叫。

Q: GroupDocs.Redaction 支援哪些檔案格式？
A: 支援 30+ 種格式，包括 DOCX、PDF、XLSX、PPTX、HTML 以及常見影像類型，均可原生處理，無需轉換。

Q: 在塗抹大型文件時，如何管理效能？
A: 使用串流方式讀取輸入檔案，批次作業時重複使用單一 Redactor 實例，並務必及時關閉實例以釋放資源。

Q: 此函式庫能處理受密碼保護的 PDF 嗎？
A: 能——將密碼傳入 Redactor 建構子，引擎會自動解密、塗抹並重新加密檔案。

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

相關教學