如何在 GroupDocs Redaction Java 中為檔案名稱添加後綴

在本 GroupDocs Redaction Java 教學 中,您將學習如何在使用 GroupDocs.Redaction 進行文件編輯時,自動在輸出檔名後添加後綴。添加後綴可免除手動重新命名,降低未編輯檔案外洩的風險,並能順利融入依賴命名規則的 CI/CD 流程。本指南將帶您完成 Maven 設定、串流文件載入、註解移除以及保存選項的配置——全部以簡潔、可投入生產的程式碼示範。

快速解答

  • 「add suffix to filename」的功能是什麼?
    當您啟用後綴選項時,SDK 會自動在輸出檔案的基礎名稱(副檔名之前)加入預先定義的字串(預設為「_redacted」)。這可立即顯示哪些檔案已被處理,協助防止原始內容意外外流,並簡化依賴命名模式的下游自動化流程。
  • 我可以從串流載入文件嗎?
    可以——GroupDocs.Redaction 支援從任何 InputStream 載入,非常適合雲端儲存或記憶體內處理。
  • 此功能需要授權嗎?
    免費試用可用於基本編輯;臨時或完整授權則解鎖所有進階選項,包括後綴處理。
  • 支援哪些格式?
    函式庫可處理 DOCX、PDF、PPTX、XLSX 等多種格式。
  • PDF 輸出是否需要光柵化?
    光柵化為可選項目;在需要將文件平面化以提升安全性時才啟用。

「add suffix to filename」的功能是什麼?

當您啟用後綴選項時,SDK 會自動在輸出檔案的基礎名稱(副檔名之前)加入預先定義的字串(預設為「_redacted」)。這可立即顯示哪些檔案已被處理,協助防止原始內容意外外流,並簡化依賴命名模式的下游自動化流程。

為何在此任務中使用 GroupDocs.Redaction?

GroupDocs.Redaction 提供高效能的 Java API,將編輯操作與彈性檔案處理選項(如自動添加後綴、串流支援與批次處理)結合。它支援超過 50 種輸入與輸出格式,且能在不將整個檔案載入記憶體的情況下處理上百頁文件,確保低記憶體佔用與快速執行。

前置條件

  • Java Development Kit (JDK): 版本 8 或以上。
  • GroupDocs.Redaction Library: 用於編輯任務的核心函式庫。
  • IDE: IntelliJ IDEA、Eclipse 或任何相容 Java 的編輯器。
  • Maven: 用於相依管理。

知識前置條件

熟悉 Java I/O 與基本物件導向概念,將有助於更順利閱讀範例。

為 Java 設定 GroupDocs.Redaction

Maven 設定

在您的 pom.xml 檔案中加入以下設定,即可透過 Maven 取得 GroupDocs 函式庫:

<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. 購買授權: 長期使用時,建議購買完整授權。

基本初始化與設定

在專案中加入必要的匯入:

import com.groupdocs.redaction.Redactor;

有了這些設定,您即可開始實作文件編輯功能。

實作指南

功能 1:從串流載入文件

概述: 了解如何將文件載入 InputStream 以供處理。

InputStream 是 Java I/O 類別,代表位元組串流,允許您從檔案、網路連線或其他來源讀取資料,而不必將整個內容載入記憶體。

步驟 1.1:建立 InputStream

import java.io.FileInputStream;
import java.io.InputStream;

try (InputStream stream = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    final Redactor redactor = new Redactor(stream);
    try {
        // Document is now loaded and ready for further processing
    } finally {
        redactor.close();
    }
}
  • 為什麼: 使用 InputStream 可處理儲存在雲端儲存桶、資料庫或記憶體緩衝區等各種位置的文件,無需先寫入磁碟。此做法在微服務架構中需要 load document from stream 時尤為重要。

功能 2:套用註解刪除編輯

概述: 使用 DeleteAnnotationRedaction 移除文件中的註解。

DeleteAnnotationRedaction 為一種編輯操作,會刪除文件中所有註解(如評論、標記與備註)。

步驟 2.1:套用 DeleteAnnotationRedaction

import com.groupdocs.redaction.redactions.DeleteAnnotationRedaction;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply the DeleteAnnotationRedaction to remove annotations from the document
    redactor.apply(new DeleteAnnotationRedaction());
}
  • 為什麼: 此步驟確保任何敏感的註解(評論、標記或隱藏備註)皆被剔除,提升隱私與合規性。

功能 3:使用選項保存文件

概述: 了解如何使用 SaveOptions 以特定選項(如光柵化與 add suffix filename java)保存處理後的文件。

