掌握 GroupDocs.Search for Java 的搜尋索引管理

在當今以數據為驅動的應用程式中，搜尋索引管理是快速且精確文件檢索的基礎。無論您是構建企業知識庫還是法律文件倉庫，良好結構的索引都能讓您在毫秒內定位資訊。本教程將展示如何設定 GroupDocs.Search for Java、建立可搜尋的索引、將文件加入索引，以及微調搜尋選項最佳化，以獲得高效的文件搜尋體驗。

快速解答

  • 開始使用 GroupDocs.Search 的第一步是什麼？ 在您的 pom.xml 中加入 GroupDocs Maven 依賴，並初始化庫。
  • 如何建立新的搜尋索引？ 使用資料夾路徑實例化 SearchIndex，然後呼叫 create() —— 只需一行程式碼。
  • 我可以一次加入多個文件嗎？ 可以，使用 index.addFolder(documentsFolder) 進行批量載入。
  • 什麼功能能處理詞形變化？ 在 SearchOptions 中設定自訂的 WordFormsProvider 並啟用它。
  • 在哪裡可以找到最新的 GroupDocs.Search 版本？ 在官方發行頁面上： GroupDocs.Search for Java releases。

什麼是搜尋索引管理？

搜尋索引管理是指建立、更新與維護可搜尋資料結構的過程，該結構將文件內容映射到可搜尋的詞彙。妥善的管理可確保在大型文件集合中快速的查詢回應時間與即時的結果。

為什麼使用 GroupDocs.Search for Java？

GroupDocs.Search 支援 超過 50 種檔案格式（包括 DOCX、PDF、XLSX、PPTX、HTML 以及常見的影像類型），且能在不將整個檔案載入記憶體的情況下索引數百頁的文件，為小於 1 GB 的索引提供 次秒級查詢延遲。其內建語言工具，如自訂詞形提供者，讓您在多語言環境中獲得 99 % 的查詢相關性。

前置條件

  • Java Development Kit (JDK) 8 或更新版本。
  • Maven 用於相依管理。
  • GroupDocs.Search for Java 版本 25.4 或更新（建議使用最新版本）。

必要的函式庫、版本與相依性

  1. GroupDocs.Search for Java – 版本 25.4+。
  2. Maven 設定 – 在您的 pom.xml 中加入 GroupDocs 儲存庫與相依性：
<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 下載最新版本。

環境設定需求

  • 已安裝 JDK 8+ 並設定 JAVA_HOME。
  • 命令列可使用 Maven 3.6+。

知識前提

  • 基本的 Java 程式設計（類別、方法與例外處理）。
  • 熟悉索引、分詞與搜尋查詢等概念。

如何設定 GroupDocs.Search for Java？

載入 GroupDocs.Search 函式庫，指向索引的資料夾，並可選擇套用授權。此準備僅需幾行程式碼，即可確保引擎能有效索引與查詢文件，並以最小記憶體開銷處理大量檔案。Index 類別代表儲存在磁碟上的可搜尋索引，並提供加入文件與查詢的相關方法。

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Initialize an index in a specified folder
        String indexFolder = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/Index";
        Index index = new Index(indexFolder);
        
        System.out.println("GroupDocs.Search is set up and ready!");
    }
}

如何建立與管理搜尋索引？

建立新的索引資料夾，然後從來源目錄填入文件。SearchIndex 類別是核心元件，代表記憶體與磁碟上的索引，讓您能在不重新建構整個結構的情況下加入、刪除或更新文件。

import com.groupdocs.search.*;

// Specify the path where the index will be stored
String indexFolder = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/Index";
Index index = new Index(indexFolder);
  • 目的：在指定目錄中初始化新的搜尋索引。
// Specify the directory containing documents to index
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";

index.add(documentsFolder);
  • 說明：將 documentsFolder 中的所有文件加入新建立的索引。此步驟對於填充可搜尋內容的索引至關重要。

如何設定自訂詞形提供者？

