Как выполнять поиск по метаданным с помощью GroupDocs в Java

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

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

  • Какова основная цель индексирования метаданных? Это позволяет выполнять быстрый поиск на основе свойств документа, а не полного текста.
  • Какой метод добавляет файлы в индекс? index.add(YOUR_DOCUMENTS_FOLDER);
  • Могу ли я искать по пользовательским полям метаданных? Да, после того как поля проиндексированы, их можно запросить напрямую.
  • Нужна ли лицензия для разработки? Временная пробная лицензия достаточна для оценки; полная лицензия требуется для продакшн.
  • Какая версия Java требуется? Рекомендуется JDK 8 или выше.

Что такое индексирование метаданных в GroupDocs.Search?

Индексирование метаданных извлекает и сохраняет атрибуты документа (например, автора, дату создания, пользовательские теги) в поисковую структуру. Когда вы add documents to index, движок фиксирует эти атрибуты, позволяя выполнять точные запросы, такие как «найти все PDF, автором которых является John Doe» или «search pdf by author».

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

Поиск по метаданным с GroupDocs обеспечивает лёгкое, субсекундное время отклика даже при наличии в индексе миллионов записей. Он поддерживает over 30 input and output formats — включая PDF, DOCX, PPTX, HTML и файлы изображений — и потребляет менее 200 МБ памяти кучи для индекса из 100 000 документов на типичном сервере.

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

  • GroupDocs.Search for Java ≥ 25.4.
  • JDK 8 или новее, установленный и настроенный.
  • Базовое знакомство с Java и Maven.

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

Инструкции по установке

Добавьте репозиторий GroupDocs и зависимость в ваш 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 for Java releases.

Получение лицензии

Чтобы получить временную лицензию для тестирования:

  1. Перейдите на сайт GroupDocs и откройте раздел Purchase.
  2. Выберите план temporary license, соответствующий вашим потребностям оценки.

Как настроить параметры индекса для метаданных?

Настройка параметров индекса указывает движку, какую информацию извлекать и сохранять. Установив тип индекса в MetadataIndex, вы инструктируете GroupDocs.Search сосредоточиться на полях метаданных, а не на полном тексте, что уменьшает размер индекса и ускоряет запросы. Эта конфигурация применяется через объект IndexSettings, где также можно указать пользовательские поля метаданных для индексации.

IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);

Функция 1: конфигурация параметров индекса

Вызов setIndexType(IndexType.MetadataIndex) указывает движку сосредоточиться на метаданных вместо полного текста. IndexType.MetadataIndex — это значение перечисления, выбирающее режим индексирования только метаданных.

import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.IndexType;

// Initialize index settings
IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);  // Focus on metadata indexing

Функция 2: создание индекса в указанной папке

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

import com.groupdocs.search.Index;

String YOUR_INDEX_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY\\\\output\\\\AdvancedUsage\\\\Indexing\\\\IndexingMetadataOfDocuments";

// Create index in specified directory using settings
Index index = new Index(YOUR_INDEX_DIRECTORY, settings);

Замените YOUR_DOCUMENT_DIRECTORY на путь, соответствующий структуре вашего проекта.

Функция 3: Как добавить документы в индекс

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

String YOUR_DOCUMENTS_FOLDER = "YOUR_DOCUMENT_DIRECTORY";

// Add all documents in directory to the index
index.add(YOUR_DOCUMENTS_FOLDER);

Подсказки:

  • Убедитесь, что путь к папке правильный и приложение имеет права чтения.
  • GroupDocs.Search автоматически извлекает поддерживаемые метаданные из каждого файла.

Функция 4: Поиск документов по метаданным

Выполните запрос, ориентированный на поля метаданных, например поиск документов, где язык — английский:

import com.groupdocs.search.results.SearchResult;

String query = "English";  // Define search query
SearchResult result = index.search(query);  // Perform the search

// Process results (example)
for (int i = 0; i < result.getDocumentCount(); i++) {
    System.out.println("Found document: " + result.getFoundDocument(i).getFilePath());
}

Метод search(query) просматривает проиндексированные метаданные и возвращает совпадающие документы. Вы также можете search pdf by author, используя имя автора в качестве строки запроса.

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

  1. Enterprise document management: Получать контракты по дате контракта или имени подписанта.
  2. Digital library catalogs: Позволять пользователям просматривать книги по жанру, году публикации или автору.
  3. CRM systems: Быстро находить файлы клиентов, используя пользовательские метаданные, такие как ID клиента или регион.

Советы и лучшие практики

  • Incremental updates: Use index.addOrUpdate() для новых или изменённых файлов вместо полной перестройки индекса.
  • Batch processing: При работе с тысячами файлов добавляйте их небольшими партиями, чтобы снизить использование памяти.
  • Metadata validation: Убедитесь, что исходные документы действительно содержат метаданные, которые вы планируете запрашивать (например, поля автора в PDF).

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

  • Memory tuning: Настройте размер кучи JVM (-Xmx) в зависимости от объёма проиндексированных метаданных.
  • Optimized storage: Периодически вызывайте index.optimize(), чтобы сжать индекс и повысить скорость запросов.

Распространённые проблемы и решения

ПроблемаРешение
No results returnedПодтвердите, что ожидаемые поля метаданных действительно присутствуют в исходных файлах.
Permission errorsУбедитесь, что процесс Java имеет доступ на чтение как к папке с документами, так и к каталогу индекса.
Out‑of‑memory errorsУвеличьте размер кучи JVM или разбейте операцию add на более мелкие группы файлов.

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

Q: Что такое индексирование метаданных?
A: Индексирование метаданных сохраняет атрибуты документа (автор, название, пользовательские теги) в поисковую структуру, позволяя быстро находить их без сканирования полного текста.

Q: Как получить временную лицензию?
A: Перейдите на страницу покупки GroupDocs и следуйте инструкциям для получения пробной лицензии.

Q: Можно ли индексировать PDF с этой настройкой?
A: Да, GroupDocs.Search поддерживает PDF, DOCX, PPT и многие другие форматы.

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

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

Ресурсы


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

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