recherche en texte intégral java – ajouter des documents et fusionner avec GroupDocs.Search

Dans les environnements d’entreprise modernes, java full text search est l’épine dorsale de tout système de gestion de documents java robuste. Que vous ayez besoin d’indexer des contrats, des factures ou des rapports internes, un index bien conçu vous permet de récupérer les bonnes informations en quelques millisecondes. Ce tutoriel vous guide à travers la création d’un index, l’ajout de documents, la configuration des options de fusion et l’annulation sécurisée d’une opération de fusion — le tout en utilisant GroupDocs.Search for Java.

Réponses rapides

  • Que signifie « add documents to index » ? Il indique à GroupDocs.Search de parcourir un dossier, d’extraire les jetons recherchables et de stocker les métadonnées de chaque fichier.
  • Puis-je arrêter une fusion longue ? Oui — utilisez l’objet Cancellation pour interrompre une fusion après un délai configurable.
  • Ai-je besoin d’une licence ? Un essai gratuit ou une licence temporaire suffit pour les tests ; une licence commerciale débloque toutes les fonctionnalités.
  • Quelle version de Java est requise ? JDK 8 ou supérieur.
  • Cette solution convient‑elle aux grands ensembles de données ? Absolument — GroupDocs.Search peut gérer des documents de plusieurs centaines de pages avec un indexation incrémentale.

Qu’est‑ce que « add documents to index » dans GroupDocs.Search ?

Ajouter des documents à un index signifie alimenter une collection de fichiers dans GroupDocs.Search afin que la bibliothèque puisse analyser leur contenu, extraire les jetons et construire une structure de données recherchable. Le processus crée une représentation compacte qui permet des requêtes en texte intégral ultra‑rapides sur tous les fichiers indexés.

Pourquoi utiliser GroupDocs.Search pour la gestion de documents java ?

GroupDocs.Search fournit une indexation évolutive pour plus de 50 formats d’entrée (PDF, DOCX, XLSX, PPTX, HTML, images, etc.) et peut traiter des documents jusqu’à 2 Go sans charger le fichier complet en mémoire. Son API vous offre un contrôle granulaire sur l’indexation, la fusion et l’annulation, ce qui en fait un choix de premier plan pour les solutions de recherche en texte intégral java de niveau entreprise.

Prérequis

  • GroupDocs.Search for Java version 25.4 ou ultérieure.
  • Maven (ou téléchargement manuel du JAR).
  • Connaissances de base en Java et un environnement JDK 8+.

Configuration de GroupDocs.Search pour Java

Installation Maven

Si vous gérez les dépendances avec Maven, ajoutez le dépôt 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>

Téléchargement direct

Sinon, téléchargez le JAR le plus récent depuis le site officiel : GroupDocs.Search for Java releases.

Obtention de licence

  • Free Trial : Inscrivez‑vous sur le site Web de GroupDocs pour obtenir une licence d’essai.
  • Temporary License : Demandez une clé temporaire si vous avez besoin d’une évaluation prolongée.
  • Commercial License : Achetez‑la pour une utilisation en production.

Une fois que vous avez le fichier de licence, placez‑le dans votre projet et initialisez la bibliothèque comme indiqué plus loin.

Guide d’implémentation

Comment ajouter des documents à l’index – Créer le premier index

Chargez ou créez un index vide en instanciant la classe Index, qui représente un conteneur searchable sur le disque. Cette étape prépare un emplacement de stockage pour tous les jetons qui seront générés à partir de vos documents.

import com.groupdocs.search.Index;

// Create an instance of the index at the specified path
Index index1 = new Index("YOUR_DOCUMENT_DIRECTORY\\\\Index1");
  • Pourquoi : Cette étape configure un conteneur de stockage où les jetons indexés seront enregistrés.

Ajout de documents à l’index

Appelez index.add avec un chemin de dossier ; la méthode parcourt chaque fichier, extrait le texte et stocke les métadonnées recherchables dans l’index. L’opération s’exécute en un seul passage et respecte les IndexSettings configurés.

index1.add("YOUR_DOCUMENT_DIRECTORY"); // Add documents from this directory
  • Pourquoi : La bibliothèque lit chaque fichier, extrait le texte et le stocke dans index1.

Création d’un second index pour des flux de travail flexibles

Instanciez un autre objet Index pour contenir un ensemble de documents séparé, permettant un traitement isolé avant une fusion. Ce modèle est utile pour les scénarios multi‑locataires ou l’indexation par étapes.

Index index2 = new Index("YOUR_DOCUMENT_DIRECTORY\\\\Index2");