自訂詞形提供者告訴引擎如何處理詞彙的不同語法變形（例如 “run”、 “running”、 “ran”）。註冊這些變形後，搜尋引擎即可將查詢匹配至所有相關形式，顯著提升使用者輸入任何形態變化詞彙時的相關性。

import com.groupdocs.search.*;

// Set the custom word forms provider instance
index.getDictionaries().setWordFormsProvider(new SimpleWordFormsProvider());
  • 目的：透過了解與管理詞彙的不同語法變形來增強搜尋，提升搜尋相關性。

如何啟用詞形搜尋選項？

SearchOptions 讓您切換模糊匹配、大小寫敏感度與詞形處理等功能。啟用詞形旗標可確保引擎將查詢展開至所有已註冊的形式，提供更自然的搜尋行為與更高的召回率，同時不犧牲精確度。SearchOptions 類別設定查詢的處理方式，例如啟用詞形展開或模糊匹配。

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;

// Create a SearchOptions instance
SearchOptions options = new SearchOptions();
options.setUseWordFormsSearch(true);
  • 說明：此設定允許搜尋辨識不同的詞形，使搜尋更直觀且完整。

如何使用詞形設定執行搜尋？

定義查詢字串，並使用先前設定的 SearchOptions 執行搜尋。引擎會自動將查詢展開至所有匹配的詞形，返回涵蓋搜尋詞彙每個形態變化的結果，提升使用者滿意度。SearchResult 物件包含查詢返回的命中結果，包括匹配的片段與相關性分數。

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;
import com.groupdocs.search.results.*;

// Define the query for searching word forms
String query = "mrs";

// Perform a search using the specified query and options
SearchResult result = index.search(query, options);
  • 目的：執行考慮詞彙 “mrs” 各種語法變形的搜尋，提升搜尋精確度。

常見使用案例

  1. 企業文件管理 – 索引成千上萬的政策文件、合約與報告，讓員工即時定位資訊。
  2. 法律研究 – 處理案例法資料庫中的複雜術語與同義詞，確保律師找到所有相關判例。
  3. 數位圖書館 – 為讀者提供跨書籍、文章與多媒體中繼資料的自然語言搜尋。

效能考量

  • 索引頻率 – 每晚排程增量更新，以保持索引新鮮且不需重新處理整個語料庫。
  • 記憶體佔用 – 對於大於 2 GB 的索引，啟用 MemoryMapped 模式以僅在 RAM 中保留必要的中繼資料。
  • 批次處理 – 以 500–1 000 份為一批加入文件，以減少 I/O 開銷並提升吞吐量。

疑難排解技巧

  • 搜尋無結果 – 確認索引資料夾包含最新檔案，且 SearchOptions 的 enableWordForms 已設為 true。
  • 記憶體不足錯誤 – 增加 JVM 堆積大小（-Xmx2g）或切換至 MemoryMapped 索引。
  • 詞形不正確 – 確保自訂的 WordFormsProvider 註冊所有必要的變形；您可在啟動時記錄提供者的字典以進行驗證。

常見問與答

Q: GroupDocs.Search 如何處理大型資料集？
A: 它使用增量索引與記憶體映射檔案，讓您能在 RAM 使用量低於 1 GB 的情況下索引數百萬文件。

Q: 我可以自訂詞形超出預設提供者嗎？
A: 可以，實作 IWordFormsProvider 並在 SearchOptions 中註冊，以提供您自己的形態規則。

Q: GroupDocs.Search 的系統需求是什麼？
A: JDK 8+ 與 Maven 3.6+；此函式庫可在任何支援 Java 的作業系統上執行（Windows、Linux、macOS）。

Q: 如何提升同義詞的搜尋相關性？
A: 將同義詞映射加入自訂詞形提供者，或透過 SearchOptions 啟用內建同義詞字典。

Q: 若遇到問題，我可以從哪裡取得支援？
A: 前往 GroupDocs Support Forum 獲取社群協助與官方支援。

資源

最後更新： 2026-06-22
測試環境： GroupDocs.Search 25.4 for Java
作者： GroupDocs

相關教學