Recherche floue Java : ajouter des documents à l’index avec GroupDocs.Search

Réponses rapides

  • Que signifie « add documents to index » ? Cela signifie charger les fichiers source dans une structure de données consultable que GroupDocs.Search peut interroger.
  • Quelle version de la bibliothèque est requise ? GroupDocs.Search for Java 25.4 (ou plus récent) inclut toutes les fonctionnalités démontrées ici.
  • Ai-je besoin d’une licence ? Un essai gratuit fonctionne pour le développement ; une licence commerciale est requise pour une utilisation en production.
  • Puis-je rechercher différentes formes de mots ? Oui—activez setUseWordFormsSearch(true) dans SearchOptions.
  • Maven est-il le seul moyen d’installer ? Non, vous pouvez également télécharger le JAR directement (voir le lien Téléchargement direct).

Qu’est-ce que « add documents to index » ?

Ajouter des documents à un index signifie analyser les fichiers source, extraire le texte consultable et stocker ces informations dans un format structuré qui permet une recherche rapide. GroupDocs.Search gère de nombreux types de fichiers en natif, vous permettant de vous concentrer sur la logique métier plutôt que sur l’analyse. L’index résultant peut être stocké sur disque ou en mémoire, permettant une récupération rapide sans re‑lecture des fichiers originaux à chaque requête.

Pourquoi utiliser des techniques avancées de recherche de texte en Java ?

Chargez votre index une fois, puis exécutez des requêtes floues, insensibles à la casse ou de proximité sans retraiter les fichiers. L’activation de ces techniques augmente le rappel jusqu’à 30 % dans des tests réels, permettant aux utilisateurs de trouver des résultats pertinents même s’ils ne connaissent pas la formulation exacte ou l’orthographe.

Prérequis

  • Bibliothèques requises : GroupDocs.Search for Java 25.4.
  • Configuration de l’environnement : Java JDK 8 ou plus récent, Maven (ou gestion manuelle des JAR).
  • Prérequis de connaissances : programmation Java de base et gestion des dépendances Maven.

Configuration de GroupDocs.Search pour Java

Avant d’écrire du code, assurez‑vous que la bibliothèque est disponible pour votre projet.

Configuration Maven

Le fichier pom.xml est le descripteur de projet Maven où les dépendances sont déclarées.

<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

Si vous préférez ne pas utiliser Maven, vous pouvez télécharger le JAR le plus récent depuis la page officielle : GroupDocs.Search for Java releases.

Pour des instructions d’utilisation détaillées, consultez la GroupDocs Documentation.

Étapes d’obtention de licence

  1. Essai gratuit – explorez l’API sans coût.
  2. Licence temporaire – prolongez la période d’essai pour des tests plus approfondis.
  3. Achat – obtenez une licence commerciale pour une utilisation en production.

Types de fichiers de recherche pris en charge en Java

GroupDocs.Search prend en charge plus de 50 formats d’entrée et de sortie — y compris DOCX, PDF, PPTX, XLSX, TXT, HTML et les types d’images courants — vous permettant d’indexer pratiquement tout document utilisé par votre entreprise.

Guide d’implémentation étape par étape

1. Créer et configurer un index

La classe Index est l’objet de niveau supérieur qui représente un référentiel consultable stocké sur disque.

Vue d’ensemble

Nous créerons un dossier sur le disque qui contiendra les fichiers d’index.

Code

import com.groupdocs.search.Index;

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/SearchForDifferentWordForms";
Index index = new Index(indexFolder);

Explication : Le constructeur Index pointe vers un dossier où toutes les données d’index seront persistées. Remplacez YOUR_DOCUMENT_DIRECTORY par le chemin réel sur votre machine.

2. Comment ajouter des documents à l’index

La méthode add parcourt récursivement un dossier, extrait le texte et le stocke dans l’index.

Vue d’ensemble

GroupDocs.Search parcourt le répertoire spécifié et indexe chaque type de fichier pris en charge qu’il trouve.

Code

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath";
index.add(documentsFolder);

Explication : Assurez‑vous que le chemin est correct et que l’application dispose des permissions de lecture. La méthode traite les fichiers par lots afin de maintenir une faible utilisation de la mémoire.

3. Configurer les options de recherche pour les formes de mots

SearchOptions contient les paramètres qui contrôlent le traitement des requêtes.

