使用 GroupDocs Maven 為檔案名稱添加後綴 (java)

Redacting confidential data is only half the battle—you also need to make sure the saved file clearly indicates it has been processed. Using the GroupDocs Maven dependency makes this straightforward, letting you add a suffix to the output file name in just a few lines of code. The method to add suffix filename java is a single‑line configuration that instantly labels your redacted files, helping you stay compliant and audit‑ready.

快速解答

• “add suffix to filename” 的作用是什麼？
  它會在輸出檔名後附加自訂後綴（例如 “_redacted”），讓您能立即辨識已處理的檔案。
• 我可以從串流載入文件嗎？
  可以——GroupDocs.Redaction 支援從任何 InputStream 載入，非常適合雲端儲存或記憶體內處理。
• 此功能需要授權嗎？
  免費試用可執行基本遮蔽；臨時或正式授權可解鎖所有進階功能，包括後綴處理。
• 支援哪些格式？
  函式庫支援 DOCX、PDF、PPTX、XLSX 等多種格式。
• PDF 輸出是否必須光柵化？
  光柵化為可選項目；在需要將文件平面化以提升安全性時啟用即可。

什麼是 add suffix filename java？

add suffix filename java 技術會在儲存操作期間將預先定義的字串加入檔名，明確標示文件已被遮蔽。此簡單慣例可防止原始未遮蔽檔案意外外流，且能順利整合至自動化流程。

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

GroupDocs.Redaction 提供流暢的 Java API，讓您能在僅幾行程式碼內結合遮蔽動作與檔案處理選項——如 add suffix filename java。SDK 支援 50+ 輸入與輸出格式，可在不將整個檔案載入記憶體的情況下處理上百頁文件，兼具高速與低記憶體佔用。

先決條件

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

知識先決條件

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

設定 GroupDocs.Redaction（Java）

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 以進行處理。

步驟實作說明

步驟 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 移除文件中的註解。

步驟實作說明

步驟 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：使用選項儲存文件

概述： 了解如何使用光柵化與 add suffix filename java 等選項儲存處理後的文件。

步驟實作說明

步驟 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，讓檔名明確顯示已被遮蔽。

如何在儲存文件時加入 suffix filename java？

Redactor 是 GroupDocs.Redaction 的主要類別，用於載入文件並套用遮蔽操作。
setAddSuffix 為 SaveOptions 的方法，可自動在輸出檔名加入後綴。

先取得 Redactor 實例，套用所需的遮蔽，然後以啟用 setAddSuffix(true) 的 SaveOptions 呼叫 save()。此單一設定會自動在檔名後加上 “_redacted”（或預設後綴），免除手動重新命名，降低人為錯誤。此操作的時間複雜度為 O(n)，相對於文件大小，且支援所有支援的格式。

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()，防止記憶體洩漏。

常見問題與解決方案

常見問答

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 向專家求助。

資源

• Documentation： 前往 GroupDocs Documentation 瀏覽詳細指南。
• API Reference： 參考 GroupDocs API Reference 取得完整 API 說明。
• Download： 從 GroupDocs Downloads 取得最新版本。
• GitHub Repository： 前往 GroupDocs GitHub 參與貢獻或檢視原始碼。

Last Updated： 2026-05-22
Tested With： GroupDocs.Redaction 24.9 for Java
Author： GroupDocs

相關教學

• Convert Word to PDF and Save Redacted Documents with GroupDocs.Redaction Java
• Preview Document Pages Java Loading with GroupDocs.Redaction
• Advanced Redaction Techniques for GroupDocs.Redaction Java