如何在 Java 中使用 GroupDocs 保存無註釋的 PDF

如果您需要 保存無註釋的 PDF 同時仍能加入協作式底線備註,您來對地方了。許多 Java 開發者在為最終發佈保留乾淨版本的文件時會遇到困難,尤其是同一檔案會被多次審閱。於本教學中,您將學會如何產生乾淨的 PDF、有效管理記憶體,並使用 GroupDocs.Annotation 套用帶有評論的底線註釋。完成後,您將了解完整工作流程——從載入 PDF 到產出無浮水印的最終副本——以及建構健全 java document review system 的最佳實踐技巧。

快速解答

  • 如何新增底線註釋? 使用 UnderlineAnnotation 搭配 annotator.add(),然後儲存文件。
  • 如何保存無註釋的 PDF? 載入已註釋的檔案,在 SaveOptions 中設定 AnnotationType.NONE,再儲存新副本。
  • 需要哪些函式庫? GroupDocs.Annotation v25.2(或更新版本)以及其 Maven 套件庫。
  • 生產環境是否需要授權? 需要——套用有效的 GroupDocs 授權以避免浮水印。
  • 能否有效處理多個文件? 將每個 Annotator 包在 try‑with‑resources 區塊中,使用後即釋放。

如何在 Java 中保存無註釋的 PDF?

使用 Annotator 載入來源 PDF,將 SaveOptions 設定為排除所有註釋類型,然後呼叫 save() 以寫入乾淨副本。此操作不會修改原始檔案,您同時保留供審閱者使用的註釋版與供發佈的原始版。此流程在底層使用串流,意味著整個文件不會一次性全部載入記憶體——對於大型 PDF 至關重要。

什麼是保存無註釋的 PDF?

save pdf without annotations 指的是在匯出 PDF 時剝除所有註釋物件(如標記、評論、印章、底線等)。產生的檔案僅包含原始內容與版面配置,適合用於法律檔案、公開發佈或歸檔保存。

為何在 java document review system 中建立乾淨的 PDF 檔案?

乾淨的版本會移除審閱者的標記、評論與高亮,讓您得到一份可直接交給客戶、監管機構或公開發佈的精緻文件。它亦可平均減少約 30 % 的檔案大小,並防止內部備註意外外洩——這對法律與合規工作流程尤為關鍵。GroupDocs.Annotation 能在單一次處理中移除所有註釋物件,支援最高 500 MB 的 PDF 而不需將整個檔案載入記憶體。

前置條件與環境設定

開始前的需求

開發環境需求

  • Java Development Kit (JDK) 8 或以上(建議 JDK 11+)
  • Maven 3.6+ 或 Gradle 6.0+ 以管理相依性
  • IntelliJ IDEA、Eclipse 或具 Java 擴充功能的 VS Code 等 IDE
  • 至少 2 GB 可用 RAM(文件處理可能會消耗大量記憶體)

知識前置
您應熟悉基本的 Java 概念——物件初始化、方法呼叫與 Maven 相依性。具備第三方函式庫使用經驗會加速上手。

測試文件
準備幾個範例 PDF。以文字為主的 PDF 效果最佳;掃描圖像可能需要先進行 OCR 後才能註釋。

Maven 設定:將 GroupDocs 加入專案

在 pom.xml 中加入以下相依性。此步驟常讓開發者卡關,因為 group ID 與 artifact ID 必須完全相符。

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-annotation</artifactId>
    <version>25.2</version>
</dependency>

重要提示: 版本 25.2 為撰寫本文時的最新穩定版。請定期檢查 GroupDocs 套件庫,以取得包含錯誤修正與效能提升的更新版本。

授權設定(千萬別跳過)

開發/測試用 – 從 GroupDocs 官方網站下載免費試用版。試用版包含全部功能,但會在處理的文件上加上浮水印。

正式環境用 – 購買授權並於應用程式啟動時套用。若未使用有效授權,正式建置將受到限制且會被浮水印覆蓋。

實作指南:新增底線註釋

了解註釋工作流程

在深入程式碼之前,先說明在 annotate PDF in Java 時會發生的四步工作流程:

  1. 文件載入 – Annotator 讀取檔案至記憶體。
  2. 註釋建立 – 定義位置、樣式與評論等屬性。
  3. 註釋套用 – 函式庫將註釋注入 PDF 結構。
  4. 文件儲存 – 持久化修改後的檔案,可選保留原始檔。

此流程為非破壞性;除非您自行覆寫,否則來源檔案保持不變。

