Comment activer la recherche floue java avec GroupDocs.Search – Tutoriel de démarrage
Dans ce guide complet, vous apprendrez comment activer la recherche floue java en utilisant la bibliothèque GroupDocs.Search. Nous parcourrons l’installation du SDK, l’application d’une licence, la configuration de la correspondance floue et l’indexation de divers types de documents afin que vos utilisateurs puissent trouver du contenu pertinent même lorsqu’ils font des fautes d’orthographe ou utilisent une terminologie alternative. À la fin du tutoriel, vous disposerez d’une solution de recherche entièrement fonctionnelle prête en moins de 15 minutes.
Réponses rapides
- Quelle est la première étape ? Ajoutez la dépendance GroupDocs.Search à votre
pom.xmlMaven oubuild.gradleGradle. - Ai-je besoin d’une licence ? Oui—une licence de développement temporaire fonctionne pour les tests ; une licence permanente est requise pour les déploiements en production.
- Quel IDE fonctionne le mieux ? Tout IDE Java qui prend en charge Maven ou Gradle (IntelliJ IDEA, Eclipse, VS Code).
- Puis-je indexer des fichiers PDF, Word et Excel ? Absolument—GroupDocs.Search prend en charge nativement plus de 50 formats de fichiers, y compris PDF, DOCX, XLSX, PPTX et de nombreux types d’images.
- Comment activer la recherche floue ? Définissez la propriété
fuzzySearchsurtruedans une instance deSearchOptionsavant d’exécuter une requête. - Combien de temps prend l’ensemble de la configuration ? Typiquement moins de 15 minutes pour un nouveau projet.
Qu’est‑ce que « activer la recherche floue » dans GroupDocs.Search ?
Activer la recherche floue indique au moteur de tolérer de légères variations d’orthographe, des caractères manquants ou des lettres transposées lors de la correspondance des termes de requête. Cette fonctionnalité améliore considérablement la découvrabilité dans des scénarios tels que les fautes de frappe des utilisateurs, le texte généré par OCR ou le contenu multilingue, car l’algorithme de recherche renverra des documents pertinents même lorsque le mot‑clé exact n’est pas présent.
Pourquoi configurer GroupDocs.Search pour Java et activer la recherche floue ?
Vous obtenez immédiatement des capacités de recherche prêtes pour la production avec un code minimal, tout en offrant une expérience utilisateur plus fluide. GroupDocs.Search indexe les documents sans les charger entièrement en mémoire, prend en charge plus de 50 formats d’entrée et de sortie, et peut évoluer jusqu’à des millions de fichiers sur du matériel standard. Activer la recherche floue ajoute une couche de tolérance qui réduit les requêtes échouées jusqu’à 80 %, transformant les saisies mal orthographiées des utilisateurs en résultats précis sans effort de développement supplémentaire.
Prérequis
- Kit de développement Java (JDK) 8 ou supérieur.
- Maven 3 ou Gradle 5 pour la gestion des dépendances.
- Une clé de licence GroupDocs.Search temporaire ou permanente.
Guide étape par étape
Étape 1 : ajouter GroupDocs.Search à votre projet
Ajoutez la dépendance GroupDocs.Search à votre pom.xml (Maven) ou build.gradle (Gradle). Cela rend la bibliothèque disponible sur le classpath pour la compilation et l’exécution.
Étape 2 : appliquer votre licence
License charge et valide le fichier de licence GroupDocs.Search, débloquant toutes les fonctionnalités premium telles que la correspondance floue. Créez une instance License et pointez‑la vers le fichier .lic que vous avez reçu de GroupDocs.
Étape 3 : initialiser les paramètres d’index
Définissez un dossier sur le disque où les fichiers d’index seront stockés. Vous pouvez également configurer la sensibilité à la casse, les mots‑vides et d’autres options d’indexation à ce stade.
Étape 4 : indexer vos documents
La classe Indexer lit les fichiers, extrait le texte indexable et écrit les données dans le dossier d’index. Elle détecte automatiquement le type de fichier, vous permettant d’alimenter un mélange de PDF, DOCX, XLSX et d’images sans code supplémentaire.
Étape 5 : activer la recherche floue dans votre requête
SearchOptions configure les paramètres d’une opération de recherche, tels que la correspondance floue et les filtres.
Lorsque vous créez un objet SearchOptions, définissez son indicateur fuzzySearch sur true. Vous pouvez également ajuster le fuzzinessLevel (par ex., 2) pour contrôler le niveau de tolérance du moteur.
Étape 6 : exécuter une requête de recherche
La méthode search exécute la requête contre l’index et renvoie les résultats correspondants.
Appelez la méthode search avec la chaîne de requête et les SearchOptions configurés. La méthode renvoie une liste d’objets SearchResult, chacun contenant le chemin du document et un score de pertinence reflétant les correspondances floues. SearchResult représente une correspondance de document unique, incluant son chemin et son score de pertinence.
Étape 7 : examiner les résultats
SearchResult représente une correspondance de document unique, incluant son chemin et son score de pertinence.
Itérez sur la collection SearchResult, affichez les noms de fichiers et, éventuellement, mettez en évidence les termes correspondants dans votre interface. Les correspondances floues ont généralement un score de pertinence légèrement inférieur à celui des correspondances exactes, ce que vous pouvez utiliser pour classer les résultats.
Problèmes courants et solutions
- Licence non reconnue – Vérifiez que le chemin du fichier de licence est correct et que le fichier correspond à la version de GroupDocs.Search que vous utilisez.
- Formats de documents manquants – Installez le module optionnel
groupdocs-conversionpour prendre en charge des types de fichiers moins courants. - La recherche floue ne renvoie aucun résultat – Assurez‑vous que le drapeau
fuzzySearchest àtrueet que la longueur de la requête respecte le nombre minimum de caractères (généralement trois). - Goulots d’étranglement de performance – Utilisez l’indexation incrémentielle et stockez le dossier d’index sur un SSD pour améliorer la vitesse de lecture/écriture.
Questions fréquemment posées
Q : Puis‑je exécuter GroupDocs.Search sur un serveur Linux ?
R : Oui, la bibliothèque est indépendante de la plateforme et fonctionne sur tout système d’exploitation qui prend en charge Java.
Q : Comment ajouter de nouveaux fichiers à un index existant ?
R : Invoquez à nouveau le Indexer avec les nouveaux fichiers ; le SDK les fusionne automatiquement dans l’index actuel.
Q : Est‑il possible de limiter les résultats de recherche à un dossier spécifique ?
R : Oui, définissez un filtre de dossier dans SearchOptions avant d’exécuter la requête.
Q : Que se passe‑t‑il après l’expiration de la licence temporaire ?
R : L’API passe en mode d’évaluation avec des fonctionnalités limitées ; remplacez la clé temporaire par une licence permanente pour retrouver toutes les fonctionnalités.
Q : GroupDocs.Search prend‑il en charge la recherche floue ?
R : Absolument—activez le drapeau fuzzySearch dans SearchOptions pour récupérer les résultats contenant de légères variations d’orthographe.
Q : Puis‑je combiner la recherche floue avec d’autres filtres comme les plages de dates ?
R : Oui, vous pouvez ajouter des filtres supplémentaires à SearchOptions tout en conservant la correspondance floue active.
Ressources supplémentaires
Tutoriels disponibles
Déployer GroupDocs.Search pour Java : Guide d’installation complet
Apprenez comment déployer et configurer GroupDocs.Search pour Java avec ce guide étape par étape. Améliorez l’indexation des documents et les capacités de recherche dans vos projets.
Liens utiles
- Documentation GroupDocs.Search pour Java
- Référence API GroupDocs.Search pour Java
- Télécharger GroupDocs.Search pour Java
- Forum GroupDocs.Search
- Support gratuit
- Licence temporaire
Dernière mise à jour : 2026-10-17
Testé avec : GroupDocs.Search 23.12 pour Java
Auteur : GroupDocs