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

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

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

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

Что означает «Как добавить синонимы»?

Добавление синонимов означает определение альтернативных слов или фраз, которые поисковый движок рассматривает как эквивалентные. Это позволяет запросу, например «better», также находить документы, содержащие «improve», «enhance» или «upgrade».

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

  • Улучшенный пользовательский опыт: Пользователи находят релевантный контент, даже если используют другую терминологию.
  • Более высокий коэффициент конверсии: Сайты электронной коммерции захватывают больше продаж, сопоставляя разнообразные запросы о продуктах.
  • Сокращённое обслуживание: Один словарь может обслуживать несколько приложений, упрощая обновления.

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

  • GroupDocs.Search for Java версии 25.4 или новее.
  • IDE для Java (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: Создание и индексация индекса

// 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: Получение синонимов для слова

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

Функция 3: Получение групп синонимов

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

Функция 4: Управление записями словаря синонимов

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: Экспорт синонимов в файл

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

Функция 6: Импорт синонимов из файла

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

Функция 7: Выполнение поиска с поддержкой синонимов

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

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

Как искать с синонимами

Включив setUseSynonymSearch(true), движок автоматически расширяет запрос, используя словарь синонимов, который вы создали или импортировали. Этот шаг важен для предоставления более богатых результатов без изменения поведения пользователя при поиске.

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

Если у вас уже есть файл .dat, подготовленный в другой среде, просто вызовите importDictionary(path). Это идеально подходит для синхронизации словарей между серверами разработки, тестирования и продакшн.

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

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

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

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

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

  1. Content Management Systems (CMS): Пользователи находят статьи, даже если используют альтернативную терминологию.
  2. E‑commerce Platforms: Поиск продуктов становится tolerant к синонимам, например «laptop» vs. «notebook».
  3. Document Repositories: Юридические или медицинские архивы выигрывают от отраслевых групп синонимов.

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

  • Оптимизировать хранение индекса: Периодически перестраивайте индекс, чтобы удалить устаревшие данные.
  • Управлять использованием памяти: Следите за потреблением кучи при загрузке больших файлов синонимов.
  • Регулярные обновления: Оставайтесь на последней версии GroupDocs.Search для исправлений ошибок и ускорения работы.

Заключение

Теперь у вас есть полная пошаговая дорожная карта для добавления синонимов, импорта файлов словарей синонимов, управления группами синонимов и поиска с синонимами с использованием GroupDocs.Search для Java. Применяйте эти техники, чтобы повысить релевантность, улучшить удовлетворённость пользователей и поддерживать ваш поисковый индекс в оптимальном состоянии.

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

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

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

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

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

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

Resources

Last Updated: 2025-12-19
Tested With: GroupDocs.Search 25.4 for Java
Author: GroupDocs