Ajouter des documents à l’index et gestion des alias dans GroupDocs.Search Java : guide complet

Dans le monde actuel axé sur les données, la capacité d’ajouter des documents à l’index rapidement et de les rechercher efficacement peut offrir à votre entreprise un véritable avantage concurrentiel. Que vous manipuliez des milliers de contrats, des catalogues de produits ou des articles de recherche, GroupDocs.Search pour Java simplifie la création d’index consultables et l’ajustement fin des requêtes grâce aux dictionnaires d’alias.

Vous découvrirez ci‑dessous tout ce dont vous avez besoin pour configurer la bibliothèque, ajouter des documents à l’index, gérer les alias et exécuter des recherches puissantes — le tout expliqué de manière conviviale, étape par étape.

Réponses rapides

• Quelle est la première étape pour commencer à utiliser GroupDocs.Search ? Ajoutez la dépendance Maven et initialisez un objet Index.
• Comment ajouter des documents à l’index ? Appelez index.add("<folder_path>") avec le dossier contenant vos fichiers.
• Puis‑je créer des alias pour des requêtes complexes ? Oui — utilisez le dictionnaire d’alias pour associer des jetons courts à des expressions de requête complètes.
• Est‑il possible d’exporter et d’importer des dictionnaires d’alias ? Absolument — utilisez les méthodes exportDictionary et importDictionary.
• Quelle version de GroupDocs.Search est requise ? La version 25.4 ou ultérieure (le tutoriel utilise la 25.4).

Qu’est‑ce que « ajouter des documents à l’index » ?

Ajouter des documents à un index signifie alimenter GroupDocs.Search avec des fichiers bruts (PDF, DOCX, TXT, etc.) afin que la bibliothèque puisse analyser leur contenu et construire une structure de données consultable. Une fois indexés, vous pouvez exécuter des requêtes plein texte rapides sur l’ensemble de ces documents.

Pourquoi gérer les alias ?

Les alias vous permettent de remplacer de longs fragments de requête répétitifs par des jetons courts et mémorables (par ex., @t → (gravida OR promotion)). Cela raccourcit non seulement vos chaînes de recherche, mais améliore également la lisibilité et la maintenance, surtout lorsque les requêtes deviennent complexes.

Prérequis

• GroupDocs.Search for Java ≥ 25.4.
• JDK (toute version récente, par ex., 11+).
• Un IDE tel que IntelliJ IDEA ou Eclipse.
• Connaissances de base en Java et Maven.

Configuration de GroupDocs.Search pour Java

Utilisation de 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.

Étapes d’obtention de licence

1. Free Trial – explorez toutes les fonctionnalités sans engagement.
2. Temporary License – demandez une clé à court terme pour l’évaluation.
3. Full Purchase – obtenez une licence permanente pour une utilisation en production.

Initialisation et configuration de base

import com.groupdocs.search.Index;

public class GroupDocsSetup {
    public static void main(String[] args) {
        // Specify the directory to store indices
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY/Indexes/Index";
        
        // Create or open an index
        Index index = new Index(indexFolder);
        
        System.out.println("GroupDocs.Search setup complete.");
    }
}

Guide de mise en œuvre

Voici un guide complet de chaque fonctionnalité. N’hésitez pas à lire d’abord les explications, puis à copier le bloc de code correspondant.

Création ou ouverture d’un index

Comment ajouter des documents à l’index – vous avez d’abord besoin d’une instance active d’Index.

Étape 1 : Importer la classe Index

import com.groupdocs.search.Index;

Étape 2 : Définir l’emplacement des fichiers d’index

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/Indexes/Index";

Étape 3 : Créer un nouvel index ou en ouvrir un existant

Index index = new Index(indexFolder);

Ajout de documents à un index

Maintenant que l’index existe, ajoutons des documents à l’index.

Étape 1 : Pointer vers votre dossier source

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/Documents";

Étape 2 : Ajouter chaque fichier pris en charge depuis ce dossier

index.add(documentsFolder);

Astuce : Exécutez cette étape chaque fois que de nouveaux fichiers arrivent. GroupDocs.Search n’indexera que le nouveau contenu, en laissant les entrées existantes intactes.

