如何使用 GroupDocs.Redaction 於 Java 移除註解

當您需要 remove annotations Java 時，雜亂的評論和標記會讓文件難以閱讀和處理。無論是清理法律合約、學術草稿，或是內部報告，GroupDocs.Redaction 的 Java API 都能提供快速且可靠的方式，一次呼叫即可去除所有註解——通常能在兩秒內處理 200 頁的 PDF。本指南將逐步說明您所需的一切，從環境設定到清除註解的完整程式碼，讓您能將此功能整合到自己的 Java 應用程式中。

快速解答

What does “remove annotations java” mean? 它表示以程式方式刪除文件中所有評論類型的物件，使用 Java 程式碼完成。
Which library handles this? GroupDocs.Redaction for Java。
Do I need a license? 臨時授權可用於評估；正式環境需使用完整授權。
Can I keep the original file format? 可以，API 預設會以原始格式儲存文件。
How long does the operation take? 通常在一秒以內完成一般大小的檔案；較大的 PDF 可能需要數秒。

「remove annotations java」是什麼？

Removing annotations in Java means using the GroupDocs.Redaction SDK to locate every annotation object (comments, highlights, stamps, etc.) in a document and delete them automatically. 這樣就不需要手動在文字處理器中逐一開啟檔案並逐一清除註解。

為什麼要移除註解？

Removing annotations ensures legal compliance, publishing readiness, and better performance. 例如，合約可在一秒內達到簽署就緒，手稿在提交期刊前去除審稿者的註記，下游處理流程對於無註解的檔案可減少高達 30% 的載入時間。

前置條件

GroupDocs.Redaction for Java 版本 24.9 或更新（支援 50 多種輸入與輸出格式）。
Maven（如果您偏好相依管理）或直接下載 JAR。
A JDK（建議使用 Java 8 以上）以及如 IntelliJ IDEA 或 Eclipse 等 IDE。
基本的 Java 知識與檔案 I/O 的熟悉度。

設定 GroupDocs.Redaction for Java

Maven 設定

Add the repository and dependency to your 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>

直接下載

Alternatively, download the latest JAR from GroupDocs.Redaction for Java releases.

取得授權

若要解鎖完整功能，請從授權頁面取得臨時授權。這讓您在不受評估限制的情況下進行測試。

基本初始化

以下是一個最小的啟動類別，用於開啟文件。請保持程式碼不變——這是您稍後將使用的完整程式碼區塊。

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

public class InitializeGroupDocs {
    public static void main(String[] args) {
        // Replace with the path to your document
        final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx");
        
        try {
            // Basic initialization and setup code here
        } finally {
            redactor.close();
        }
    }
}

如何在 Java 中移除註解？

Redactor 會載入文件以供編輯。DeleteAnnotationRedaction 會移除所有註解物件。SaveOptions 用於設定輸出選項。使用 Redactor 實例載入來源檔案，套用 DeleteAnnotationRedaction，設定 SaveOptions 以保留原始格式，最後呼叫 save。此五步流程可在一次操作中移除所有註解，同時保留文件的版面配置與中繼資料。

步驟 1 – 匯入套件

這些匯入讓您能使用 Redactor、儲存選項以及特定的修訂類型。

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

步驟 2 – 初始化 Redactor

Redactor 類別是 GroupDocs.Redaction 中負責載入與修改文件的核心引擎。建立指向您欲清理之檔案的 Redactor 實例。

final Redactor redactor = new Redactor("YOUR_DOCUMENT_DIRECTORY/sample.docx");

步驟 3 – 套用 DeleteAnnotationRedaction

DeleteAnnotationRedaction 類別代表一項會從文件中移除所有註解物件的修訂操作。這一行程式碼即告訴 SDK 去除所有註解。

redactor.apply(new DeleteAnnotationRedaction());

步驟 4 – 設定 Save Options

SaveOptions 類別讓您設定輸出選項，例如檔案格式、後綴與壓縮。我們為輸出檔名加入後綴，以免覆寫原始檔，且保留原始格式。

SaveOptions saveOptions = new SaveOptions();
saveOptions.setAddSuffix(true);
saveOptions.setRasterizeToPDF(false);

步驟 5 – 儲存已修改的文件

最後，將變更寫回磁碟。

redactor.save(saveOptions);

完整範例回顧

將上述步驟組合起來，工作流程如下：

匯入所需的類別。
使用您的來源檔案實例化 Redactor。
呼叫 apply(new DeleteAnnotationRedaction())。
設定 SaveOptions（加入後綴、保留格式）。
呼叫 redactor.save(saveOptions)。

疑難排解技巧

File path errors: 確認傳遞給 Redactor 的路徑是絕對路徑或相對於專案的正確相對路徑。
Missing dependencies: 再次檢查您的 pom.xml 或 JAR 類路徑；若缺少核心函式庫，Redactor 將無法啟動。
License not applied: 若出現授權例外，請確保臨時授權檔案放置於正確目錄，且在程式碼中正確引用（此處未示範）。

實務應用

Legal Document Review: 在最終簽署前移除審閱者的評論。
Academic Publishing: 在提交期刊前清除手稿中的同行評審註記。
Internal Reports: 提供沒有草稿註解雜訊的精緻內部報告。

效能考量

Resource Management: 始終呼叫 redactor.close()（如初始化範例所示）以釋放本機資源。
Large Files: 對於數百頁的 PDF，建議分段處理或增大 JVM 堆積大小。
Stay Updated: 保持更新：新版本會帶來效能優化，請確保 Maven 版本為最新。

常見陷阱與避免方法

陷阱	解決方案
忘記呼叫 `redactor.close()`	將使用包在 try‑finally 區塊中（如啟動類別所示）。
路徑使用錯誤的檔案副檔名	確保路徑與實際檔案類型相符（DOCX、PDF 等）。
未加入後綴而覆寫原始檔	設定 `saveOptions.setAddSuffix(true)` 以保留來源檔案。

常見問答

Q: What is GroupDocs.Redaction?
A: GroupDocs.Redaction 是一個 Java API，讓您以程式方式修訂或刪除敏感內容——包括註解——支援多種文件格式。

Q: Can I use this in a commercial project?
A: 可以，前提是您擁有有效的商業授權。臨時授權僅供評估使用。

Q: Does the API support PDF, DOCX, and other formats?
A: 當然支援。它可處理 PDF、DOCX、PPTX、XLSX 等超過 50 種格式。

Q: Is there any limit to the number of annotations I can delete?
A: 沒有硬性限制；效能取決於文件大小與系統資源。一般 200 頁、含數千註解的 PDF 可在兩秒內處理。

Q: How can I revert changes if I delete annotations by mistake?
A: API 會覆寫您儲存的檔案。請在執行修訂前備份原始文件。

資源

Documentation: GroupDocs Redaction Java Documentation
API Reference: API Reference
Download: Latest Releases
GitHub Repository: GroupDocs.Redaction for Java
Free Support Forum: GroupDocs Community Forum
Temporary License: Obtain a Temporary License

依照本指南，您現在已掌握使用 GroupDocs.Redaction remove annotations Java 的可靠方法。將此程式碼片段整合至批次處理流程，即可隨時取得更乾淨、無註解的文件。

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