Java Full Text Search: Создание индекса с помощью GroupDocs.Search

В современных приложениях, ориентированных на данные, java full text search является основой любой системы, которой необходимо быстро находить информацию в больших коллекциях документов. Используя GroupDocs.Search for Java, вы можете создать мощный поисковый индекс, точно настроить словарь алфавита и значительно улучшить релевантность запросов при search documents java. Это руководство проведет вас через каждый шаг — от настройки библиотеки до кастомизации обработки символов — чтобы вы могли предоставлять быстрые и точные результаты поиска в ваших Java‑проектах.

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

  • What is “java full text search”? Это процесс создания индекса, который позволяет выполнять быстрые текстовые запросы по множеству файлов в Java‑приложении.
  • Which library handles this out‑of‑the‑box? GroupDocs.Search for Java предоставляет готовый индексирование, управление словарём и выполнение запросов.
  • Do I need a license? Бесплатная пробная версия подходит для оценки; полная лицензия требуется для продакшн‑развертываний.
  • Can I customize character handling? Абсолютно — используйте словарь алфавита для определения пользовательских типов символов.
  • Is Maven mandatory? Maven упрощает управление зависимостями, но вы также можете загрузить JAR напрямую.

Что такое java full text search и почему управлять словарём алфавита?

Индекс java full text search хранит токенизированные представления ваших документов, позволяя мгновенно находить слова или фразы. Словарь алфавита указывает движку, как обрабатывать каждый символ (буква, цифра, символ), что напрямую влияет на токенизацию и релевантность поиска — особенно для специальных символов или правил, специфичных для языка.

Почему использовать GroupDocs.Search для java full text search?

  • Speed: Индексы хранятся на диске и загружаются эффективно, обеспечивая время выполнения запросов менее секунды.
  • Flexibility: Полный контроль над типами символов позволяет обрабатывать дефисы, апострофы или нелатинские скрипты.
  • Scalability: Работает с тысячами документов без потери производительности.
  • Ease of Integration: Простая настройка через Maven или прямую загрузку позволяет быстро приступить к работе.

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

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

  • GroupDocs.Search for Java (последний релиз).
  • Базовые знания разработки на Java.

Требования к настройке окружения

Убедитесь, что у вас есть окружение, совместимое с Maven. Если Maven ещё не установлен, скачайте его с официального сайта: Apache Maven.

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

Знание синтаксиса Java и работы с файловым вводом‑выводом будет полезным, но пошаговое руководство ниже охватывает всё необходимое.

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

Конфигурация Maven

Добавьте репозиторий и зависимость в ваш файл 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>

Прямая загрузка

Если вы предпочитаете не использовать Maven, скачайте последний JAR со страницы официальных релизов: GroupDocs.Search for Java releases.

Шаги получения лицензии

  1. Free Trial – Начните с пробной версии, чтобы изучить все возможности.
  2. Temporary License – Запросите временный ключ для расширенного тестирования.
  3. Full License – Приобретите производственную лицензию для неограниченного использования.

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

Создайте экземпляр Index, указывающий папку, где будет храниться поисковый индекс:

import com.groupdocs.search.*;

public class SearchIndexSetup {
    public static void main(String[] args) {
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\Index";
        Index index = new Index(indexFolder);
    }
}

Руководство по реализации

Ниже представлено полное пошаговое руководство по наиболее распространённым операциям, которые вы будете выполнять при построении решения java full text search.

Создание или открытие индекса

Инициализируйте новый индекс или откройте существующий:

import com.groupdocs.search.*;

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\Index";
Index index = new Index(indexFolder);
  • Parameters: indexFolder – путь, где находятся файлы индекса.
  • Purpose: Настраивает поисковую среду для последующего индексирования и выполнения запросов.

Экспорт словаря алфавита в файл

Сохраните текущий словарь алфавита, чтобы позже можно было повторно использовать или проанализировать его:

