如何在 Java 中使用 GroupDocs.Search 的同義詞

如果您希望使用者即使輸入不同的詞彙仍能找到正確的內容,search with synonyms就是答案。在本指南中,您將學習如何建立同義詞字典、匯入或匯出它、管理同義詞群組,並執行自動使用這些同義詞擴展查詢的搜尋。無論您是在建構 CMS、電子商務目錄,或是法律文件庫,加入同義詞支援都能顯著提升相關性與轉換率。

快速答案

  • 添加同義詞的第一步是什麼? 建立 Index 實例並使用 SynonymDictionary API。
  • 我可以匯入現成的同義詞字典嗎? 是的 – 呼叫 importDictionary(path) 並提供檔案位置。
  • 如何開啟支援同義詞的搜尋? 啟用 SearchOptions.setUseSynonymSearch(true)。
  • 是否可以在執行時編輯同義詞群組? 當然可以 – 您可以透過字典 API 清除、加入或取得群組。
  • 在擴充索引時應該監控什麼? 定期清除未使用的條目,並針對大型同義詞檔案調整 JVM 堆積大小。

什麼是 search with synonyms?

Search with synonyms 意味著引擎將一組詞彙或片語視為可互換。當使用者輸入 “better” 時,引擎也會搜尋 “improve”、“enhance” 或您在同一同義詞群組中定義的任何其他詞彙,提供更豐富的結果而不改變使用者的查詢。

為什麼在 GroupDocs.Search 中啟用同義詞支援?

啟用同義詞支援可讓引擎自動擴展查詢,包含等價的詞彙,從而提升結果相關性、增加使用者滿意度,並有助於提升電子商務或內容導向網站的轉換率。它同時集中管理術語,減少跨多個應用程式的維護負擔。

前置條件

  • GroupDocs.Search for Java 版本 25.4 或更新。
  • 具備 Maven 支援的 Java IDE(IntelliJ IDEA、Eclipse 等)。
  • 基本的 Java 知識以及熟悉 Maven 專案結構。

必要的函式庫與版本

  • GroupDocs.Search for Java 25.4 或以上。

環境設定

  • 您選擇的 IDE(IntelliJ IDEA、Eclipse 等)。
  • Maven 用於相依性管理。

知識需求

  • Java 的物件導向程式設計。
  • 基本的檔案 I/O 操作。

設定 GroupDocs.Search for Java

安裝資訊

將儲存庫與相依性加入您的 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 下載最新的 JAR。

取得授權

  • 免費試用:在未取得授權的情況下測試核心功能。
  • 臨時授權:在評估期間延長試用功能。
  • 購買:生產環境使用及完整功能集所必需。

基本初始化與設定

建立 Index 實例,然後加入可搜尋的文件:

import com.groupdocs.search.*;

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Index";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath2";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Adding documents from a specific folder to the index
index.add(documentsFolder);

如何將同義詞加入搜尋索引

功能 1:建立與索引索引

Index 類別代表儲存在磁碟或記憶體中的可搜尋文件集合。

// Create an index in the specified folder
Index index = new Index(indexFolder);

// Add documents from the given folder to the index
index.add(documentsFolder);

功能 2:取得單字的同義詞

SynonymDictionary 管理同義詞群組,並提供查詢詞彙同義詞的方法。

String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");

功能 3:取得同義詞群組

SynonymDictionary.getGroups() 會回傳所有已定義同義詞群組及其識別碼的列表。

String[][] synonymGroups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");

功能 4:管理同義詞字典條目

add(word, synonym) 將新的同義詞關係插入字典。clear() 會移除所有條目,remove(word) 則刪除字典中特定的詞彙。

if (index.getDictionaries().getSynonymDictionary().getCount() > 0) {
    index.getDictionaries().getSynonymDictionary().clear();
}

String[][] newSynonymGroups = new String[][]{
    new String[] { "achieve", "accomplish", "attain", "reach" },
    new String[] { "accept", "take", "have" },
    new String[] { "improve", "better" }
};