步驟 1:初始化 annotator 並載入文件

Annotator 是 GroupDocs.Annotation 用於載入與修改 PDF 文件的主要入口。它抽象化了檔案系統處理、串流管理與原生資源配置。

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/annotation/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-annotation</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

小技巧: 開發階段使用絕對路徑可避免「找不到檔案」錯誤。正式環境建議從 classpath 或雲端儲存桶載入資源。

步驟 2:建立評論與回覆(協作部分)

Comment 物件代表附加於註釋的串接討論。每則評論可包含作者、時間戳記與可選的回覆,讓特定標記的對話完整呈現。

import com.groupdocs.annotation.Annotator;

// Load the document you want to annotate
Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input.pdf");

實務應用: 審閱者可針對特定條款加入串接回覆,將討論緊扣於該註釋。

步驟 3:定義註釋座標(確保位置正確)

Point 定義 PDF 空間中的單一座標(以點為單位,72 點 = 1 吋)。底線需要四個點:起始線的兩個點與結束線的兩個點。

import com.groupdocs.annotation.models.Reply;
import java.util.Calendar;
import java.util.ArrayList;
import java.util.List;

Reply reply1 = new Reply();
reply1.setComment("First comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());

Reply reply2 = new Reply();
reply2.setComment("Second comment");
reply2.setRepliedOn(Calendar.getInstance().getTime());

List<Reply> replies = new ArrayList<>();
replies.add(reply1);
replies.add(reply2);

座標系統說明:

  • 點 1 與點 2 定義底線的上緣。
  • 點 3 與點 4 定義底線的下緣。
  • Y 軸差異(例如 730 與 650)控制線條粗細。

步驟 4:建立並設定底線註釋

UnderlineAnnotation 為具體的底線標記類別。它繼承自基礎 Annotation 類別,並加入底線專屬的屬性,如線條粗細與樣式。

import com.groupdocs.annotation.models.Point;

Point point1 = new Point(80, 730);
Point point2 = new Point(240, 730);
Point point3 = new Point(80, 650);
Point point4 = new Point(240, 650);

List<Point> points = new ArrayList<>();
points.add(point1);
points.add(point2);
points.add(point3);
points.add(point4);

顏色與透明度小技巧:

  • FontColor 使用 ARGB;65535 (0x00FFFF) 產生亮黃色。
  • 紅色使用 16711680 (0xFF0000);藍色使用 255 (0x0000FF)。
  • 透明度介於 0.5 至 0.8 之間,可在不遮蔽文字的前提下提供良好可讀性。

步驟 5:儲存已註釋的文件

SaveOptions 讓您控制輸出格式、是否嵌入註釋,以及如何處理中繼資料。將 AnnotationType.NONE 設為輸出選項,即指示函式庫剝除所有註釋物件,這正是 save PDF without annotations 的關鍵。

import com.groupdocs.annotation.models.annotationmodels.UnderlineAnnotation;

UnderlineAnnotation underline = new UnderlineAnnotation();
underline.setCreatedOn(Calendar.getInstance().getTime());
underline.setFontColor(65535); // Yellow in ARGB format
underline.setMessage("This is an underline annotation");
underline.setOpacity(0.7f);
underline.setPageNumber(0);
underline.setPoints(points);
underline.setReplies(replies);

annotator.add(underline);

記憶體管理: 呼叫 dispose() 會釋放原生資源,防止記憶體洩漏——在批次處理大量檔案時尤為重要。

移除註釋:建立乾淨文件版本

有時您需要一個 完全沒有任何註釋 的 PDF 版本,例如交付最終批准的合約。GroupDocs 提供簡易的方式完成此需求。

了解註釋移除選項

您可以:

  • 移除 全部 註釋(最常見)
  • 移除特定類型(例如僅高亮)
  • 依作者或頁面移除註釋

步驟式註釋移除

步驟 1:載入先前已註釋的文件

Annotator 再次擔任載入器,讀取仍包含註釋物件的檔案。

String outputPath = "YOUR_OUTPUT_DIRECTORY/output.pdf";
annotator.save(outputPath);
annotator.dispose();

步驟 2:設定乾淨輸出的儲存選項

SaveOptions 提供流暢的 API,讓您指定不寫入任何註釋類型至輸出檔。

Annotator annotator = new Annotator(outputPath);

步驟 3:儲存乾淨版本

以配置好的選項呼叫 save(),即可產生僅含原始內容的 PDF。

import com.groupdocs.annotation.options.export.AnnotationType;
import com.groupdocs.annotation.options.export.SaveOptions;

SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.NONE);

