產生預覽與文件頁數 – GroupDocs Java

當建立智慧化的遮蔽工作流程時，了解 how to generate preview 圖像是必須的，而能讀取 document page count 則可讓您精確規劃資源與 UI 版面配置。這些功能結合起來，可讓您視覺化每一頁、確認遮蔽目標，並為大型檔案優化效能。在本指南中，我們將說明 GroupDocs.Redaction for Java 所提供的更廣泛的文件資訊功能，包括取得文件大小、擷取中繼資料，以及判斷文件頁數。

快速解答

What does “how to generate preview” mean? 它指的是為文件的每一頁建立圖像表示（例如 PNG、JPEG），以便在 UI 中顯示。
Why generate a preview before redaction? 它有助於驗證遮蔽規則是否針對正確的視覺元素，並降低意外資料外洩的風險。
Which formats are supported? 所有 GroupDocs.Redaction 支援的格式，例如 PDF、DOCX、PPTX 以及影像檔案。
Do I need a license? 臨時授權可用於評估；正式授權則是生產環境的必要條件。
What additional info can I retrieve? 文件大小（Document size Java）、文件頁數（document page count）以及擷取文件中繼資料，都可透過同一個 API 取得。

在 GroupDocs.Redaction 中，「how to generate preview」是什麼意思？

產生預覽即是將來源檔案的每一頁轉換為點陣圖。此過程快速、記憶體效能佳且跨平台，讓您能將頁面縮圖或完整預覽直接嵌入 Web 或桌面應用程式。產生的圖像保留與遮蔽引擎稍後處理時相同的版面配置、字型與顏色，確保整個工作流程的視覺一致性。

為何使用 GroupDocs.Redaction 產生預覽？

GroupDocs.Redaction 提供 quantified performance：它能在一般 2.5 GHz 伺服器上於 2 秒內將 200 頁的 PDF 以 150 DPI 轉換為 PNG 縮圖，且支援 50+ 輸入與輸出格式，包括 PDF、DOCX、PPTX 以及常見影像類型。此引擎亦內建可直接取得文件大小、頁數與中繼資料，無需額外 API 呼叫，從而簡化整體文件分析流程。

先決條件

已安裝 Java 8 或更新版本。
已在專案中加入 GroupDocs.Redaction for Java 套件（Maven/Gradle）。
具備有效的（臨時或正式）GroupDocs.Redaction 授權。

文件資訊與預覽產生逐步指南

步驟 1：初始化 Redaction Engine

RedactionEngine 類別是載入文件並提供預覽與遮蔽功能的核心元件。建立實例並載入目標檔案，即可取得其屬性。

步驟 2：取得基本文件資訊

使用提供的 API 方法取得 document size Java、document page count 以及任何內嵌的中繼資料。了解頁數可讓您決定是否產生高解析度預覽或批次處理頁面。

步驟 3：產生頁面預覽

呼叫 preview API 將每一頁渲染為圖像。您可以遍歷頁面，將 PNG 或 JPEG 檔案儲存下來，或直接串流至 UI 元件。調整 DPI 與影像品質參數，以符合 UI 的效能與視覺需求。

步驟 4：（可選）擷取文件中繼資料

若需稽核來源檔案，可呼叫中繼資料擷取方法取得作者、建立日期與自訂屬性。此步驟在遮蔽前的合規檢查中相當有用。

步驟 5：套用遮蔽規則（預覽驗證後）

在透過預覽確認視覺版面後，即可自信地定義並套用遮蔽規則，確保目標內容正確。

常見問題與解決方案

Preview images are blurry: 將呼叫 preview 方法時的 DPI 或解析度參數調高。
Out‑of‑memory errors on large PDFs: 將頁面分批處理，並在使用後釋放圖像串流，以避免大型 PDF 產生記憶體不足錯誤。
Missing metadata: 確認來源檔案確實包含中繼資料；某些格式（例如純文字）不支援中繼資料。

可用教學

如何使用 GroupDocs.Redaction 在 Java 中取得文件資訊

了解如何使用 GroupDocs.Redaction for Java 高效取得文件資訊，如檔案類型、頁數與大小，立即提升您的 Java 應用程式。

其他資源

常見問答

Q: 如何以程式方式取得文件頁數？
A: 使用已載入文件物件的 getPageCount() 方法；它會回傳表示總頁數的整數。

Q: 能為受密碼保護的檔案產生預覽嗎？
A: 可以。開啟文件時提供密碼，之後即可照常使用 preview API。

Q: 預覽支援哪些影像格式？
A: 完全支援 PNG 與 JPEG，且可設定 DPI 與品質參數。

Q: 是否能在不將整個文件載入記憶體的情況下取得原始檔案大小（document size Java）？
A: 此函式庫提供 getFileSize() 方法，直接從檔案系統中讀取大小，避免完整解析文件。

Q: 如何從 DOCX 檔案擷取自訂中繼資料欄位？
A: 在載入文件後使用 getCustomProperties() 集合，遍歷鍵值對即可取得每個自訂屬性。

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