import com.groupdocs.search.dictionaries.*;

String fileName = "YOUR_OUTPUT_DIRECTORY\\Alphabet.dat";
index.getDictionaries().getAlphabet().exportDictionary(fileName);
  • Parameters: fileName – файл назначения для экспортированного словаря.

Очистка словаря алфавита

Сбросьте словарь к состоянию по умолчанию перед применением пользовательских правил:

import com.groupdocs.search.dictionaries.*;

if (index.getDictionaries().getAlphabet().getCount() > 0) {
    index.getDictionaries().getAlphabet().clear();
}
  • Purpose: Удаляет все ранее определённые типы символов.

Импорт словаря алфавита из файла

Восстановите ранее сохранённую конфигурацию словаря:

import com.groupdocs.search.dictionaries.*;

index.getDictionaries().getAlphabet().importDictionary(fileName);
  • Parameters: fileName – путь к файлу .dat, содержащему словарь.

Установка типа символа в словаре алфавита

Настройте, как конкретные символы обрабатываются во время токенизации:

import com.groupdocs.search.dictionaries.*;

if (index.getDictionaries().getAlphabet().getCharacterType('-') != CharacterType.Blended) {
    index.getDictionaries().getAlphabet().setRange(new char[] { '-' }, CharacterType.Blended);
}
  • Parameters: Символ ('-') и его новый CharacterType (например, Blended).
  • Why it matters: Настройка типов символов улучшает релевантность поиска для дефисных терминов, идентификаторов или пользовательских символов.

Индексирование документов из папки

Добавьте все файлы из директории в поисковый индекс:

import com.groupdocs.search.*;

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";
index.add(documentsFolder);
  • Parameters: documentsFolder – папка, содержащая документы, которые вы хотите проиндексировать.

Поиск в индексе

Выполните запрос и получите соответствующие результаты:

import com.groupdocs.search.results.*;

String query = "Elliot-Murray-Kynynmound";
SearchResult result = index.search(query);
  • Parameters: query – текст, который вы ищете.
  • Result: Объект SearchResult, содержащий найденные документы и фрагменты.

Распространённые сценарии использования java full text search

  • Content Management Systems (CMS): Ускорьте поиск статей и ресурсов.
  • Legal Document Repositories: Быстро находите пункты или ссылки на дела.
  • Research Libraries: Индексируйте тысячи статей для мгновенного поиска по ключевым словам.
  • E‑commerce Catalogs: Улучшите поиск товаров с помощью пользовательской токенизации.
  • Customer Support Portals: Позвольте агентам быстро находить релевантные тикеты или статьи базы знаний.

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

  • Incremental Updates: Переиндексируйте только новые или изменённые файлы, чтобы поддерживать актуальность индекса без полной перестройки.
  • Query Optimization: Делайте запросы лаконичными; избегайте слишком широких поисков с подстановочными знаками.
  • Resource Monitoring: Следите за использованием памяти при массовом индексировании — при необходимости настройте размер кучи JVM.
  • Dictionary Size: Экспортируйте/импортируйте словарь алфавита только при его изменении; лишний ввод‑вывод может замедлить запуск.

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

Q: What are the prerequisites for using GroupDocs.Search?
A: Установите Java, Maven (или скачайте JAR) и добавьте зависимость GroupDocs.Search.

Q: How do I obtain a license for production use?
A: Начните с бесплатной пробной версии, запросите временный ключ для расширенного тестирования, затем приобретите полную лицензию в портале GroupDocs.

Q: Can I customize character types in the alphabet dictionary?
A: Да — используйте setRange для назначения пользовательских значений CharacterType любому символу или диапазону.

Q: Is it possible to export and import the alphabet dictionary?
A: Конечно — используйте методы exportDictionary и importDictionary для сохранения или обмена конфигурациями словаря.

Q: Which version was this guide tested with?
A: Примеры проверены с GroupDocs.Search for Java версии 25.4.

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