此操作會產生 乾淨的 PDF,不含任何註釋物件,完美適用於最終發佈。

常見問題與解決方案

問題 1:「找不到文件」錯誤

請確認檔案路徑正確且應用程式具備讀取權限。使用 Path.of() 搭配絕對路徑可消除大多數模糊情況。

String noneAnnotationPath = Paths.get(outputPath).resolveSibling("none-annotation.pdf").toString();
annotator.save(noneAnnotationPath, saveOptions);
annotator.dispose();

問題 2:註釋出現在錯誤位置

PDF 的座標原點位於左下角。請確認 Y 值向上遞增,並考慮頁面旋轉的影響。

File inputFile = new File("path/to/your/document.pdf");
if (!inputFile.exists()) {
    throw new IllegalArgumentException("Document not found: " + inputFile.getAbsolutePath());
}
if (!inputFile.canRead()) {
    throw new IllegalArgumentException("Cannot read document: " + inputFile.getAbsolutePath());
}

Annotator annotator = new Annotator(inputFile.getAbsolutePath());

問題 3:大型文件的記憶體問題

GroupDocs.Annotation 以串流方式處理內容,從不將整個檔案載入堆疊記憶體。然而,仍需呼叫 dispose(),並在處理超過 200 MB 的檔案時考慮提升 JVM 堆疊大小(-Xmx)。

// Test with a simple rectangle in the top‑left corner
Point point1 = new Point(10, 10);   // Top‑left
Point point2 = new Point(100, 10);  // Top‑right  
Point point3 = new Point(10, 30);   // Bottom‑left
Point point4 = new Point(100, 30);  // Bottom‑right

問題 4:生產環境的授權問題

若授權檔缺失或路徑不正確,函式庫會回退至試用模式,於每頁加上浮水印。請將授權檔放置於 classpath 可達位置,並於應用程式啟動早期載入。

// Increase JVM heap size when launching the app, e.g., -Xmx2g
try (Annotator annotator = new Annotator("document.pdf")) {
    // Annotation logic here
    annotator.save("output.pdf");
}

生產環境效能最佳實踐

記憶體管理策略

GroupDocs.Annotation 以串流方式處理 PDF,允許處理最高 500 MB 的檔案而不需將整個文件載入記憶體。仍建議遵循以下指引:

try {
    License license = new License();
    license.setLicense("path/to/your/license.lic");
    System.out.println("License loaded successfully");
} catch (Exception e) {
    System.err.println("License loading failed: " + e.getMessage());
    // Handle the error appropriately
}
try (Annotator annotator = new Annotator("input.pdf")) {
    // Your annotation logic
    annotator.save("output.pdf");
} // Annotator is automatically disposed here

執行緒考量

GroupDocs.Annotation 預設 非執行緒安全。若您的應用程式同時處理多個文件:

  • 絕不要 在多個執行緒間共享同一個 Annotator 實例。
  • 同步 檔案存取或使用鎖定機制。
  • 若需要高吞吐量,可考慮建立 Annotator 物件池。

快取策略

  • 快取常用的註釋模板。
  • 重複使用 Point 集合以節省座標建立成本。
  • 若頻繁在同一基礎文件上加註釋,可將 模板 PDF 常駐記憶體。

Java PDF 記憶體管理最佳實踐

在處理大型 PDF 或批次處理多檔案時,效率的記憶體使用至關重要。以下提供實用建議:

  • 使用 try‑with‑resources 包住每個 Annotator,確保自動釋放。
  • 僅在必要時 提升 JVM 堆疊大小(-Xmx),並使用效能分析工具監控使用情況。
  • 盡可能順序處理 文件,於每個檔案處理完畢後釋放記憶體。
  • 避免重複載入相同 PDF;若需多次讀取,請重用同一個串流。

遵循上述做法,可讓您的應用保持回應速度,避免在高負載的註釋工作中發生記憶體不足的情況。

真實應用與使用情境

文件審閱系統

  • 法律審查: 底線標示合約條款並加入風險評論。
  • 合規稽核: 在財務報表中高亮問題段落。
  • 學術同行評審: 教授底線標示需澄清的段落。

教育平台

  • 學生註釋工具: 讓學習者在電子書中底線關鍵概念。
  • 教師回饋: 直接在提交的作業上提供行內評論。