SaveOptions 封裝了控制編輯後文件寫入方式的設定,包括格式、光柵化與命名慣例。

步驟 3.1:設定 SaveOptions

import java.io.ByteArrayOutputStream;
import com.groupdocs.redaction.options.SaveOptions;

try (Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    // Apply necessary redactions before saving
    redactor.apply(new DeleteAnnotationRedaction());
    try (ByteArrayOutputStream bA = new ByteArrayOutputStream()) {
        SaveOptions options = new SaveOptions();
        options.setRasterizeToPDF(true);  // Option to rasterize document to PDF format
        options.setAddSuffix(true);      // Option to add a suffix to the saved file name
        redactor.save(bA, options.getRasterization());
    }
}
  • 為什麼: 自訂保存選項可彈性調整輸出格式與命名慣例。啟用 setAddSuffix(true) adds suffix to filename,讓檔案明顯標示已被編輯。

如何在保存文件時於 Java 添加檔名後綴?

Redactor 類別是載入文件並套用編輯操作的核心元件。SaveOptions 定義了編輯後文件的保存方式,包括格式、光柵化與命名慣例。建立 Redactor 實例、套用所需的編輯,然後以 setAddSuffix(true) 設定 SaveOptions 物件。呼叫 redactor.save(outputPath, options) 後,SDK 會自動在檔名加入「_redacted」(或您自行設定的後綴),無需手動重新命名。

GroupDocs Maven 相依概覽

groupdocs maven dependency 只需在 pom.xml 中加入單一 <dependency>,即可將整個 Redaction SDK 引入專案。它會處理傳遞相依、保持函式庫最新,並簡化建置自動化。透過在 pom.xml 宣告相依,您不必手動管理 JAR,亦可確保使用最新的安全修補。

為何添加後綴很重要

在檔名加入後綴可立即提供視覺確認,表明該檔案已被處理,這對於稽核追蹤、自動化工作流程與法規遵循至關重要。腳本可依後綴過濾已編輯的檔案,防止原始內容意外外流,亦符合多數產業標準對已消除資訊文件的明確標示要求。

實務應用

探索以下真實案例:

  1. 法律文件編輯: 在與客戶共享前保護合約。
  2. 醫療紀錄處理: 在保留臨床資料的同時保護患者身分識別資訊。
  3. 財務報告: 在外部審計期間隱藏敏感數字。
  4. CRM 整合: 在匯出至第三方工具前自動編輯客戶資料。
  5. 協作工具: 確保共享草稿不會暴露隱藏的評論或中繼資料。

效能考量

效能最佳化

  • 使用串流(load document from stream)避免將整個檔案載入記憶體。
  • 及時關閉 Redactor 實例以釋放資源。

資源使用指引

  • 在批次執行時監控 CPU 與記憶體使用情況。
  • 處理較小檔案時,可使用 ByteArrayOutputStream 進行記憶體內保存。

Java 記憶體管理最佳實踐

  • 在處理多個相同類型檔案時重複使用 Redactor 物件。
  • 在 try‑with‑resources 區塊中呼叫 close(),防止記憶體洩漏。

常見問題與解決方案

問題原因解決方案
後綴未顯示setAddSuffix(false) 或未呼叫確保在 save() 前設定 options.setAddSuffix(true)。
大型 DOCX 發生 OutOfMemoryError將整個檔案載入記憶體改用 InputStream 載入(參見功能 1)。
註解仍然可見在保存前未套用編輯在 save() 前呼叫 redactor.apply(new DeleteAnnotationRedaction())。
PDF 未套用光柵化setRasterizeToPDF(false) 或未設定需要平面化 PDF 時,設定 options.setRasterizeToPDF(true)。

常見問答

Q:我可以使用 GroupDocs.Redaction 編輯 PDF 文件嗎?
A:可以,函式庫支援 PDF、DOCX、PPTX、XLSX 等多種格式。

Q:處理大型檔案的最佳方式是什麼?
A:使用串流(load document from stream)並及時關閉資源,可降低記憶體佔用。

Q:可以自訂後綴文字嗎?
A:API 會自動加入預設後綴(例如「_redacted」)。若需自訂後綴,請在保存後自行重新命名輸出檔案。

Q:如何取得 GroupDocs.Redaction 的臨時授權?
A:請前往 Temporary License page 並依指示操作。

Q:遇到問題時該向哪裡尋求協助?
A:可加入 GroupDocs Support Forum 取得專家協助。

資源


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

相關教學