將文件新增至索引以支援 GroupDocs 的分面搜尋 Java

在本指南中，您將學習如何將文件新增至索引，以便使用 GroupDocs.Search 提供 faceted search java‑風格的體驗。結構良好的索引不僅能加快查詢速度，還能啟用進階過濾功能，例如 document filtering java、file extension filtering java 以及精確的日期範圍查詢。完成本教學後，您將能為大型 Java 文件集合構建快速、可擴展的搜尋解決方案。

快速解答

  • 什麼是「add documents to index」？ 它表示將一個或多個檔案插入由 GroupDocs.Search 建立的可搜尋資料結構中。
  • 需要哪個 Java 版本？ 完全支援 Java 8 或更高版本。
  • 開發時需要授權嗎？ 臨時授權可用於測試；正式環境需購買商業授權。
  • 索引時可以依檔案類型過濾嗎？ 可以——使用 file extension filtering java 來包含或排除特定格式。
  • 索引後可以進行日期範圍搜尋嗎？ 當然可以，您可以對已索引的中繼資料執行日期範圍查詢。

「add documents to index」在 GroupDocs.Search 中是什麼？

將檔案載入索引會立即建立可搜尋的條目。當您新增文件時，GroupDocs.Search 會擷取原始文字、建立倒排索引，並儲存任何提供的中繼資料，以便之後的查詢（例如 faceted search java）能在毫秒內取得結果。此操作是所有後續過濾或分面導覽的基礎。

為何在 Java 索引時使用 GroupDocs.Search？

GroupDocs.Search 可處理多達 5 百萬文件，記憶體佔用低於 200 MB，適合企業工作負載。它支援超過 50 種輸入與輸出格式，允許您附加自訂中繼資料（作者、建立日期、標籤），並內建 document filtering java 與 file extension filtering java，以在索引期間排除不需要的檔案。引擎可在本地或雲端執行，提供一致的效能。

前置條件

  • 已安裝 Java 8 或更新版本。
  • 已在專案中加入 GroupDocs.Search for Java 函式庫（Maven/Gradle）。
  • 臨時或完整授權金鑰（請參閱下方 Additional Resources）。

如何使用 GroupDocs.Search Java 新增文件至索引？

Index 類別管理可搜尋的集合，儲存倒排索引與相關中繼資料。載入檔案後，可選擇性加入作者或建立日期等中繼資料，設定過濾條件，然後提交變更——只需幾個簡單步驟，即可確保新文件立即可搜尋。

步驟 1：初始化索引資料夾

在磁碟上建立一個資料夾，用於保存索引檔案。重複使用同一資料夾可在多次執行時直接追加新文件，而無需重新建構整個索引。

步驟 2：設定可選的索引設定

您可以啟用中繼資料擷取、設定語言選項，或定義自訂分析器。這些設定會影響分詞以及 faceted search java 如何解讀欄位值。

步驟 3：將文件新增至索引

Index.add 會將一個或多個文件加入索引，更新倒排清單並儲存任何提供的中繼資料。將檔案路徑（或串流）清單傳遞給 Index.add。函式庫會自動偵測檔案類型、擷取文字並更新索引。此階段您亦可套用 document filtering java 規則，跳過不符合業務條件的檔案。

步驟 4：提交變更

呼叫 Index.commit() 會將所有待處理的更新寫入磁碟，確保新加入的文件立即可搜尋。

步驟 5：驗證索引

執行簡單的萬用字元查詢（例如 *），確認最近新增的文件出現在結果中。此快速的健全性檢查有助於及早發現索引錯誤。

為何這很重要

在堅實的索引之上實作 faceted search java，可讓最終使用者僅點擊一次，即可依類別、日期或自訂標籤深入篩選。由於索引已包含所需的中繼資料，引擎能在次秒內回應這些查詢，即使底層集合包含數十萬檔案亦不例外。

常見使用情境

  • 企業文件入口網站，使用者需要跨合約、政策與報告進行搜尋。
  • 法律電子發現 解決方案，需要對大量案件檔案進行精確的日期範圍過濾。
  • 內容管理系統，必須使用 file extension filtering java 排除非文字檔案。

疑難排解與技巧

  • 大型檔案：增加 JVM 記憶體或啟用串流模式以避免 OutOfMemory 錯誤。
  • 不支援的格式：確認該檔案類型列於 GroupDocs.Search 支援的格式清單中；若未列出，請自行加入自訂解析器。
  • 效能瓶頸：批次新增文件而非逐一新增，以減少 I/O 開銷。
  • 專業提示：將常用搜尋的中繼資料（例如建立日期）儲存為獨立的索引欄位，以加速日期範圍查詢。

可用教學

基於區塊的文件搜尋（Java）: 使用 GroupDocs.Search 的完整指南

了解如何使用 GroupDocs.Search for Java 實作高效的區塊式文件搜尋，提升生產力並無縫管理大型資料集。

Java 中的分面與複雜搜尋: 精通 GroupDocs.Search 進階功能

學習在 Java 應用程式中實作分面與複雜搜尋，提升搜尋功能與使用者體驗。

實作 GroupDocs.Search Java: 完整的索引與報告指南

精通 GroupDocs.Search 在 Java 中的文件索引與報告，學會建立索引、加入文件與產生報告。

精通 Java 中的日期範圍搜尋（使用 GroupDocs.Search）

GroupDocs.Search Java 的程式碼教學。

精通 GroupDocs.Search Java: 高效資料檢索的進階搜尋功能

學習在 GroupDocs.Search for Java 中掌握進階搜尋功能，包括錯誤處理、各種查詢類型與效能最佳化。

精通 Java 檔案過濾（使用 GroupDocs.Search）: 步驟指南

了解如何在 Java 中使用 GroupDocs.Search 高效管理與過濾檔案，包括副檔名、邏輯運算子等。

精通 GroupDocs.Search for Java: 文件索引與搜尋的完整指南

全面掌握在 Java 中實作 GroupDocs.Search，探索強大的文字擷取、序列化、索引與搜尋功能。

其他資源

常見問答

Q: 可以在不重新建構的情況下將文件新增至現有索引嗎？
A: 可以。GroupDocs.Search 支援增量索引；只需使用新檔案呼叫 add 方法，然後提交變更即可。

Q: file extension filtering java 在索引期間如何運作？
A: 您可以提供白名單或黑名單的副檔名（例如 .pdf、.docx）。引擎在您將文件新增至索引時，只會包含符合條件的檔案。

Q: 索引後可以依日期範圍過濾搜尋結果嗎？
A: 絕對可以。將文件的建立或修改日期作為中繼資料儲存，之後使用日期範圍查詢即可取得符合的項目。

Q: 若嘗試新增受損檔案會發生什麼情況？
A: 函式庫會拋出 DocumentProcessingException。請將 add 呼叫包在 try‑catch 區塊，並記錄檔案路徑以供日後檢查。

Q: 更改分析器設定時需要重新索引嗎？
A: 需要。分析器的變更會影響分詞，完整的重新索引可確保所有文件的一致性。

最後更新： 2026-08-26
測試環境： GroupDocs.Search for Java 23.12
作者： GroupDocs

相關教學