Comment effectuer une recherche de métadonnées avec GroupDocs en Java

Ajouter des documents à un index rapidement et de manière fiable constitue l’épine dorsale de toute application moderne axée sur la recherche. Que vous construisiez un référentiel juridique, une base de connaissances pour le support client ou un portail documentaire interne, metadata search with GroupDocs vous permet de localiser des fichiers par auteur, titre ou toute balise personnalisée sans analyser le contenu complet. Dans ce tutoriel, vous apprendrez à configurer les paramètres d’index, créer un index axé sur les métadonnées, ajouter vos fichiers et exécuter des recherches précises — le tout avec GroupDocs.Search pour Java.

Réponses rapides

  • Quel est le but principal de l’indexation des métadonnées ? Elle permet des recherches rapides basées sur les propriétés du document plutôt que sur le contenu complet.
  • Quelle méthode ajoute des fichiers à l’index ? index.add(YOUR_DOCUMENTS_FOLDER);
  • Puis-je rechercher par champs de métadonnées personnalisés ? Oui, une fois les champs indexés, vous pouvez les interroger directement.
  • Ai-je besoin d’une licence pour le développement ? Une licence d’essai temporaire suffit pour l’évaluation ; une licence complète est requise pour la production.
  • Quelle version de Java est requise ? JDK 8 ou supérieur est recommandé.

Qu’est-ce que l’indexation des métadonnées dans GroupDocs.Search ?

L’indexation des métadonnées extrait et stocke les attributs des documents (par ex., auteur, date de création, balises personnalisées) dans une structure interrogeable. Lorsque vous add documents to index, le moteur enregistre ces attributs, vous permettant d’exécuter des requêtes précises comme « trouver tous les PDF rédigés par John Doe » ou « search pdf by author ».

Pourquoi utiliser GroupDocs.Search pour l’indexation des métadonnées ?

Metadata search with GroupDocs offre un temps de réponse léger, inférieur à une seconde, même lorsque l’index contient des millions d’enregistrements. Il prend en charge over 30 input and output formats — y compris PDF, DOCX, PPTX, HTML et les fichiers image — et consomme moins de 200 Mo de mémoire heap pour un index de 100 000 documents sur un serveur typique.

Prérequis

  • GroupDocs.Search for Java ≥ 25.4.
  • JDK 8 ou plus récent installé et configuré.
  • Familiarité de base avec Java et Maven.

Configuration de GroupDocs.Search pour Java

Instructions d’installation

Ajoutez le dépôt GroupDocs et la dépendance à votre 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>

Vous pouvez également télécharger les dernières binaires directement depuis GroupDocs.Search for Java releases.

Acquisition de licence

Pour obtenir une licence temporaire pour les tests :

  1. Visitez le site Web de GroupDocs et accédez à la section Purchase.
  2. Choisissez un plan de temporary license qui correspond à vos besoins d’évaluation.

Comment configurer les paramètres d’index pour les métadonnées ?

La configuration des paramètres d’index indique au moteur quelles informations extraire et stocker. En définissant le type d’index sur MetadataIndex, vous indiquez à GroupDocs.Search de se concentrer sur les champs de métadonnées plutôt que sur le contenu complet, ce qui réduit la taille de l’index et accélère les requêtes. Cette configuration est appliquée via l’objet IndexSettings, où vous pouvez également spécifier des champs de métadonnées personnalisés à indexer.

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

Fonctionnalité 1 : configuration des paramètres d’index

L’appel setIndexType(IndexType.MetadataIndex) indique au moteur de se concentrer sur les métadonnées plutôt que sur le contenu complet. IndexType.MetadataIndex est une valeur d’énumération qui sélectionne le mode d’indexation uniquement métadonnées.

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

Fonctionnalité 2 : création d’un index dans un dossier spécifié

Créez un répertoire d’index physique où toutes les métadonnées seront stockées :

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);

Remplacez YOUR_DOCUMENT_DIRECTORY par le chemin qui correspond à la structure de votre projet.

Fonctionnalité 3 : comment ajouter des documents à l’index

La méthode index.add ajoute les fichiers d’un dossier à l’index et extrait leurs métadonnées. index.add analyse chaque document, lit les champs de métadonnées pris en charge et les stocke dans l’index pour une récupération rapide.

String YOUR_DOCUMENTS_FOLDER = "YOUR_DOCUMENT_DIRECTORY";

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

Conseils :

  • Vérifiez que le chemin du dossier est correct et que l’application dispose des permissions de lecture.
  • GroupDocs.Search extrait automatiquement les métadonnées prises en charge de chaque fichier.

Fonctionnalité 4 : recherche de documents par métadonnées

Exécutez une requête ciblant les champs de métadonnées, par exemple rechercher des documents où la langue est l’anglais :

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());
}

La méthode search(query) parcourt les métadonnées indexées et renvoie les documents correspondants. Vous pouvez également search pdf by author en utilisant le nom de l’auteur comme chaîne de requête.

Applications pratiques

  1. Enterprise document management : Récupérez les contrats par date de contrat ou nom du signataire.
  2. Digital library catalogs : Permettez aux utilisateurs de parcourir les livres par genre, année de publication ou auteur.
  3. CRM systems : Localisez rapidement les dossiers clients en utilisant des métadonnées personnalisées comme l’ID client ou la région.

Conseils et meilleures pratiques

  • Incremental updates : Utilisez index.addOrUpdate() pour les fichiers nouveaux ou modifiés au lieu de reconstruire l’index complet.
  • Batch processing : Lors du traitement de milliers de fichiers, ajoutez-les en petits lots pour maintenir une faible utilisation de la mémoire.
  • Metadata validation : Assurez-vous que les documents sources contiennent réellement les métadonnées que vous prévoyez d’interroger (par ex., champs d’auteur dans les PDF).

Considérations de performance

  • Memory tuning : Ajustez la taille du tas JVM (-Xmx) en fonction du volume de métadonnées indexées.
  • Optimized storage : Appelez périodiquement index.optimize() pour compacter l’index et améliorer la vitesse des requêtes.

Problèmes courants et solutions

ProblèmeSolution
Aucun résultat retournéConfirmez que les champs de métadonnées attendus sont réellement présents dans les fichiers source.
Erreurs d’autorisationAssurez-vous que le processus Java a accès en lecture au dossier des documents et au répertoire d’index.
Erreurs de mémoire insuffisanteAugmentez la taille du tas JVM ou traitez l’opération add par lots pour traiter les fichiers en groupes plus petits.

Questions fréquemment posées

Q : Qu’est-ce que l’indexation des métadonnées ?
R : L’indexation des métadonnées stocke les attributs des documents (auteur, titre, balises personnalisées) dans une structure interrogeable, permettant des recherches rapides sans analyser le texte complet.

Q : Comment obtenir une licence temporaire ?
R : Visitez la page d’achat de GroupDocs et suivez les étapes pour obtenir une licence d’essai.

Q : Puis-je indexer des PDF avec cette configuration ?
R : Oui, GroupDocs.Search prend en charge PDF, DOCX, PPT et de nombreux autres formats.

Q : Quels sont les problèmes courants lors de l’ajout de documents ?
R : Vérifiez que les chemins de fichiers sont corrects et assurez-vous que l’application dispose des permissions de lecture pour les répertoires.

Q : Comment optimiser les performances de recherche ?
R : Mettez régulièrement à jour votre index, utilisez des ajouts incrémentiels et ajustez les paramètres de mémoire JVM.

Ressources


Dernière mise à jour : 2026-10-22
Testé avec : GroupDocs.Search Java 25.4
Auteur : GroupDocs

Tutoriels associés