Comment créer un index Java avec GroupDocs.Search et activer la recherche homophone

Dans les entreprises modernes, create index java rapidement et de manière fiable peut faire la différence entre trouver une information cruciale ou la manquer complètement. Que vous indexiez des contrats juridiques, des retours clients ou des rapports internes, un index de recherche bien construit alimenté par GroupDocs.Search for Java vous fournit des résultats instantanés et précis. Dans ce tutoriel, nous parcourrons l’ensemble du processus — de la configuration de la bibliothèque, à la création de l’index, à l’ajout de documents, puis à l’activation de la recherche homophone pour des requêtes plus intelligentes.

Réponses rapides

  • Quelle est la première étape pour créer un index ? Initialise l’objet Index avec le chemin d’un dossier.
  • Quelle méthode ajoute des fichiers à l’index ? index.add(yourDocumentsFolder).
  • Comment activer la recherche homophone ? Définissez options.setUseHomophoneSearch(true).
  • Ai-je besoin d’une licence ? Une licence d’essai gratuite ou temporaire suffit pour l’évaluation.
  • Quelle version de Java est requise ? JDK 8 ou supérieur.

Qu’est‑ce qu’un index dans GroupDocs.Search ?

Index est la classe principale qui stocke les termes recherchables et leurs emplacements dans les documents. Le Index est la structure de données centrale de GroupDocs.Search qui conserve les termes et leurs emplacements dans votre collection de documents, permettant des recherches ultra‑rapides. Il fonctionne comme l’index d’un livre mais peut gérer des millions de termes à travers des dizaines de formats de fichiers, offrant une récupération rapide même pour de grands corpus.

Pourquoi activer la recherche homophone ?

La recherche homophone étend une requête pour inclure des mots qui sonnent de la même façon (p. ex., « write » vs. « right »). Cela augmente le rappel jusqu’à 30 % dans des scénarios d’entrée utilisateur bruyante, garantissant que les utilisateurs obtiennent des résultats même lorsqu’ils font des fautes d’orthographe ou utilisent des variantes orthographiques. C’est particulièrement précieux pour les interfaces vocales et les environnements multilingues.

Prérequis

  • Java Development Kit 8 ou plus récent.
  • Bibliothèque GroupDocs.Search for Java (disponible via Maven).
  • Familiarité de base avec la syntaxe Java et la configuration du projet.

Configuration de GroupDocs.Search pour Java

Tout d’abord, ajoutez le dépôt Maven GroupDocs.Search 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>

Alternativement, vous pouvez télécharger la dernière version depuis les releases GroupDocs.Search pour Java.

Acquisition de licence : GroupDocs propose une licence d’essai gratuite ou des licences temporaires pour l’évaluation. Pour acheter, visitez leur site officiel.

Initialisation et configuration de base

Créez une classe Java simple pour initialiser l’index de recherche :

import com.groupdocs.search.Index;

public class SearchSetup {
    public static void main(String[] args) {
        // Specify the path to store index files
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\HomophoneSearch";
        
        // Create an instance of Index
        Index index = new Index(indexFolder);
        
        System.out.println("Index created successfully!");
    }
}

Comment créer un index Java avec GroupDocs.Search Java ?

Index est la classe principale qui représente un index searchable stocké sur disque. Chargez ou créez l’index en pointant le constructeur Index vers un dossier où la bibliothèque peut stocker ses fichiers internes. Cette opération crée les fichiers de métadonnées nécessaires et prépare le moteur à l’ingestion de documents, permettant l’ajout ultérieur de documents et l’exécution de requêtes.

Étape 1 : Définir le chemin de l’index

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\HomophoneSearch";

Remplacez YOUR_DOCUMENT_DIRECTORY par le chemin absolu sur votre machine.

Étape 2 : Instancier l’objet Index

Index index = new Index(indexFolder);

Cette ligne crée l’index qui contiendra ensuite tout le contenu searchable.

Comment ajouter des documents à l’index ?

add est une méthode de la classe Index qui ingère les fichiers d’un dossier dans l’index. Une fois l’index créé, vous devez le nourrir avec les documents que vous souhaitez rechercher. La méthode add parcourt le répertoire de façon récursive et indexe chaque fichier supporté, extrayant le texte et construisant des tables de fréquence des termes pour une récupération rapide.

