Comment activer l’orthographe en Java avec GroupDocs.Search

Des résultats de recherche précis sont essentiels pour toute application moderne. Dans ce tutoriel, vous apprendrez comment activer la correction orthographique en Java avec GroupDocs.Search, afin que les utilisateurs obtiennent les bons résultats même lorsqu’ils tapent mal leurs requêtes. Nous parcourrons la création d’un index, l’ajout de documents à l’index, la configuration des options d’orthographe et l’exécution d’une recherche qui corrige automatiquement les erreurs.

Réponses rapides

Que signifie « comment activer l’orthographe » ? Cela active le correcteur orthographique intégré qui corrige les fautes de frappe des utilisateurs pendant une recherche.
Quelle bibliothèque fournit cette fonctionnalité ? GroupDocs.Search for Java.
Ai‑je besoin d’une licence ? Une licence d’essai gratuite suffit pour l’évaluation ; une licence complète est requise pour la production.
Puis‑je contrôler la tolérance ? Oui – utilisez setMaxMistakeCount pour définir le nombre de fautes autorisées.
Est‑il adapté aux gros index ? Absolument – le moteur est optimisé pour l’indexation et la recherche haute performance.

Qu’est‑ce que « comment activer l’orthographe » dans GroupDocs.Search ?

Activer l’orthographe indique au moteur de recherche de rechercher les termes corrects les plus proches lorsqu’une requête contient des erreurs. Cette fonctionnalité améliore considérablement l’expérience utilisateur en renvoyant des résultats pertinents même avec une saisie mal orthographiée.

Pourquoi activer la correction orthographique dans les applications Java ?

Améliore la satisfaction des utilisateurs – les utilisateurs n’ont pas besoin de taper parfaitement.
Réduit le taux de rebond – des résultats plus précis maintiennent les visiteurs engagés.
Fonctionne dans tous les domaines – des catalogues de bibliothèques aux recherches de produits e‑commerce.

Prérequis

Java Development Kit (JDK) installé.
Connaissances de base en Java et Maven.
Compréhension des concepts d’indexation.
Une version d’essai ou une clé de licence GroupDocs.Search.

Configuration de GroupDocs.Search pour Java

Intégrez la bibliothèque à votre projet Maven.

Configuration Maven
Ajoutez le dépôt et la dépendance à votre fichier 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 la dernière version depuis GroupDocs.Search for Java releases.

Acquisition de licence

Obtenez une licence d’essai gratuite pour l’évaluation. Pour une utilisation en production, achetez une licence complète ou demandez une clé temporaire sur le site officiel.

Comment ajouter des documents à l’index

Créer un index est la base de toute application dotée de recherche. Ci-dessous, un exemple minimal qui ajoute des documents à l’index depuis un dossier.

import com.groupdocs.search.*;

public class FeatureIndexAndAddDocuments {
    public static void main(String[] args) {
        // Define where the index will be stored
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        
        // Create an Index instance pointing to the specified folder
        Index index = new Index(indexFolder);
        
        // Specify the documents directory for indexing
        String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";  
        
        // Add documents from this directory to the index
        index.add(documentsFolder);
    }
}

Astuce : Vérifiez que les chemins sont corrects et que l’application possède les permissions d’écriture sur le dossier d’index.

Comment configurer la correction orthographique (définir le nombre maximal d’erreurs)

Vous pouvez affiner le correcteur orthographique en l’activant et en définissant la tolérance aux erreurs.

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;

public class FeatureSpellingCorrectionOptions {
    public static void main(String[] args) {
        // Instantiate SearchOptions
        SearchOptions options = new SearchOptions();
        
        // Enable spelling correction
        options.getSpellingCorrector().setEnabled(true);
        
        // Allow up to one mistake during search
        options.getSpellingCorrector().setMaxMistakeCount(1);
        
        // Return only the best results after correction
        options.getSpellingCorrector().setOnlyBestResults(true);
    }
}

Pourquoi setMaxMistakeCount est important : Il définit le nombre de fautes que le moteur tolérera. Ajustez cette valeur en fonction des schémas d’erreurs typiques de votre domaine.

Comment effectuer une recherche avec correction orthographique

Avec l’index prêt et les options d’orthographe configurées, exécutez une requête pouvant contenir des erreurs.

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;
import com.groupdocs.search.results.*;

public class FeatureSpellingCorrectionSearch {
    public static void main(String[] args) {
        // Create an index in the specified directory
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        Index index = new Index(indexFolder);
        
        // Define search options with spelling correction enabled
        SearchOptions options = new SearchOptions();
        options.getSpellingCorrector().setEnabled(true);
        options.getSpellingCorrector().setMaxMistakeCount(1);
        options.getSpellingCorrector().setOnlyBestResults(true);
        
        // Specify a misspelled search query
        String query = "houseohld";
        
        // Execute the spelling‑corrected search
        SearchResult result = index.search(query, options);
    }
}

L’appel search() renvoie un SearchResult contenant les termes corrigés et les documents les plus pertinents.

Applications pratiques

Systèmes de bibliothèque : Corriger les titres de livres ou les noms d’auteurs mal orthographiés.
Plateformes e‑commerce : Corriger les fautes de frappe des utilisateurs dans les recherches de produits pour augmenter les conversions.
Systèmes de gestion de contenu : Améliorer la récupération d’articles pour le personnel éditorial.

Considérations de performance

Maintenez l’index à jour – ré‑indexez régulièrement les fichiers nouveaux ou modifiés.
Ajustez les paramètres de mémoire JVM – allouez un tas suffisant pour les gros index.
Surveillez l’utilisation des ressources – ajustez les options du ramasse‑miettes si nécessaire.

Problèmes courants & dépannage

Symptom	Likely Cause	Fix
Aucun résultat retourné après l’activation de la correction orthographique	Le chemin du dossier d’index est incorrect ou vide	Vérifiez que `indexFolder` pointe vers un index valide et que `index.add()` a réussi
Le correcteur orthographique ne corrige pas les fautes évidentes	`setMaxMistakeCount` est réglé trop bas	Augmentez le nombre à 2 ou 3 pour une correction plus tolérante
L’application plante avec de grands ensembles de documents	Mémoire JVM insuffisante	Augmentez l’option `-Xmx` (par ex., `-Xmx4g`)

Questions fréquemment posées

Q : Qu’est‑ce que GroupDocs.Search ?
R : C’est une bibliothèque Java qui fournit un indexage rapide, des fonctionnalités de recherche avancées et une correction orthographique intégrée.

Q : Comment obtenir une licence pour GroupDocs.Search ?
R : Visitez le site officiel pour télécharger une version d’essai gratuite ou acheter une licence complète.

Q : Puis‑je intégrer GroupDocs.Search avec d’autres frameworks Java ?
R : Oui, il fonctionne avec Spring, Jakarta EE et toute application Java standard.

Q : Quels sont les problèmes courants lors de la configuration d’un index ?
R : Chemins de dossiers incorrects, permissions de fichiers insuffisantes, ou dépendances manquantes dans pom.xml.

Q : Comment la correction orthographique améliore‑t‑elle les résultats de recherche ?
R : Elle réécrit automatiquement les requêtes mal orthographiées en leurs termes les plus proches corrects, renvoyant des résultats plus pertinents.

Ressources supplémentaires

Dernière mise à jour : 2026-02-21
Testé avec : GroupDocs.Search 25.4
Auteur : GroupDocs