如何使用 GroupDocs.Search Java 更新索引與新增文件

有效管理搜尋索引對於任何需要快速、精確資訊檢索的 Java 應用程式而言都是必不可少的。在本教學中,您將學習 如何更新索引,以及如何使用 GroupDocs.Search for Java 新增與刪除文件。您將看到最佳實踐模式、效能技巧以及真實案例範例,讓您的索引保持精簡,查詢速度如閃電般迅速。

快速回答

  • 什麼是將文件新增至索引的第一步? 建立或開啟 Index 實例,然後呼叫 addDocument(...)。
  • 我可以從索引中移除文件嗎? 可以,使用文件的識別碼呼叫 deleteDocument(...)。
  • 我需要特殊授權嗎? 生產環境使用需具備有效的 GroupDocs.Search for Java 授權。
  • 支援哪個 Java 版本? 完全支援 Java 8 及以上版本。
  • 在哪裡可以找到更多範例? 請參閱官方的 GroupDocs.Search for Java 文件與 API 參考。

在 GroupDocs.Search 中「將文件新增至索引」是什麼?

addDocument 操作會將檔案(PDF、DOCX、TXT 等)的可搜尋內容插入索引資料結構。這使得文件可立即被查詢,並確保後續的更新或刪除與來源檔案保持同步。它同時會記錄檔名、大小等中繼資料,可用於過濾搜尋結果。

為何在 Java 文件管理專案中使用 GroupDocs.Search?

GroupDocs.Search 可處理高達 1,000 萬文件,且延遲低於一秒,支援 100 多種檔案格式,並提供內建的相關性調整。API 輕量,只需幾行程式碼,即可順利整合至任何 Java 應用程式——無論是桌面、伺服器或雲端環境。

前置條件

  • Java 8 + 開發環境(IDE、JDK、Maven/Gradle)。
  • GroupDocs.Search for Java 程式庫(從官方網站下載)。
  • 有效的 GroupDocs.Search 授權(可取得測試用臨時授權)。

如何在 GroupDocs.Search for Java 中將文件新增至索引?

載入目標檔案並在 Index 實例上呼叫 addDocument——此單一呼叫會擷取文字、偵測語言,並儲存可搜尋的詞彙。此方法同時回傳文件 ID,您應將其保存以供未來的更新或刪除操作使用。

Index 類別是代表儲存在磁碟上的可搜尋集合的核心物件。建立後,所有後續操作——新增、更新、刪除與最佳化——皆透過此實例執行。

步驟 1:開啟或建立索引

Index index = new Index("path/to/index");

Index index = new Index("path/to/index"); 會在資料夾不存在時自動建立,並準備內部結構以加速查詢。

步驟 2:新增單一文件

index.addDocument(new File("contracts/contract1.pdf")); 會插入 PDF,並自動偵測其格式與擷取文字。

步驟 3:批次新增多個文件

遍歷目錄,對每個檔案呼叫 addDocument。批次處理可減少 I/O 開銷,提升整體吞吐量。

當來源檔案變更時,如何更新索引?

updateDocument 會使用其識別碼更新索引中已存在的文件。透過呼叫此方法並傳入您首次新增檔案時取得的相同文件識別碼,即可以最新版本取代舊內容。此操作僅重寫變更的詞彙,保持其餘索引不受影響,以達到最高效能。

步驟說明更新

  1. 取得文件 ID(在首次新增檔案時儲存)。
  2. 呼叫 index.updateDocument(documentId, new File("contracts/contract1_v2.pdf")); 以刷新條目。
  3. 大量更新後,可選擇再次執行 index.optimize(),以保持索引緊湊。

如何安全地刪除索引條目?

deleteDocument 會依據識別碼從索引中移除文件。刪除文件可釋放儲存空間,並防止過時資料影響相關性分數。使用該識別碼呼叫 deleteDocument 後,索引會立即將檔案排除於未來的搜尋,並更新內部倒排清單以維持查詢效能。

如何最佳化索引以達到峰值效能?

optimize() 透過合併段落與清除已刪除的條目來壓縮索引。大量新增、更新或刪除後,呼叫此方法可壓縮倒排清單並重新組織儲存結構。此步驟可將大型索引的查詢延遲降低最多 30 %,並有助於維持索引大小在可管理範圍。

常見使用案例

  • 法律文件庫: 新增、更新與清除案件檔案,同時保持關鍵字搜尋的高相關性。
  • 企業知識庫: 隨著內容演變,保持內部手冊、政策與常見問題的可搜尋性。
  • 電子商務目錄: 索引產品規格,並在不中斷服務的情況下移除已停產項目。

疑難排解與技巧

  • 專業提示: 在非高峰時段批次新增文件,以避免效能突增。
  • 常見陷阱: 大量刪除後未執行 optimize() 可能導致索引碎片化,查詢變慢。
  • 錯誤處理: 將所有索引操作包在 try‑catch 區塊中,以優雅地處理 IndexException。
  • 效能提示: 使用 IndexSettings 調整記憶體使用量,處理極大資料集時(例如在具備充足 RAM 的伺服器上將 maxMemoryUsage 設為較高值)。
  • 記憶體安全: 對於超過 500 MB 的檔案,建議以串流方式傳入 addDocument,以降低 JVM 堆積佔用。

常見問答

Q: 我該如何從索引中移除文件?
A: 使用唯一識別碼呼叫 deleteDocument(documentId);條目會立即被清除,且釋放儲存空間。

Q: 我可以修改文件屬性以提升搜尋精確度嗎?
A: 可以,在將文件加入索引前,透過 Document 物件的屬性 API 設定自訂中繼資料(例如類別、作者)。

Q: 有適合初學者的「搜尋索引教學」嗎?
A: 官方的 GroupDocs.Search 文件包含一步步的教學,涵蓋索引建立、文件新增與查詢執行。

Q: GroupDocs.Search 是否支援同音字辨識?
A: 此函式庫內建語言特性,可提升同音字與相似發音詞彙的搜尋精確度。

Q: 最新的 GroupDocs.Search 需要哪個版本的 Java?
A: 需要 Java 8 或更高版本;此函式庫完全相容於 Java 11 及更新的 LTS 版本。

可用教學

如何更新與管理 GroupDocs.Search for Java: 完整指南

了解如何使用 GroupDocs.Search for Java 高效地更新與管理索引版本。本指南涵蓋文件索引、版本更新與效能最佳化。

精通 GroupDocs.Search for Java: 同音字辨識與索引指南

學習如何使用 GroupDocs.Search for Java 管理文件,重點在同音字辨識與高效索引。提升搜尋精確度與效能。

精通 GroupDocs.Search 在 Java 中的文件屬性:提升索引與管理

了解如何使用 GroupDocs.Search for Java 動態修改與新增文件屬性。透過精通索引技術,提升文件管理系統。

精通 GroupDocs.Search in Java: 索引管理與文件搜尋完整指南

了解如何使用 GroupDocs.Search for Java 有效管理文件索引。提升在各類文件(從法律文件到商業報告)的搜尋能力。

其他資源


最後更新: 2026-10-12
測試環境: GroupDocs.Search for Java 23.11
作者: GroupDocs

相關教學