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

Dans le monde actuel axé sur les données, pouvoir ajouter plusieurs alias tout en ajoutant des documents à l’index donne à votre solution de recherche un net avantage de performance. Que vous indexiez des milliers de contrats, des catalogues de produits ou des articles de recherche, GroupDocs.Search pour Java vous permet de créer des structures d’index recherchables et d’affiner les requêtes avec des dictionnaires d’alias—tout en gardant une implémentation simple et rapide.

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 mapper de courts jetons à des expressions de requête complètes, et vous pouvez également ajouter plusieurs alias en masse.
• 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 ? 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 fournir des fichiers bruts (PDF, DOCX, TXT, etc.) à GroupDocs.Search afin que la bibliothèque puisse analyser leur contenu et créer un index recherchable. 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é, la maintenabilité et optimise les performances de recherche, surtout lorsque les requêtes deviennent complexes.

Comment ajouter plusieurs alias ?

GroupDocs.Search propose une méthode pratique addRange qui vous permet d’insérer de nombreuses paires alias‑remplacement en une seule fois. Cette opération en lot réduit la surcharge comparée à l’ajout de chaque alias individuellement.

Prérequis

• GroupDocs.Search pour 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 référentiel 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

Alternativement, téléchargez le dernier JAR depuis le site officiel :
versions GroupDocs.Search pour Java.

Étapes d’obtention de licence

1. Essai gratuit – explorez toutes les fonctionnalités sans engagement.
2. Licence temporaire – demandez une clé à court terme pour l’évaluation.
3. Achat complet – obtenez une licence permanente pour l’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 d’implémentation

Voici un guide complet de chaque fonctionnalité. Lisez d’abord les explications, puis copiez 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. C’est l’essence de l’indexation incrémentale java.

Gestion du dictionnaire d’alias

Les alias vous permettent de mapper de courts jetons à 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’un alias unique

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émentale : 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 lot : Utilisez addRange pour insérer de nombreux alias en une fois, réduisant la surcharge.
• Optimiser les performances de recherche : Gardez le dictionnaire d’alias léger et réutilisez les jetons judicieusement afin de minimiser le temps d’analyse des requêtes.

Problèmes courants et solutions

Questions fréquemment posées

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

Q : Puis‑je utiliser GroupDocs.Search avec des bases de données ?
R : 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 ?
R : Les alias vous permettent de stocker une logique de requête complexe une seule fois et de la réutiliser avec de courts jetons, réduisant le temps d’analyse des requêtes et minimisant les erreurs humaines lorsque vous recherchez avec des alias.

Q : Est‑il possible de mettre à jour un alias existant sans reconstruire tout le dictionnaire ?
R : 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 ?
R : Vérifiez que les définitions d’alias sont correctes, ré‑indexez les documents récemment ajoutés et contrôlez les paramètres de l’analyseur pour des problèmes de tokenisation.

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