index.getDictionaries().getSynonymDictionary().addRange(newSynonymGroups);

功能 5:將同義詞匯出至檔案

exportDictionary(path) 將目前的同義詞字典寫入指定位置的二進位 .dat 檔案。

String exportFilePath = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Synonyms.dat";
index.getDictionaries().getSynonymDictionary().exportDictionary(exportFilePath);

功能 6:從檔案匯入同義詞

importDictionary(path) 會載入先前匯出的 .dat 檔案至同義詞字典。

index.getDictionaries().getSynonymDictionary().importDictionary(exportFilePath);

功能 7:執行支援同義詞的搜尋

SearchOptions 設定查詢行為,包括是否啟用同義詞擴展。setUseSynonymSearch(true) 為即將執行的查詢開啟同義詞感知搜尋。

String query = "better";
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);

SearchResult result = index.search(query, options);

如何使用同義詞搜尋

載入您的 Index,啟用同義詞搜尋,並執行查詢。引擎會自動使用您建立或匯入的同義詞字典擴展查詢,回傳所有相關詞彙的匹配結果。

如何匯入同義詞字典

如果您已經有其他環境準備好的 .dat 檔案,只需呼叫 importDictionary(path)。這非常適合在開發、測試與生產伺服器之間同步字典。

如何管理同義詞群組

同義詞群組讓您將一組詞彙視為單一邏輯實體。加入、清除或取得群組皆透過 SynonymDictionary API 完成,如上方程式碼片段所示。

如何最佳化搜尋索引

  • 定期清除未使用的條目:在大量更新前使用 clear()。
  • 調整 JVM 堆積:大型字典可能需要更多記憶體,請相應增加 -Xmx 參數。
  • 保持函式庫為最新:新版本包含效能提升與錯誤修正。

實務應用

  1. 內容管理系統 (CMS): 使用者即使使用替代術語也能找到文章。
  2. 電子商務平台: 產品搜尋能容忍同義詞,例如 “laptop” 與 “notebook”。
  3. 文件庫: 法律或醫療檔案可受益於領域特定的同義詞群組,提升專業人員的可發現性。

效能考量

  • 最佳化索引儲存:定期重建索引以移除過時資料。
  • 管理記憶體使用:載入大型同義詞檔案時監控堆積消耗;500 MB 的字典通常需要在 64 位元 JVM 上配置 2 GB 堆積。
  • 定期更新:使用最新的 GroupDocs.Search 版本以獲得錯誤修正與效能提升。

常見問題與解決方案

問題可能原因解決方案
未出現同義詞匹配setUseSynonymSearch(true) 未設定或字典未匯入確認已啟用此選項且字典檔案存在。
匯入期間發生記憶體不足錯誤非常大的 .dat 檔案超出 JVM 堆積增加 -Xmx 堆積大小或分批匯入較小檔案。
結果中出現重複條目相同詞彙出現在多個同義詞群組中使用 clear() 後再 addRange() 合併重疊的群組。

常見問答

Q: 使用 GroupDocs.Search 的最低系統需求是什麼?
A: 任何具備相容 JDK(Java 8 或更新版)的現代作業系統皆可。

Q: 我應該多久刷新一次同義詞字典?
A: 每當有新術語出現時即更新——使用 clear() 後接 addRange() 進行全新刷新。

Q: 我可以在未購買授權的情況下執行 GroupDocs.Search 嗎?
A: 免費試用可用於評估,但生產環境部署需要授權。

Q: 索引大型資料集的最佳實踐是什麼?
A: 將資料分割成邏輯批次,監控堆積使用,並安排定期的索引維護。

Q: 我未看到預期的同義詞匹配——應該檢查什麼?
A: 確認字典已正確匯入、setUseSynonymSearch(true) 已啟用,且詞彙已存在於同義詞群組中。

資源


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

相關教學