如何在 Java 中使用 GroupDocs 進行元資料搜尋

快速且可靠地將文件加入索引是任何現代搜尋驅動應用程式的基礎。無論您是建立法律資料庫、客戶支援知識庫,或是內部文件入口網站,metadata search with GroupDocs 讓您能夠依作者、標題或任何自訂標籤定位檔案,而不必掃描全文內容。在本教學中,您將學習如何設定索引參數、建立以元資料為主的索引、加入檔案,並執行精確搜尋——全部使用 GroupDocs.Search for Java。

快速解答

  • What is the primary purpose of metadata indexing? 它能夠基於文件屬性而非全文內容進行快速搜尋。
  • 哪個方法將檔案加入索引? index.add(YOUR_DOCUMENTS_FOLDER);
  • 我可以依自訂元資料欄位搜尋嗎? 是的,欄位被索引後即可直接查詢。
  • 開發時需要授權嗎? 評估階段使用臨時試用授權即可;正式上線需購買正式授權。
  • 需要哪個 Java 版本? 建議使用 JDK 8 或更高版本。

GroupDocs.Search 中的元資料索引是什麼?

元資料索引會提取並儲存文件屬性(例如作者、建立日期、自訂標籤)於可搜尋的結構中。當您 add documents to index 時,引擎會記錄這些屬性,讓您能執行精確查詢,如「找出所有由 John Doe 撰寫的 PDF」或「依作者搜尋 PDF」。

為何使用 GroupDocs.Search 進行元資料索引?

即使索引包含數百萬筆記錄,GroupDocs 的元資料搜尋仍能提供輕量級、次秒級的回應時間。它支援 over 30 input and output formats——包括 PDF、DOCX、PPTX、HTML 及影像檔,且在一般伺服器上,對 100 000 份文件的索引僅消耗不到 200 MB 的堆積記憶體。

前置條件

  • GroupDocs.Search for Java ≥ 25.4。
  • 已安裝並設定 JDK 8 或更新版本。
  • 具備 Java 與 Maven 的基本知識。

設定 GroupDocs.Search for Java

安裝說明

Add the GroupDocs repository and dependency to your pom.xml:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

您也可以直接從 GroupDocs.Search for Java releases 下載最新的二進位檔。

取得授權

取得測試用臨時授權的步驟:

  1. 前往 GroupDocs 官方網站並前往 Purchase 版塊。
  2. 選擇符合您評估需求的 temporary license 計畫。

如何設定元資料的索引參數?

設定索引參數可告訴引擎要提取與儲存哪些資訊。將索引類型設為 MetadataIndex 後,您指示 GroupDocs.Search 專注於元資料欄位而非全文內容,從而減少索引大小並加快查詢速度。此設定透過 IndexSettings 物件套用,您亦可於其中指定要索引的自訂元資料欄位。

IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);

功能 1:索引設定配置

setIndexType(IndexType.MetadataIndex) 呼叫告訴引擎專注於元資料而非全文內容。IndexType.MetadataIndex 是一個列舉值,用於選擇僅索引元資料的模式。

import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.IndexType;

// Initialize index settings
IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);  // Focus on metadata indexing

功能 2:在指定資料夾建立索引

建立一個實體索引目錄以儲存所有元資料:

import com.groupdocs.search.Index;

String YOUR_INDEX_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY\\\\output\\\\AdvancedUsage\\\\Indexing\\\\IndexingMetadataOfDocuments";

// Create index in specified directory using settings
Index index = new Index(YOUR_INDEX_DIRECTORY, settings);

將 YOUR_DOCUMENT_DIRECTORY 替換為符合您專案結構的路徑。

功能 3:如何將文件加入索引

index.add 方法會將資料夾中的檔案加入索引並提取其元資料。index.add 會掃描每個文件,讀取支援的元資料欄位,並將其儲存於索引中以供快速檢索。

String YOUR_DOCUMENTS_FOLDER = "YOUR_DOCUMENT_DIRECTORY";

// Add all documents in directory to the index
index.add(YOUR_DOCUMENTS_FOLDER);

Tips:

  • 確認資料夾路徑正確且應用程式具備讀取權限。
  • GroupDocs.Search 會自動從每個檔案提取支援的元資料。

功能 4:依元資料搜尋文件

執行針對元資料欄位的查詢,例如搜尋語言為英文的文件:

import com.groupdocs.search.results.SearchResult;

String query = "English";  // Define search query
SearchResult result = index.search(query);  // Perform the search

// Process results (example)
for (int i = 0; i < result.getDocumentCount(); i++) {
    System.out.println("Found document: " + result.getFoundDocument(i).getFilePath());
}

search(query) 方法會在已索引的元資料中搜尋並回傳符合的文件。您亦可透過使用作者名稱作為查詢字串,search pdf by author。

實務應用

  1. Enterprise document management: 依合約日期或簽署人姓名檢索合約。
  2. Digital library catalogs: 讓使用者依類別、出版年份或作者瀏覽書籍。
  3. CRM systems: 使用客戶 ID 或區域等自訂元資料快速定位客戶檔案。

小技巧與最佳實踐

  • Incremental updates: 使用 index.addOrUpdate() 針對新增或變更的檔案,而非重新建構整個索引。
  • Batch processing: 處理數千檔案時,將檔案分批加入,以降低記憶體使用量。
  • Metadata validation: 確認來源文件實際包含您欲查詢的元資料(例如 PDF 中的作者欄位)。

效能考量

  • Memory tuning: 根據已索引元資料的量調整 JVM 堆積大小 (-Xmx)。
  • Optimized storage: 定期呼叫 index.optimize() 以壓縮索引並提升查詢速度。

常見問題與解決方案

問題解決方案
未返回結果確認您預期的元資料欄位確實存在於來源檔案中。
權限錯誤確保 Java 程序對文件資料夾與索引目錄皆具有讀取權限。
記憶體不足錯誤增加 JVM 堆積大小或將 add 操作分批處理,以較小群組處理檔案。

常見問答

Q: 元資料索引是什麼?
Metadata indexing stores document attributes (author, title, custom tags) in a searchable structure, enabling fast look‑ups without scanning full text.

A: 元資料索引將文件屬性(作者、標題、自訂標籤)儲存於可搜尋的結構中,讓您能在不掃描全文的情況下快速查詢。

Q: 如何取得臨時授權?
Visit the GroupDocs purchase page and follow the steps to acquire a trial license.

A: 前往 GroupDocs 購買頁面,依照步驟取得試用授權。

Q: 我可以使用此設定索引 PDF 嗎?
Yes, GroupDocs.Search supports PDF, DOCX, PPT, and many other formats.

A: 是的,GroupDocs.Search 支援 PDF、DOCX、PPT 以及許多其他格式。

Q: 加入文件時常見的問題是什麼?
Verify correct file paths and ensure the application has read permissions for the directories.

A: 確認檔案路徑正確,並確保應用程式對目錄具有讀取權限。

Q: 如何優化搜尋效能?
Regularly update your index, use incremental adds, and tune JVM memory settings.

A: 定期更新索引,使用增量加入,並調整 JVM 記憶體設定。

資源


最後更新時間: 2026-10-22
測試環境: GroupDocs.Search Java 25.4
作者: GroupDocs

相關教學