"What is the first step to create an index?"

"Initialize the `Index` object with a folder path."

"Which method adds files to the index?"

"`index.add(yourDocumentsFolder)`."

"How do I enable homophone search?"

"Set `options.setUseHomophoneSearch(true)`."

"Do I need a license?"

"A free trial or temporary license works for evaluation."

Как создать индекс Java с GroupDocs.Search и включить поиск по гомофонам

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

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

Какой первый шаг для создания индекса? Инициализируйте объект Index с путем к папке.
Какой метод добавляет файлы в индекс? index.add(yourDocumentsFolder).
Как включить поиск по гомофонам? Установите options.setUseHomophoneSearch(true).
Нужна ли лицензия? Бесплатная пробная версия или временная лицензия подходят для оценки.
Какая версия Java требуется? JDK 8 или новее.

Что такое индекс в GroupDocs.Search?

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

Зачем включать поиск по гомофонам?

Поиск по гомофонам расширяет запрос, включая слова, звучащие одинаково (например, “write” vs. “right”). Это повышает полноту поиска до 30 % в шумных сценариях ввода пользователем, гарантируя, что пользователи получат результаты даже при опечатках или альтернативных написаниях. Особенно полезно для голосовых интерфейсов и многоязычных сред.

Требования

Java Development Kit 8 или новее.
GroupDocs.Search for Java библиотека (доступна через Maven).
Базовое знакомство с синтаксисом Java и настройкой проекта.

Настройка GroupDocs.Search для Java

Сначала добавьте репозиторий Maven GroupDocs.Search и зависимость в ваш 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 для Java.

Получение лицензии: GroupDocs предлагает бесплатную пробную лицензию или временные лицензии для оценки. Для покупки посетите их официальный сайт.

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

Создайте простой Java‑класс для инициализации поискового индекса:

import com.groupdocs.search.Index;

public class SearchSetup {
    public static void main(String[] args) {
        // Specify the path to store index files
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\HomophoneSearch";
        
        // Create an instance of Index
        Index index = new Index(indexFolder);
        
        System.out.println("Index created successfully!");
    }
}

Как создать индекс Java с GroupDocs.Search для Java?

Index — основной класс, представляющий поисковый индекс, хранящийся на диске. Загрузите или создайте индекс, указав конструктору Index папку, где библиотека может сохранять свои внутренние файлы. Эта операция создаёт необходимые метаданные и подготавливает движок к загрузке документов, позволяя затем добавлять документы и выполнять запросы.

Шаг 1: Определите путь к индексу

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\HomophoneSearch";

Замените YOUR_DOCUMENT_DIRECTORY на абсолютный путь на вашем компьютере.

Шаг 2: Создайте объект Index

Index index = new Index(indexFolder);

Эта строка создаёт индекс, который позже будет содержать весь поисковый контент.

Как добавить документы в индекс?

add — метод класса Index, который загружает файлы из папки в индекс. После создания индекса необходимо наполнить его документами, которые вы хотите искать. Метод add рекурсивно сканирует каталог и индексирует каждый поддерживаемый файл, извлекая текст и формируя таблицы частот терминов для быстрого доступа.

Шаг 1: Укажите исходные документы

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";

Эта папка должна содержать файлы (PDF, DOCX, TXT и т.д.), которые вы хотите проиндексировать.

Шаг 2: Добавьте все файлы из папки

index.add(documentsFolder);

Метод add обрабатывает каждый файл, извлекает текст и сохраняет данные о частоте терминов, эффективно добавляя документы в индекс.

Как включить поиск по гомофонам?

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

Шаг 1: Создайте SearchOptions

import com.groupdocs.search.SearchOptions;

SearchOptions options = new SearchOptions();

SearchOptions настраивает, как движок интерпретирует запросы.

Шаг 2: Активируйте поиск по гомофонам

options.setUseHomophoneSearch(true);

Установка setUseHomophoneSearch(true) сообщает движку учитывать фонетические эквиваленты при обработке запросов.

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

Управление юридическими документами – Находите контракты, где упоминается “lease”, даже если пользователь вводит “leas”.
Анализ отзывов клиентов – Захватывайте варианты, такие как “price” и “prise”, в ответах опросов.
Системы управления контентом – Улучшайте поиск по сайту, сопоставляя “write” с “right”.

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

Регулярно перестраивайте индекс после массовых обновлений документов, чтобы поддерживать актуальность статистики терминов.
Следите за использованием памяти; движок может обрабатывать документы в сотни страниц без загрузки всего файла в память благодаря инкрементальному индексированию.
Следуйте лучшим практикам Java (например, try‑with‑resources, правильная обработка исключений), чтобы приложение оставалось стабильным под нагрузкой.

Заключение

Теперь вы знаете how to create index java, как add documents to index, и как включить поиск по гомофонам с GroupDocs.Search для Java. Эти возможности позволяют создавать быстрые, интеллектуальные поисковые решения для любого репозитория документов.

Следующие шаги

Экспериментируйте с пользовательскими анализаторами, чтобы точно настроить токенизацию.
Сочетайте фасетный поиск с поддержкой гомофонов для более гибкой фильтрации.
Изучите GroupDocs.Search REST API для кросс‑платформенных сценариев.

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

Q: Что такое индекс в контексте GroupDocs.Search?
A: Индекс — это структура данных, которая сопоставляет термины их местоположениям в документах, обеспечивая поиск за миллисекунды, аналогично указателю в книге.

Q: Как обновить мой индекс новыми документами?
A: Вызовите index.add(newFolder), чтобы загрузить дополнительные файлы или переиндексировать существующие; движок обновляет таблицы терминов инкрементально.

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

Q: Что такое гомофоны в поисковой функции?
A: Гомофоны — это слова, звучащие одинаково, но написанные по‑разному, например “write” и “right”; включение этой функции расширяет покрытие запросов.

Q: Как устранить ошибки индексирования?
A: Проверьте пути к файлам, убедитесь в наличии прав чтения и просмотрите вывод логов для конкретных сообщений об исключениях; типичные проблемы — неподдерживаемые форматы или повреждённые файлы.

Ресурсы

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