Gestion du dictionnaire d’alias

Les alias vous permettent d’associer des jetons courts à des chaînes de requête complexes. Nous couvrirons la suppression des anciennes entrées, l’ajout d’alias uniques, et l’ajout de plusieurs alias en masse.

Suppression des alias existants

if (index.getDictionaries().getAliasDictionary().getCount() > 0) {
    index.getDictionaries().getAliasDictionary().clear();
}

Ajout d’alias uniques

index.getDictionaries().getAliasDictionary().add("t", "(gravida OR promotion)");
index.getDictionaries().getAliasDictionary().add("e", "(viverra OR farther)");

Ajout de plusieurs alias

AliasReplacementPair[] pairs = new AliasReplacementPair[] {
    new AliasReplacementPair("d", "daterange(2017-01-01 ~~ 2019-12-31)"),
    new AliasReplacementPair("n", "(400 ~~ 4000)")
};
index.getDictionaries().getAliasDictionary().addRange(pairs);

Interrogation des remplacements d’alias

Vous pouvez récupérer le texte complet de tout alias que vous avez défini :

if (index.getDictionaries().getAliasDictionary().contains("e")) {
    String replacement = index.getDictionaries().getAliasDictionary().getText("e");
}

Exportation et importation du dictionnaire d’alias

L’exportation est pratique pour la sauvegarde ou le partage entre environnements.

Exporter les alias

String fileName = "YOUR_OUTPUT_DIRECTORY/Aliases.dat";
index.getDictionaries().getAliasDictionary().exportDictionary(fileName);

Importer les alias

index.getDictionaries().getAliasDictionary().importDictionary(fileName);

Recherche avec des requêtes d’alias

Avec les alias en place, vos chaînes de recherche deviennent beaucoup plus claires :

String query = "@t OR @e";
SearchResult result = index.search(query);

Le symbole @ indique à GroupDocs.Search de remplacer le jeton par son expression complète avant d’exécuter la recherche.

Applications pratiques

Considérations de performance

• Indexation incrémentielle : Ajoutez uniquement les fichiers nouveaux ou modifiés ; évitez une réindexation complète.
• Optimisation JVM : Allouez suffisamment de mémoire heap (-Xmx4g pour de grands corpus).
• Mises à jour d’alias par lots : Utilisez addRange pour insérer de nombreux alias en une fois, réduisant la surcharge.

Conclusion

Vous savez maintenant comment ajouter des documents à l’index, gérer un dictionnaire d’alias et exécuter des recherches efficaces avec GroupDocs.Search pour Java. Ces techniques rendront vos applications basées sur la recherche plus rapides, plus faciles à maintenir et plus simples à interroger pour les utilisateurs finaux.

Prochaines étapes : Expérimentez avec des analyseurs personnalisés, explorez les options de recherche floue, et intégrez l’index dans un service web pour des requêtes en temps réel.

Questions fréquentes

Q : Quel est le principal avantage d’utiliser GroupDocs.Search pour Java ?
A : Il offre des capacités d’indexation puissantes, prêtes à l’emploi, et de recherche plein texte, vous permettant d’ajouter des documents à l’index rapidement et de les interroger avec des performances élevées.

Q : Puis‑je utiliser GroupDocs.Search avec des bases de données ?
A : Oui — extrayez les données de n’importe quelle source (SQL, NoSQL, CSV) et alimentez l’index en utilisant les mêmes méthodes add.

Q : Comment les alias améliorent-ils l’efficacité de la recherche ?
A : Les alias vous permettent de stocker une logique de requête complexe une seule fois et de la réutiliser avec des jetons courts, réduisant le temps d’analyse des requêtes et minimisant les erreurs humaines.

Q : Est‑il possible de mettre à jour un alias existant sans reconstruire tout le dictionnaire ?
A : Absolument — appelez simplement add avec la même clé ; la bibliothèque écrasera la valeur précédente.

Q : Que faire si ma recherche renvoie des résultats inattendus ?
A : Vérifiez que les définitions d’alias sont correctes, ré‑indexez les documents récemment ajoutés, et examinez les paramètres de l’analyseur pour d’éventuels problèmes de tokenisation.

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