Vue d’ensemble

Nous ajusterons SearchOptions pour activer la recherche de formes de mots (floue).

Code

import com.groupdocs.search.SearchOptions;

SearchOptions options = new SearchOptions();
options.setUseWordFormsSearch(true); // Enables search for different grammatical variations of words.

Explication : Le réglage setUseWordFormsSearch(true) indique au moteur d’étendre les requêtes pour inclure les inflexions connues, améliorant le rappel pour des variantes comme « wish », « wished » et « wishes ».

4. Effectuer la recherche

SearchResult contient la liste des documents correspondants et des extraits de fragments.

Vue d’ensemble

Nous rechercherons le mot « wished » et récupérerons les documents correspondants.

Code

import com.groupdocs.search.SearchResult;

String query = "wished";
SearchResult result = index.search(query, options);

Explication : La méthode search exécute la requête sur le contenu indexé en utilisant les options que nous avons définies. Le SearchResult retourné fournit les références des documents et les extraits mis en évidence pour chaque résultat.

Problèmes courants et dépannage

  • Chemins incorrects – Vérifiez à nouveau indexFolder et documentsFolder pour les fautes de frappe et les droits d’accès appropriés.
  • Formats de fichiers non pris en charge – Vérifiez que vos documents figurent parmi les plus de 50 formats répertoriés dans la documentation de GroupDocs.Search.
  • Lenteur des performances – Pour de grands corpus, indexez par lots, surveillez l’utilisation du tas JVM et stockez l’index sur un stockage SSD.

Applications pratiques

  1. Gestion documentaire d’entreprise – Localisez rapidement les politiques, contrats ou manuels RH parmi des milliers de fichiers.
  2. Recherche juridique – Trouvez des affaires précédentes même lorsque la formulation exacte diffère, grâce à la recherche de formes de mots.
  3. Catalogues e‑commerce – Permettez aux acheteurs de rechercher les descriptions de produits en utilisant une terminologie variée, améliorant les taux de conversion.

Conseils de performance

  • Ré‑indexez uniquement lorsque de nouveaux documents sont ajoutés ou que les existants changent.
  • Utilisez le drapeau -Xmx de Java pour allouer suffisamment de mémoire du tas pour les grands index (par ex., -Xmx4g).
  • Appelez périodiquement index.optimize() (si disponible) pour compacter les fichiers d’index et réduire les entrées/sorties disque.

Conclusion

Vous savez maintenant comment add documents to index, activer la recherche floue Java et affiner GroupDocs.Search pour Java. Ces techniques vous permettent de créer des expériences de recherche réactives et riches en fonctionnalités pour n’importe quelle collection de documents.

Prochaines étapes

  • Expérimentez la correspondance floue et le classement personnalisé.
  • Intégrez le module de recherche dans une API REST pour la consommation côté front‑end.
  • Explorez la prise en charge multilingue en configurant des analyseurs spécifiques à chaque langue.

Foire aux questions

Q1 : Quels formats GroupDocs.Search prend‑il en charge ?
R1 : Il prend en charge plus de 50 formats, y compris DOCX, PDF, PPTX, XLSX, TXT, HTML et les types d’images courants. Consultez la documentation officielle pour la liste complète.

Q2 : Comment mettre à jour mon index avec de nouveaux documents ?
R2 : Appelez index.add(newDocumentsFolder) à nouveau ; la bibliothèque ajoutera uniquement les fichiers nouveaux ou modifiés, en laissant les entrées existantes intactes.

Q3 : Puis‑je personnaliser davantage les requêtes de recherche ?
R3 : Oui — SearchOptions offre des options pour la recherche floue, la sensibilité à la casse, la pagination des résultats et les algorithmes de classement personnalisés.

Q4 : Mes recherches sont lentes — que puis‑je faire ?
R4 : Stockez l’index sur un stockage SSD rapide, augmentez la taille du tas JVM (-Xmx), et évitez d’indexer des fichiers volumineux inutiles. Activez également la recherche de formes de mots uniquement lorsque cela est nécessaire.

Q5 : Où puis‑je obtenir de l’aide de la communauté ?
R5 : Utilisez le forum de support officiel : GroupDocs Support Forum.

Last Updated: 2026-05-22
Tested With: GroupDocs.Search 25.4 for Java
Author: GroupDocs

Tutoriels associés