Как искать документы с помощью GroupDocs.Search Java

В современных корпоративных приложениях быстро и точно how to search documents является критически важным требованием. Независимо от того, работаете ли вы с контрактами, отчетами или любой большой репозиторием документов, GroupDocs.Search for Java предоставляет мощный полнотекстовый поисковый движок со встроенным нечетким поиском. Этот учебник проведет вас через настройку библиотеки, создание индекса, добавление документов, настройку fuzzy search Java и получение результатов — всё с понятными, разговорными объяснениями.

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

  • Какой первый шаг? Установите библиотеку GroupDocs.Search Java через Maven или загрузите её напрямую.
  • Как создать индекс? Создайте объект Index, указывающий на папку на диске; библиотека автоматически строит поисковую структуру.
  • Можно ли искать с опечатками? Да — включите fuzzy search, чтобы находить термины с ошибками или небольшими вариациями.
  • Как добавить документы? Используйте метод add экземпляра Index, передавая папку, содержащую ваши файлы.
  • Какая версия Java требуется? Поддерживается JDK 8 или выше.

Что означает “how to search documents” в контексте GroupDocs.Search?

“How to search documents” относится к процессу создания поискового индекса и выполнения запросов, возвращающих соответствующие файлы, при необходимости используя нечеткую логику для допуска орфографических ошибок. GroupDocs.Search обрабатывает токенизацию, индексацию и ранжирование за кулисами, позволяя вам сосредоточиться на бизнес‑логике.

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

GroupDocs.Search поддерживает 30+ форматов файлов (включая DOCX, PDF, TXT, HTML и XLSX) и может индексировать многостраничные документы без загрузки всего файла в память, обеспечивая ответы на запросы менее чем за секунду на типичном серверном оборудовании. Возможность fuzzy search улучшает пользовательский опыт, возвращая релевантные результаты даже при наличии опечаток в запросах.

Требования

  • Java Development Kit (JDK): версия 8 или новее.
  • IDE: IntelliJ IDEA, Eclipse или любой совместимый с Java редактор.
  • GroupDocs.Search for Java library: добавить через Maven (рекомендовано) или загрузить JAR.

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

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

Настройка 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>

Прямое скачивание

В качестве альтернативы получите JAR со страницы официального релиза:

GroupDocs.Search for Java releases

GroupDocs.Search Documentation

Как создать индекс?

Создайте постоянную папку индекса, где GroupDocs.Search хранит токенизированные данные. Загрузите ваш первый индекс одной строкой кода — new Index("path/to/indexFolder"). Класс Index является основным компонентом, представляющим поисковую коллекцию документов в памяти и на диске.

   import com.groupdocs.search.*;

   String indexFolder = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/Searching/SearchResults";
   Index index = new Index(indexFolder);

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

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

   String documentFolder = "YOUR_DOCUMENT_DIRECTORY";
   index.add(documentFolder);

Как настроить fuzzy search Java?

Класс FuzzySearchOptions определяет параметры, такие как расстояние редактирования и длина префикса, которые контролируют степень допуска к ошибкам в поиске. Объект SearchOptions группирует все настройки времени поиска, включая параметры fuzzy, ограничения количества результатов и предпочтения подсветки. Включите нечеткое сопоставление, установив FuzzySearchOptions в объекте SearchOptions. Это сообщает движку учитывать термины в пределах настраиваемого расстояния редактирования, делая поиск устойчивым к опечаткам.

  String indexFolder = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/Searching/SearchResults";
  Index index = new Index(indexFolder);

Как выполнить операцию поиска?

Вызовите метод search объекта Index, передавая строку запроса и настроенный SearchOptions. Движок обрабатывает запрос, применяет нечеткое сопоставление, если оно включено, и ранжирует результаты по оценкам релевантности. Операция завершается быстро даже на больших индексах, поскольку поиск выполняется по предварительно построенным токенам. Метод возвращает коллекцию SearchResult, содержащую найденные документы, количество совпадений и подсвеченные фрагменты.

  String documentFolder = "YOUR_DOCUMENT_DIRECTORY";
  index.add(documentFolder);

Как обработать и отобразить результаты поиска?

SearchResult — это коллекция, содержащая отдельные объекты SearchResultItem, каждый из которых описывает совпавший документ, количество попаданий и подсвеченные фрагменты. Пройдитесь по элементам SearchResult и выведите путь к каждому документу, количество вхождений и совпадающие фразы. Этот простой цикл позволяет создавать таблицы UI, журналы или ответы API, показывающие точно, почему документ совпал.

  import com.groupdocs.search.options.*;

  SearchOptions options = new SearchOptions();
  options.getFuzzySearch().setEnabled(true);
  options.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(3));

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

Реальные сценарии, где важна how to search documents:

  1. Legal Document Management: Находите пункты или стороны в тысячах контрактов за секунды.
  2. Academic Research: Получайте релевантные статьи, даже если поисковый запрос содержит опечатки.
  3. Enterprise Content Management: Обеспечьте внутренние порталы быстрым, устойчивым к опечаткам поиском по отчетам, электронным письмам и презентациям.

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

  • Index Refresh: Повторно выполните add или update, когда исходные файлы меняются, чтобы результаты оставались актуальными.
  • Memory Management: GroupDocs.Search потоково обрабатывает большие файлы, поэтому потребление памяти остаётся низким даже для PDF‑файлов в 500 страниц.
  • Chunked Indexing: Разделите огромные корпуса на несколько папок индексов для параллельной обработки и снижения задержки запросов.

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

Q: Что такое fuzzy search Java и почему он полезен?
A: Fuzzy search Java обеспечивает приближённое сопоставление строк, позволяя запросам возвращать результаты несмотря на опечатки или альтернативные написания, что улучшает опыт конечного пользователя.

Q: Как обновить мой индекс после добавления новых файлов?
A: Снова вызовите index.add("new/files/folder"); библиотека интеллектуально объединяет новое содержимое без полной перестройки индекса.

Q: Может ли GroupDocs.Search обрабатывать PDF‑файлы, защищённые паролем?
A: Да — укажите пароль в DocumentLoadOptions при добавлении файла, и движок расшифрует и проиндексирует содержимое.

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

Q: Где я могу найти более продвинутые примеры?
A: Посетите официальную документацию для более глубоких тем, таких как пользовательские анализаторы и ранжирование результатов.

Заключение

Теперь вы знаете how to search documents с помощью GroupDocs.Search для Java, от создания индекса до включения fuzzy search Java и обработки результатов. Реализуйте эти шаги, чтобы предоставить быстрый, устойчивый к опечаткам поиск в любом Java‑приложении.

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

  String query = "water OR \"Lorem ipsum\"";
  SearchResult result = index.search(query, options);

  for (int i = 0; i < result.getDocumentCount(); i++) {
      FoundDocument document = result.getFoundDocument(i);
      System.out.println("\tDocument: " + document.getDocumentInfo().getFilePath());
      System.out.println("\tOccurrences: " + document.getOccurrenceCount());

      for (FoundDocumentField field : document.getFoundFields()) {
          System.out.println("\t\tField: " + field.getFieldName());
          if (field.getTerms() != null) {
              for (int k = 0; k < field.getTerms().length; k++) {
                  System.out.println("\t\t\t" + field.getTerms()[k] + " - " + field.getTermsOccurrences()[k]);
              }
          }
      }
  }

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