在 Java 中使用 GroupDocs.Search 同义词

如果您希望用户即使输入不同的词语也能找到正确的内容,同义词搜索就是答案。在本指南中,您将学习如何创建同义词词典、导入或导出词典、管理同义词组,以及运行自动使用这些同义词扩展查询的搜索。无论您是在构建 CMS、电子商务目录,还是法律文档库,添加同义词支持都能显著提升相关性和转化率。

快速答案

  • 添加同义词的第一步是什么? 创建一个 Index 实例并使用 SynonymDictionary API。
  • 我可以导入现成的同义词词典吗? 可以——调用 importDictionary(path) 并提供文件位置。
  • 如何开启同义词感知搜索? 启用 SearchOptions.setUseSynonymSearch(true)。
  • 是否可以在运行时编辑同义词组? 当然——您可以通过词典 API 清除、添加或检索组。
  • 在扩展索引时应监控哪些内容? 定期清理未使用的条目,并为大型同义词文件调优 JVM 堆内存。

什么是同义词搜索?

同义词搜索意味着引擎将一组词语或短语视为可互换。当用户输入 “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

相关教程