index2.add("YOUR_DOCUMENT_DIRECTORY");
  • Pourquoi : Plusieurs index vous permettent de gérer des ensembles de documents distincts et de les combiner ultérieurement.

Comment configurer les options de fusion et annuler l’opération de fusion

Créez une instance MergeOptions, définissez les paramètres souhaités et attachez un jeton Cancellation qui interrompt la fusion après un délai spécifié. Cela vous donne un contrôle total sur l’utilisation des ressources lors de grosses fusions.

import com.groupdocs.search.options.MergeOptions;
import com.groupdocs.search.options.Cancellation;

MergeOptions options = new MergeOptions();
options.setCancellation(new Cancellation()); // Initialize cancellation object
options.getCancellation().cancelAfter(5000); // Cancel merge operation after 5 seconds
  • Pourquoi : Cancellation vous permet de annuler l’opération de fusion automatiquement, évitant les tâches incontrôlées.

Fusion des index

Appelez index1.merge(index2, mergeOptions) ; l’index principal absorbe tous les documents de l’index secondaire tout en préservant l’intégrité des jetons. Après la fusion, vous disposez d’un référentiel searchable unifié.

index1.merge(index2, options);
  • Pourquoi : Après cet appel, index1 contient tous les documents des deux sources, vous offrant une expérience de recherche unifiée.

Applications pratiques pour la gestion de documents Java

  • Legal firms : Consolidez les dossiers de cas de plusieurs bureaux dans un seul index searchable.
  • Financial institutions : Fusionnez les rapports trimestriels dans un référentiel unifié pour des requêtes d’audit rapides.
  • Enterprises : Combinez les politiques RH, les manuels de conformité et les guides internes pour une recherche à l’échelle de l’entreprise.

Considérations de performance

  • Incremental indexing : Ajoutez de nouveaux fichiers périodiquement au lieu de reconstruire l’intégralité de l’index.
  • Memory monitoring : Les gros lots peuvent consommer de la RAM ; traitez les fichiers par morceaux plus petits ou activez le mode streaming.
  • Garbage collection : Libérez rapidement les objets Index inutilisés pour libérer des ressources.
  • SSD storage : Stocker les fichiers d’index sur des SSD peut augmenter la vitesse de fusion jusqu’à 2×.

Problèmes courants et solutions

ProblèmeSolution
Chemin de dossier incorrectVérifiez le chemin absolu et assurez‑vous que l’application dispose des permissions de lecture.
Mémoire insuffisanteAugmentez le tas JVM (-Xmx) ou indexez les fichiers par lots.
Annulation non déclenchéeAssurez‑vous que cancelAfter est défini avant d’appeler merge.
Format de fichier non pris en chargeInstallez des plugins de format supplémentaires depuis GroupDocs si nécessaire.

Questions fréquemment posées

Q : Pourquoi créer plusieurs index au lieu d’un seul ?
R : Les index séparés vous permettent d’isoler des domaines de données, d’appliquer des politiques de sécurité distinctes et de fusionner uniquement lorsque nécessaire, ce qui améliore les performances et l’organisation.

Q : Puis‑je annuler une opération d’indexation de la même façon que j’annule une fusion ?
R : Oui — utilisez l’objet Cancellation avec la méthode add pour arrêter les tâches d’indexation de longue durée.

Q : Comment garantir des performances optimales avec de très grandes collections de documents ?
R : Effectuez une indexation incrémentale, surveillez la mémoire JVM et stockez l’index sur des SSD. Envisagez d’utiliser le paramètre BatchSize pour limiter les documents en mémoire.

Q : Que faire si je reçois des erreurs « Access denied » ?
R : Vérifiez les permissions du dossier pour l’utilisateur exécutant le processus Java et assurez‑vous que le fichier de licence est lisible.

Q : GroupDocs.Search est‑il compatible avec d’autres bibliothèques GroupDocs ?
R : Absolument — vous pouvez l’intégrer avec GroupDocs.Viewer, GroupDocs.Conversion, et d’autres pour créer une solution documentaire full‑stack.

Conclusion

En suivant ce guide, vous savez maintenant comment add documents to index, configurer le comportement de fusion et annuler en toute sécurité cancel merge operation lorsque nécessaire — le tout dans un flux de travail java full text search robuste. Expérimentez avec des ensembles de données plus grands, explorez des tokenizers personnalisés, ou combinez GroupDocs.Search avec d’autres produits GroupDocs pour créer une solution de niveau entreprise.

Ressources

Dernière mise à jour : 2026-05-12
Testé avec : GroupDocs.Search 25.4 for Java
Auteur : GroupDocs

Tutoriels associés