Étape 1 : Pointer vers vos documents source

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";

Ce dossier doit contenir les fichiers (PDF, DOCX, TXT, etc.) que vous souhaitez indexer.

Étape 2 : Ajouter tous les fichiers du dossier

index.add(documentsFolder);

La méthode add traite chaque fichier, extrait le texte et stocke les données de fréquence des termes, ajoutant effectivement des documents à l’index.

Comment activer la recherche homophone ?

setUseHomophoneSearch est une méthode de SearchOptions qui active la correspondance phonétique pour les requêtes. Maintenant que l’index est peuplé, vous pouvez activer la correspondance phonétique pour capturer les termes similaires en son. L’activation de cette fonctionnalité indique au moteur de prendre en compte les équivalents phonétiques lors du traitement des requêtes, améliorant le rappel pour les entrées mal orthographiées ou orales.

Étape 1 : Créer SearchOptions

import com.groupdocs.search.SearchOptions;

SearchOptions options = new SearchOptions();

SearchOptions configure la façon dont le moteur interprète les requêtes.

Étape 2 : Activer la recherche homophone

options.setUseHomophoneSearch(true);

Définir setUseHomophoneSearch(true) indique au moteur de prendre en compte les équivalents phonétiques lors du traitement des requêtes.

Applications pratiques

  1. Gestion de documents juridiques – Trouver les contrats qui mentionnent « lease » même si l’utilisateur tape « leas ».
  2. Analyse des retours clients – Capturer les variantes comme « price » et « prise » dans les réponses aux enquêtes.
  3. Systèmes de gestion de contenu – Améliorer la recherche du site en faisant correspondre « write » avec « right ».

Considérations de performance

  • Reconstruire régulièrement l’index après des mises à jour massives de documents pour garder les statistiques de termes à jour.
  • Surveiller la mémoire utilisée ; le moteur peut traiter des documents de plusieurs centaines de pages sans charger le fichier complet en mémoire grâce à l’indexation incrémentale.
  • Suivre les meilleures pratiques Java (par ex., try‑with‑resources, gestion appropriée des exceptions) pour maintenir l’application stable sous charge.

Conclusion

Vous savez maintenant comment créer un index java, comment ajouter des documents à l’index, et comment activer la recherche homophone avec GroupDocs.Search for Java. Ces capacités vous permettent de créer des expériences de recherche rapides et intelligentes sur n’importe quel référentiel de documents.

Prochaines étapes

  • Expérimentez avec des analyseurs personnalisés pour affiner la tokenisation.
  • Combinez la recherche à facettes avec le support homophone pour un filtrage plus riche.
  • Explorez l’API REST GroupDocs.Search pour des scénarios multiplateformes.

Questions fréquentes

Q: Qu’est‑ce qu’un index dans le contexte de GroupDocs.Search ?
R: Un index est une structure de données qui associe les termes à leurs emplacements dans les documents, permettant une récupération en millisecondes similaire à l’index d’un livre.

Q: Comment mettre à jour mon index avec de nouveaux documents ?
R: Appelez index.add(newFolder) pour ingérer des fichiers supplémentaires ou ré‑indexer les existants ; le moteur met à jour les tables de termes de façon incrémentale.

Q: GroupDocs.Search peut‑il gérer de gros volumes de données ?
R: Oui, il s’adapte à des millions de documents et prend en charge le traitement de fichiers de plus de 500 MB sans charger le contenu complet en mémoire.

Q: Que sont les homophones dans la fonctionnalité de recherche ?
R: Les homophones sont des mots qui se prononcent de la même façon mais diffèrent à l’écrit, comme « write » et « right ». Activer cette fonctionnalité élargit la couverture des requêtes.

Q: Comment dépanner les erreurs d’indexation ?
R: Vérifiez les chemins de fichiers, assurez‑vous des permissions de lecture, et examinez la sortie du journal pour des messages d’exception spécifiques ; les problèmes courants incluent des formats non supportés ou des fichiers corrompus.

Ressources

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

Tutoriels associés