Как использовать синонимы в Java с GroupDocs.Search
Если вы хотите, чтобы ваши пользователи находили нужный контент, даже вводя разные слова, поиск с синонимами — это решение. В этом руководстве вы узнаете, как создать словарь синонимов, импортировать или экспортировать его, управлять группами синонимов и выполнять поиск, который автоматически расширяет запросы с использованием этих синонимов. Независимо от того, создаёте ли вы CMS, каталог электронной коммерции или репозиторий юридических документов, добавление поддержки синонимов может существенно повысить релевантность и коэффициенты конверсии.
Быстрые ответы
- Что является первым шагом для добавления синонимов? Создайте экземпляр
Indexи работайте с APISynonymDictionary. - Могу ли я импортировать готовый словарь синонимов? Да — вызовите
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. - Поддерживайте библиотеку в актуальном состоянии: Новые релизы содержат улучшения производительности и исправления ошибок.
Практические применения
- Системы управления контентом (CMS): Пользователи находят статьи, даже используя альтернативную терминологию.
- Платформы электронной коммерции: Поиск товаров становится tolerant к синонимам, например «laptop» vs. «notebook».
- Репозитории документов: Юридические или медицинские архивы выигрывают от доменно‑специфических групп синонимов, улучшая обнаруживаемость для профессионалов.
Соображения по производительности
- Оптимизировать хранение индекса: Периодически перестраивайте индекс, чтобы удалить устаревшие данные.
- Управлять использованием памяти: Следите за потреблением 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) активен, и термины присутствуют в группах синонимов.
Ресурсы
- Документация
- Справочник API
- Скачать GroupDocs.Search для Java
- Репозиторий GitHub
- Форум бесплатной поддержки
- Получение временной лицензии
Последнее обновление: 2026-10-17
Тестировано с: GroupDocs.Search 25.4 for Java
Автор: GroupDocs