如何在 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 時會發生的四步工作流程:
- 文件載入 –
Annotator讀取檔案至記憶體。 - 註釋建立 – 定義位置、樣式與評論等屬性。
- 註釋套用 – 函式庫將註釋注入 PDF 結構。
- 文件儲存 – 持久化修改後的檔案,可選保留原始檔。
此流程為非破壞性;除非您自行覆寫,否則來源檔案保持不變。
步驟 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);
}