品質保證工作流程

  • 技術文件審查: 工程師底線需要更新的章節。
  • 標準作業程序: 安全主管標示關鍵步驟。

內容管理系統

  • 編輯工作流程: 編輯者底線需事實查證的文字。
  • 版本控制: 追蹤文件修訂過程中的註釋歷史。

專業實作進階技巧

自訂註釋樣式

您可以透過設定自訂的虛線模式、線端樣式與透明度,擴充底線的視覺呈現。此功能在需要區分審閱者角色(例如法律 vs. 工程)時相當有用。

List<String> documentPaths = Arrays.asList("doc1.pdf", "doc2.pdf", "doc3.pdf");

for (String docPath : documentPaths) {
    try (Annotator annotator = new Annotator(docPath)) {
        // Process one document at a time
        annotator.add(createAnnotation());
        annotator.save(getOutputPath(docPath));
    }
    // Memory is freed after each iteration
}

註釋中繼資料以供追蹤

每個註釋皆可攜帶使用者自訂的中繼資料字典。可儲存 ID、時間戳記或工作流程狀態,以整合外部追蹤系統。

UnderlineAnnotation underline = new UnderlineAnnotation();
underline.setFontColor(16711680);      // Red for urgent items
underline.setOpacity(0.5f);            // Subtle highlighting
underline.setFontSize(12);             // Consistent sizing
underline.setMessage("URGENT REVIEW REQUIRED");

與使用者管理系統整合

將 Comment 的 author 屬性對映至您系統的使用者 ID。這樣即可實現基於角色的樣式設定與稽核追蹤。

underline.setCreatedBy("john.doe@company.com");
underline.setCreatedOn(Calendar.getInstance().getTime());
underline.setMessage("Legal review required - Contract clause 4.2");

生產問題除錯

效能監控

在生產環境中留意以下指標:

  • 堆疊使用量 – 確保已呼叫 dispose()。
  • 每份文件的處理時間 – 在 annotator.save() 前後記錄時間戳記。
  • 錯誤率 – 捕捉例外並分類統計。

常見生產陷阱

  • 檔案鎖定 – 確保上傳的檔案在註釋前已關閉。
  • 同時編輯 – 實作樂觀鎖或版本檢查機制。
  • 大型檔案(> 50 MB) – 增加 JVM 超時設定,並考慮使用串流 API。

錯誤處理最佳實踐

將所有註釋呼叫包在 try‑catch 區塊中,完整記錄堆疊資訊,並拋出自訂的 AnnotationException,提供使用者友善訊息。此模式可簡化除錯流程,並為 API 使用者提供清晰回饋。

// Assume you have a method that returns the current authenticated user
String currentUser = getCurrentUser();
String userRole = getUserRole(currentUser);

// Apply role‑based styling
UnderlineAnnotation underline = new UnderlineAnnotation();
underline.setCreatedBy(currentUser);
underline.setFontColor(getRoleColor(userRole));
underline.setMessage(String.format("[%s] %s", userRole.toUpperCase(), commentText));

常見問答

Q: 如何在一次操作中為多個文字區域加註釋?
A: 建立多個 UnderlineAnnotation 物件,設定不同座標後,依序使用 annotator.add() 加入。

Q: 能否在 PDF 內的圖像上加註釋?
A: 能。使用相同的座標系統,確保點位於圖像範圍內即可。

Q: 除了 PDF,GroupDocs.Annotation 支援哪些檔案格式?
A: 支援 Word(DOC/DOCX)、Excel(XLS/XLSX)、PowerPoint(PPT/PPTX)以及 JPEG、PNG、TIFF 等影像格式。

Q: 如何在處理極大文件時避免記憶體耗盡?
A: 一次只處理一個文件,必要時提升 JVM 堆疊大小(-Xmx),並即時呼叫 Annotator 的 dispose()。

Q: 能否抽取文件中已存在的註釋?
A: 能。使用 annotator.get() 取得全部註釋,然後依類型、作者或頁碼進行篩選。


最後更新: 2026-10-16
測試環境: GroupDocs.Annotation 25.2
作者: GroupDocs


try (Annotator annotator = new Annotator(documentPath)) {
    UnderlineAnnotation annotation = createAnnotation();
    annotator.add(annotation);
    annotator.save(outputPath);
    
} catch (Exception e) {
    logger.error("Annotation failed for document: " + documentPath, e);
    // Implement appropriate error recovery
    throw new DocumentProcessingException("Failed to annotate document", e);
}

相關教學