Как использовать синонимы в Java с GroupDocs.Search

Если вы хотите, чтобы ваши пользователи находили нужный контент, даже вводя разные слова, поиск с синонимами — это решение. В этом руководстве вы узнаете, как создать словарь синонимов, импортировать или экспортировать его, управлять группами синонимов и выполнять поиск, который автоматически расширяет запросы с использованием этих синонимов. Независимо от того, создаёте ли вы CMS, каталог электронной коммерции или репозиторий юридических документов, добавление поддержки синонимов может существенно повысить релевантность и коэффициенты конверсии.

Быстрые ответы

  • Что является первым шагом для добавления синонимов? Создайте экземпляр Index и работайте с API SynonymDictionary.
  • Могу ли я импортировать готовый словарь синонимов? Да — вызовите importDictionary(path) с указанием пути к файлу.
  • Как включить поиск с учётом синонимов? Включите SearchOptions.setUseSynonymSearch(true).
  • Можно ли редактировать группы синонимов во время выполнения? Абсолютно — вы можете очищать, добавлять или получать группы через API словаря.
  • Что следует контролировать при масштабировании индекса? Регулярно удаляйте неиспользуемые записи и настраивайте heap JVM для больших файлов синонимов.

Что такое поиск с синонимами?

Поиск с синонимами означает, что движок рассматривает набор слов или фраз как взаимозаменяемые. Когда пользователь вводит «better», движок также ищет «improve», «enhance» или любой другой термин, определённый в той же группе синонимов, предоставляя более полные результаты без изменения запроса пользователя.

Зачем включать поддержку синонимов в GroupDocs.Search?

Включение поддержки синонимов позволяет движку автоматически расширять запросы, включая эквивалентные термины, что повышает релевантность результатов, увеличивает удовлетворённость пользователей и может повысить коэффициенты конверсии для сайтов электронной коммерции или контентных ресурсов. Это также централизует управление терминологией, снижая нагрузку на обслуживание в разных приложениях.

Предварительные требования

  • GroupDocs.Search for Java версии 25.4 или новее.
  • Java IDE (IntelliJ IDEA, Eclipse и т.д.) с поддержкой Maven.
  • Базовые знания Java и знакомство со структурой Maven‑проекта.

Требуемые библиотеки и версии

  • GroupDocs.Search for Java 25.4 или выше.

Настройка окружения

  • IDE по вашему выбору (IntelliJ IDEA, Eclipse и т.д.).
  • Maven для управления зависимостями.

Требования к знаниям

  • Объектно‑ориентированное программирование в Java.
  • Базовые операции ввода‑вывода файлов.

Настройка GroupDocs.Search для 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>

Прямое скачивание — вы также можете загрузить последнюю JAR с GroupDocs.Search for Java releases.

Приобретение лицензии

  • Free trial: Тестируйте основные функции без лицензии.
  • Temporary license: Расширьте возможности пробного периода во время оценки.
  • Purchase: Требуется для использования в продакшене и полного набора функций.

Базовая инициализация и настройка

Создайте экземпляр 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). Это идеальный способ синхронизации словарей между средами разработки, тестирования и продакшена.

Как управлять группами синонимов

Группы синонимов позволяют рассматривать набор терминов как единую логическую сущность. Добавление, очистка или получение групп осуществляется через API SynonymDictionary, как показано в приведённых выше фрагментах кода.

Как оптимизировать поисковый индекс

  • Регулярно удаляйте неиспользуемые записи: Используйте clear() перед массовыми обновлениями.
  • Настройте heap JVM: Большие словари могут требовать больше памяти; соответственно увеличьте параметр -Xmx.
  • Поддерживайте библиотеку в актуальном состоянии: Новые релизы содержат улучшения производительности и исправления ошибок.

Практические применения

  1. Системы управления контентом (CMS): Пользователи находят статьи, даже используя альтернативную терминологию.
  2. Платформы электронной коммерции: Поиск товаров становится tolerant к синонимам, например «laptop» vs. «notebook».
  3. Репозитории документов: Юридические или медицинские архивы выигрывают от доменно‑специфических групп синонимов, улучшая обнаруживаемость для профессионалов.

Соображения по производительности

  • Оптимизировать хранение индекса: Периодически перестраивайте индекс, чтобы удалить устаревшие данные.
  • Управлять использованием памяти: Следите за потреблением heap при загрузке больших файлов синонимов; словарь размером 500 МБ обычно требует 2 ГБ heap на 64‑битной JVM.
  • Регулярные обновления: Оставайтесь на последней версии GroupDocs.Search для получения исправлений и ускорения работы.

Распространённые проблемы и решения

ПроблемаВозможная причинаРешение
Нет совпадений по синонимамsetUseSynonymSearch(true) не установлен или словарь не импортированУбедитесь, что опция включена и файл словаря существует.
Ошибки out‑of‑memory при импортеОчень большой файл .dat превышает heap JVMУвеличьте размер heap -Xmx или импортируйте частями.
Дублирующиеся записи в результатахОдин термин присутствует в нескольких группах синонимовОбъедините пересекающиеся группы, используя clear(), затем addRange().

Часто задаваемые вопросы

Q: Каковы минимальные системные требования для использования GroupDocs.Search?
A: Любая современная ОС с совместимой JDK (Java 8 или новее) подходит.

Q: Как часто следует обновлять словарь синонимов?
A: Обновляйте его при появлении новой терминологии — используйте clear(), затем addRange() для чистого обновления.

Q: Можно ли использовать GroupDocs.Search без покупки лицензии?
A: Бесплатная пробная версия подходит для оценки, но для продакшн‑развёртываний требуется лицензия.

Q: Каковы лучшие практики индексации больших наборов данных?
A: Разделяйте данные на логические партии, контролируйте использование heap и планируйте регулярное обслуживание индекса.

Q: Я не получаю ожидаемых совпадений по синонимам — что проверить?
A: Убедитесь, что словарь корректно импортирован, setUseSynonymSearch(true) активен, и термины присутствуют в группах синонимов.

Ресурсы


Последнее обновление: 2026-10-17
Тестировано с: GroupDocs.Search 25.4 for Java
Автор: GroupDocs

Связанные руководства