如何使用 GroupDocs Viewer for Java 提取元資料

在本教學中，您將學習 如何提取元資料，適用於各種文件類型，使用 GroupDocs Viewer for Java。完成本指南後，您將能夠取得頁數、發現支援的檢視格式，並建立輕量級的 文件預覽 功能，而無需完整渲染檔案。當您需要快速 取得頁數（Java） 或以記憶體效率高的方式處理大型文件時，此方法尤其有價值。

使用 GroupDocs.Viewer for Java 取得文件檢視資訊與洞見

Viewer 是代表文件的核心類別，提供渲染與元資料提取的方法。
getViewInfo 會回傳一個包含頁數與支援檢視類型等元資料的 ViewInfo 物件。

快速解答

  • 提取文件元資料是什麼意思？ 在不完整渲染內容的情況下，取得結構性細節（頁數、檢視選項、格式特定資料）。
  • 哪個方法提供檢視資訊？ viewer.getViewInfo(viewInfoOptions)。
  • 我可以在不完整渲染的情況下預覽文件嗎？ 是的，透過使用檢視元資料，您可以建立快速的 document preview java 功能。
  • 它適用於大型檔案嗎？ 絕對適用——元資料提取使用極少記憶體，協助您有效 manage large documents。
  • 我需要授權嗎？ 免費試用可用於評估；商業授權則是正式上線的必要條件。

如何使用 GroupDocs Viewer for Java 提取元資料

使用 Viewer 類別載入文件，然後呼叫 getViewInfo —— 這一次呼叫即可回傳完整的檢視元資料，包括頁數、支援的檢視類型以及格式特定選項。此操作僅讀取檔案標頭，即使是數百頁的檔案也能在毫秒內完成，且比完整渲染消耗的記憶體少得多。

Viewer 類別是什麼？

Viewer 類別是 GroupDocs Viewer for Java 的核心元件，代表文件並提供渲染與元資料提取的方法。所有與檢視相關的操作皆透過此物件執行。

為什麼使用 GroupDocs Viewer 進行元資料提取？

  • Performance（效能）: 在一般伺服器上，對 300 頁的 PDF 於 50 ms 內取得元資料，使用的記憶體少於 5 MB。
  • Format coverage（格式支援）: 支援 50+ input and output formats（PDF、DOCX、XLSX、PPTX、HTML、圖片等）。
  • Scalability（可擴充性）: 讓您能即時 get page count java，非常適合大型文件入口網站的分頁控制。
  • Security（安全性）: 除非明確要求，否則不會渲染敏感內容，降低攻擊面。

前置條件

  • GroupDocs.Viewer for Java: 版本 25.2 或更新。
  • Java Development Kit (JDK): 版本 8 或以上。
  • IDE（IntelliJ IDEA、Eclipse 或 NetBeans）以及 Maven 用於相依管理。
  • 具備基本的 Java 知識並熟悉 Maven。

設定 GroupDocs Viewer for Java

將函式庫加入您的 Maven pom.xml 中：

Maven 設定

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

取得授權步驟

  • Free trial（免費試用）: 從 GroupDocs 官方網站下載以探索功能。
  • Temporary license（臨時授權）: 取得時限金鑰以延長測試。
  • Commercial license（商業授權）: 購買以獲得無限制的正式使用。

實作指南

取得文件檢視資訊

取得完整的檢視相關細節，例如頁數與支援的檢視選項。

概觀

目標是 extract document metadata——具體而言是取得檢視資訊，告訴您文件有多少頁以及支援哪些渲染格式。

步驟實作

1. 初始化 Viewer
建立指向目標檔案的 Viewer 實例：

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ViewInfo;

public class FeatureGetViewInfo {
    public static void main(String[] args) {
        // Specify the path to your input document.
        String filePath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF";
        
        // Initialize ViewInfoOptions for HTML view.
        ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();

        try (Viewer viewer = new Viewer(filePath)) {
            // Retrieve view information about the document using the specified options.
            ViewInfo info = viewer.getViewInfo(viewInfoOptions);
            
            // The info object now contains details like page count and available views.
        }
    }
}

2. 設定 view‑info 選項

  • ViewInfoOptions.forHtmlView() – 取得 HTML 專屬的元資料。
  • ViewInfoOptions.forPdfView() – 取得 PDF 專屬的元資料。
  • ViewInfoOptions.forImageView() – 取得影像縮圖的元資料。

3. 取得元資料
呼叫 viewer.getViewInfo(viewInfoOptions) 以取得包含頁數、支援檢視類型及其他有用資訊的 ViewInfo 物件。

如何取得其他格式的檢視資訊

將工廠方法（forHtmlView()）換成 forPdfView() 或 forImageView()，即可分別取得 PDF 或影像型預覽的元資料。

常見問題與故障排除

  • File‑not‑found errors（檔案未找到錯誤）: 再次確認傳遞給 Viewer 建構子之絕對或相對路徑。
  • Missing Maven artifacts（缺少 Maven 產物）: 確認 groupdocs-viewer 相依已正確解析；若出現 class not found 例外，請執行 mvn clean install。
  • Large document handling（大型文件處理）: 使用 try‑with‑resources 自動關閉 Viewer 並釋放原生資源。

實務應用

  1. Document management systems（文件管理系統）: 使用者上傳檔案時自動填入元資料欄位（頁數、格式），提升搜尋與分類效率。
  2. Fast preview features（快速預覽功能）: 建立輕量級的 how to preview document 元件，顯示首頁或縮圖而無需完整渲染。
  3. Analytics & reporting（分析與報告）: 收集整個儲存庫的頁數統計，以預測儲存需求並監控使用趨勢。

效能考量

  • 及時釋放 Viewer 實例（例如使用 try‑with‑resources）以釋放原生句柄。
  • 僅在需要時提取元資料；避免不必要的完整渲染呼叫，以降低記憶體使用，特別是在 manage large documents 情境下。

常見問答

Q: What is the purpose of ViewInfoOptions in GroupDocs Viewer for Java?
A: 它告訴 API 您想要哪種檢視格式（HTML、PDF、影像）的元資料，讓您能有效 extract document metadata。

Q: 我可以在 GroupDocs Viewer for Java 中使用除 PDF 之外的檔案類型嗎？
A: 可以，它支援超過 50 種格式，包括 Word、Excel、PowerPoint 以及常見影像類型，非常適合 metadata extraction java 專案。

Q: 如何在不耗盡記憶體的情況下處理非常大的文件？
A: 僅取得元資料（使用 getViewInfo）並立即關閉 Viewer；此方式可在使用低於 10 MB 記憶體的情況下處理數百頁的檔案。

Q: 正式環境是否需要授權？
A: 提供免費試用供評估使用，但任何正式部署皆須購買商業授權。

Q: 實作此功能時最常見的錯誤是什麼？
A: 最常見的問題是檔案路徑不正確與缺少 Maven 相依。請確認文件位置並確保 groupdocs-viewer 產物正確加入您的 pom.xml。

資源

最後更新： 2026-09-05
測試環境： GroupDocs.Viewer for Java 25.2
作者： GroupDocs

相關教學