如何在 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 下載最新版本。
取得授權
- 免費試用: 無限制使用基本功能。
- 臨時授權: 取得臨時授權以探索進階功能。
- 購買授權: 長期使用時,建議購買完整授權。
基本初始化與設定
在專案中加入必要的匯入:
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,亦可確保使用最新的安全修補。
為何添加後綴很重要
在檔名加入後綴可立即提供視覺確認,表明該檔案已被處理,這對於稽核追蹤、自動化工作流程與法規遵循至關重要。腳本可依後綴過濾已編輯的檔案,防止原始內容意外外流,亦符合多數產業標準對已消除資訊文件的明確標示要求。
實務應用
探索以下真實案例:
- 法律文件編輯: 在與客戶共享前保護合約。
- 醫療紀錄處理: 在保留臨床資料的同時保護患者身分識別資訊。
- 財務報告: 在外部審計期間隱藏敏感數字。
- CRM 整合: 在匯出至第三方工具前自動編輯客戶資料。
- 協作工具: 確保共享草稿不會暴露隱藏的評論或中繼資料。
效能考量
效能最佳化
- 使用串流(
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 取得專家協助。
資源
- 文件說明: 前往 GroupDocs Documentation 探索詳細指南。
- API 參考: 於 GroupDocs API Reference 查看完整 API 細節。
- 下載: 從 GroupDocs Downloads 取得最新版本。
- GitHub 倉庫: 前往 GroupDocs GitHub 參與貢獻或瀏覽原始碼。
最後更新: 2026-11-02
測試環境: GroupDocs.Redaction 24.9 for Java
作者: GroupDocs