使用 GroupDocs.Redaction 的 Java 自訂格式處理程式實作

在當今資料驅動的環境中，保護敏感資訊是絕對不可妥協的需求。實作自訂格式處理程式於 Java 可讓您彈性處理任何檔案類型——無論是法律合約、財務報表，或是簡單的純文字傾印——同時仍能利用 GroupDocs.Redaction 的高效能編輯引擎。本教學將帶您完成註冊純文字檔案的自訂格式處理程式、套用編輯，最後儲存已編輯的文件。

快速解答

您將學習

什麼是自訂格式處理程式？

自訂格式處理程式是一個外掛，告訴 GroupDocs.Redaction 如何解讀非標準檔案類型。它將檔案副檔名對映到文件類別，使編輯引擎能像處理內建格式一樣讀取、修改與寫入內容。

為何在自訂格式上使用 GroupDocs.Redaction？

GroupDocs.Redaction 支援45+ 輸入與輸出格式，且可處理高達2 GB 的檔案而不需將整個文件載入記憶體。其串流架構相較於傳統載入方式，可降低最高30 % 的 CPU 使用率，適合大量批次作業。

前置條件

必要的函式庫與版本

環境設定需求

知識前提

為 Java 設定 GroupDocs.Redaction

要將 GroupDocs.Redaction 整合至您的 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 下載最新版本。

取得授權步驟

  1. 免費試用 – 無償探索完整功能。
  2. 臨時授權 – 取得限時金鑰以延長測試時間。
  3. 購買 – 取得正式授權以供生產環境使用。

基本初始化與設定

將函式庫加入 classpath 後，依下列方式初始化 GroupDocs.Redaction：

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

public class InitializeRedaction {
    public static void main(String[] args) throws Exception {
        Redactor redactor = new Redactor("path/to/your/document");
        // Perform operations with the redactor instance.
        redactor.close();
    }
}

完成 GroupDocs.Redaction 的設定後，我們即可深入如何實作自訂格式處理程式並套用編輯。

如何在 Java 中實作自訂格式處理程式

功能 1：自訂格式處理程式註冊

概述

註冊自訂格式處理程式可擴充 GroupDocs.Redaction 的能力，讓其處理特定文件類型，例如具有特殊副檔名的純文字檔。

步驟實作

步驟 1：匯入必要的類別

先匯入所需的設定類別：

import com.groupdocs.redaction.configuration.DocumentFormatConfiguration;
import com.groupdocs.redaction.integration.DocumentFormatInstance;
import com.groupdocs.redaction.examples.java.helper_classes.CustomTextualDocument;
步驟 2：設定文件格式

setExtensionFilter 指定自訂處理程式要處理的檔案副檔名。
setDocumentType 將副檔名連結至能讀寫該格式的具體文件類別。

設定文件格式配置，以指定哪個副檔名與類別負責自訂格式：

class CustomFormatHandlerRegistration {
    public static void main(String[] args) {
        DocumentFormatConfiguration config = new DocumentFormatConfiguration();
        // Set the file extension for this handler.
        config.setExtensionFilter(".dump");
        // Specify handling by CustomTextualDocument class.
        config.setDocumentType(CustomTextualDocument.class);
        // Add to available formats list.
        DocumentFormatInstance.getDefaultConfiguration().getAvailableFormats().add(config);
    }
}

功能 2：套用編輯

概述

此功能示範如何編輯文字 java文件，確保任何取代敏感文字的操作皆安全且可稽核。

步驟實作

步驟 1：匯入必要的類別

匯入執行編輯所需的類別：

import com.groupdocs.redaction.Redactor;
import com.groupdocs.redaction.options.SaveOptions;
import com.groupdocs.redaction.redactions.ExactPhraseRedaction;
import com.groupdocs.redaction.redactions.ReplacementOptions;
步驟 2：初始化 Redactor 並套用編輯

Redactor 為核心類別，負責載入文件並執行編輯操作。
建立 Redactor 實例，傳入來源檔案路徑，加入欲執行的編輯物件，最後儲存已編輯的文件為新檔名：

class RedactionApplication {
    public static void main(String[] args) throws Exception {
        final Redactor redactor = new Redactor(YOUR_DOCUMENT_DIRECTORY + "/sample.dump");
        try {
            // Apply an exact phrase redaction.
            redactor.apply(new ExactPhraseRedaction("dolor", false, new ReplacementOptions("[redacted]")));
            // Save the document with a new name.
            redactor.save(new SaveOptions(false, "AnyText"));
        } finally {
            redactor.close();
        }
    }
}

疑難排解技巧

實務應用

以下為可套用本技術的真實情境：

  1. 法律文件保護 – 在與外部律師共享草稿前編輯案件細節。
  2. 金融紀錄安全 – 隱藏銀行對帳單中的帳號與個人識別資訊。
  3. 人力資源資料管理 – 在審計或第三方檢視時遮蔽員工個人資料。
  4. CRM 整合 – 匯出報表前自動編輯客戶 PII。
  5. 自動化合規報告 – 確保法規文件不會意外洩漏資料。

效能考量

使用 GroupDocs.Redaction 時，請參考以下最佳化建議：

常見問題與解決方案

問題原因解決方案
處理程式未被識別副檔名過濾不符確認 setExtensionFilter 完全匹配檔案的副檔名（例如 .dump）。
編輯未套用片語大小寫敏感將 ExactPhraseRedaction 的 ignoreCase 旗標設為 true。
記憶體不足錯誤同時載入大量大型檔案改為順序處理，或在可用時使用串流 API。

常見問答

Q1: 可以用自訂格式處理程式處理哪些檔案類型？
A1: 只要指定副檔名與相對應的文件類別，即可為任何檔案類型配置處理程式，讓未原生支援的格式也能進行編輯。

Q2: 如何取得 GroupDocs.Redaction 的臨時授權？
A: 前往 GroupDocs 的官方網站 申請延長測試的臨時授權金鑰。

Q3: 能否有效率地處理大量文件批次？
A: 能——請參考「效能考量」章節的批次處理技巧，並即時關閉每個 Redactor 實例以降低記憶體使用。

Q4: 同一個處理程式能編輯 PDF 檔嗎？
A: GroupDocs.Redaction 已原生支援 PDF；自訂處理程式通常用於 .dump 或專屬日誌等非標準格式。

Q5: API 是否支援非同步操作？
A: 核心 API 為同步，但您可將呼叫包裝於 Java CompletableFuture，或使用平行串流達成併發。

結論

至此，您應已掌握如何實作自訂格式處理程式以及編輯文字 java文件，並運用 GroupDocs.Redaction for Java 來保護各種文件類型的敏感資訊，從純文字日誌到複雜的法律合約皆不在話下。欲進一步精進，建議探索基於模式的編輯、將工作流程整合至 CI/CD 管線，並使用 Java 效能分析工具監控系統表現。

後續步驟

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

相關教學