Comment ajouter des synonymes en Java avec GroupDocs.Search

Bienvenue dans notre guide complet sur comment ajouter des synonymes en Java avec GroupDocs.Search. Que vous construisiez un CMS riche en contenu, un catalogue e‑commerce ou un référentiel de documents, activer la prise en charge des synonymes peut améliorer considérablement la découvrabilité de vos données. Dans ce tutoriel, vous apprendrez à créer et gérer des dictionnaires de synonymes, à importer des fichiers de dictionnaire de synonymes et à optimiser votre index de recherche pour des résultats rapides et précis.

Réponses rapides

Quelle est l’étape principale pour ajouter des synonymes ? Initialise un Index et utilise l’API SynonymDictionary.
Puis‑je importer un dictionnaire de synonymes ? Oui – utilise importDictionary(path) pour charger un fichier pré‑construit.
Comment activer la recherche avec des synonymes ? Définit SearchOptions.setUseSynonymSearch(true).
Est‑il possible de gérer des groupes de synonymes ? Absolument – vous pouvez nettoyer, ajouter ou récupérer des groupes via l’API du dictionnaire.
Que faut‑il considérer lors de l’optimisation de l’index de recherche ? Supprimez régulièrement les entrées inutilisées et ajustez le tas JVM pour les grands ensembles de données.

Qu’est‑ce que « Comment ajouter des synonymes » ?

Ajouter des synonymes signifie définir des mots ou expressions alternatives que le moteur de recherche traite comme équivalents. Cela permet à une requête comme « better » de correspondre également aux documents contenant « improve », « enhance » ou « upgrade ».

Pourquoi utiliser la prise en charge des synonymes dans GroupDocs.Search ?

Expérience utilisateur améliorée : Les utilisateurs trouvent du contenu pertinent même s’ils utilisent une terminologie différente.
Taux de conversion plus élevés : Les sites e‑commerce capturent plus de ventes en faisant correspondre des requêtes produit variées.
Maintenance réduite : Un seul dictionnaire peut servir plusieurs applications, simplifiant les mises à jour.

Prérequis

GroupDocs.Search for Java version 25.4 ou plus récente.
Un IDE Java (IntelliJ IDEA, Eclipse, etc.) avec prise en charge de Maven.
Connaissances de base en Java et familiarité avec la structure d’un projet Maven.

Bibliothèques requises et versions

GroupDocs.Search for Java version 25.4 ou supérieure.

Configuration de l’environnement

IDE de votre choix (IntelliJ IDEA, Eclipse, etc.).
Maven pour la gestion des dépendances.

Compétences requises

Programmation orientée objet en Java.
Opérations de base en I/O de fichiers.

Configuration de GroupDocs.Search pour Java

Informations d’installation

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 – vous pouvez également télécharger le JAR le plus récent depuis GroupDocs.Search for Java releases.

Acquisition de licence

Essai gratuit : Testez les fonctionnalités principales sans licence.
Licence temporaire : Prolongez les capacités d’essai pendant l’évaluation.
Achat : Nécessaire pour une utilisation en production et l’accès à l’ensemble complet des fonctionnalités.

Initialisation et configuration de base

Créez une instance Index, puis ajoutez les documents à indexer :

import com.groupdocs.search.*;

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Index";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath2";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Adding documents from a specific folder to the index
index.add(documentsFolder);

Comment ajouter des synonymes à votre index de recherche

Créer un index est la base. Ci‑dessous, nous parcourons les étapes essentielles, chacune accompagnée du code exact dont vous avez besoin.

Fonctionnalité 1 : Création et indexation d’un index

// Create an index in the specified folder
Index index = new Index(indexFolder);

// Add documents from the given folder to the index
index.add(documentsFolder);

Fonctionnalité 2 : Récupération des synonymes d’un mot

String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");

Fonctionnalité 3 : Récupération des groupes de synonymes

String[][] synonymGroups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");

Fonctionnalité 4 : Gestion des entrées du dictionnaire de synonymes

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

String[][] newSynonymGroups = new String[][]{
    new String[] { "achieve", "accomplish", "attain", "reach" },
    new String[] { "accept", "take", "have" },
    new String[] { "improve", "better" }
};

index.getDictionaries().getSynonymDictionary().addRange(newSynonymGroups);

Fonctionnalité 5 : Exportation des synonymes vers un fichier

String exportFilePath = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Synonyms.dat";
index.getDictionaries().getSynonymDictionary().exportDictionary(exportFilePath);

Fonctionnalité 6 : Importation des synonymes depuis un fichier

index.getDictionaries().getSynonymDictionary().importDictionary(exportFilePath);

Fonctionnalité 7 : Exécution d’une recherche avec prise en charge des synonymes

String query = "better";
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);

SearchResult result = index.search(query, options);

Comment rechercher avec des synonymes

En activant setUseSynonymSearch(true), le moteur étend automatiquement la requête à l’aide du dictionnaire de synonymes que vous avez créé ou importé. Cette étape est cruciale pour fournir des résultats plus riches sans modifier le comportement de recherche de l’utilisateur.

Comment importer un dictionnaire de synonymes

Si vous disposez déjà d’un fichier .dat préparé dans un autre environnement, appelez simplement importDictionary(path). C’est idéal pour synchroniser les dictionnaires entre les serveurs de développement, de préproduction et de production.

Comment gérer les groupes de synonymes

Les groupes de synonymes vous permettent de traiter un ensemble de termes comme une entité logique unique. Ajouter, nettoyer ou récupérer des groupes se fait via l’API SynonymDictionary, comme illustré dans les extraits de code ci‑dessus.

Comment optimiser l’index de recherche

Supprimer régulièrement les entrées inutilisées : Utilisez clear() avant les mises à jour massives.
Ajuster le tas JVM : Les grands dictionnaires peuvent nécessiter plus de mémoire.
Maintenir la bibliothèque à jour : Les nouvelles versions contiennent des améliorations de performances.

Applications pratiques

Systèmes de gestion de contenu (CMS) : Les utilisateurs trouvent des articles même s’ils utilisent une terminologie alternative.
Plateformes e‑commerce : Les recherches de produits tolèrent les synonymes comme « laptop » vs. « notebook ».
Référentiels de documents : Les archives juridiques ou médicales bénéficient de groupes de synonymes spécifiques au domaine.

Considérations de performance

Optimiser le stockage de l’index : Reconstruisez périodiquement l’index pour éliminer les données obsolètes.
Gérer l’utilisation de la mémoire : Surveillez la consommation du tas lors du chargement de gros fichiers de synonymes.
Mises à jour régulières : Restez sur la dernière version de GroupDocs.Search pour les correctifs de bugs et les gains de vitesse.

Conclusion

Vous disposez maintenant d’une feuille de route complète, étape par étape, pour comment ajouter des synonymes, importer des fichiers de dictionnaire de synonymes, gérer les groupes de synonymes et rechercher avec des synonymes en utilisant GroupDocs.Search pour Java. Appliquez ces techniques pour améliorer la pertinence, augmenter la satisfaction des utilisateurs et maintenir votre index de recherche à son meilleur niveau de performance.

Questions fréquentes

Q : Quelle est la configuration système minimale pour utiliser GroupDocs.Search ?
R : Tout système d’exploitation moderne avec un JDK compatible (Java 8 ou plus récent) suffit.

Q : À quelle fréquence dois‑je rafraîchir mon dictionnaire de synonymes ?
R : Mettez‑le à jour chaque fois que de nouveaux termes apparaissent — utilisez clear() suivi de addRange() pour un rafraîchissement propre.

Q : Puis‑je utiliser GroupDocs.Search sans acheter de licence ?
R : Un essai gratuit fonctionne pour l’évaluation, mais une licence est requise pour les déploiements en production.

Q : Quelles sont les meilleures pratiques pour indexer de grands ensembles de données ?
R : Divisez les données en lots logiques, surveillez l’utilisation du tas et planifiez une maintenance régulière de l’index.

Q : Je ne vois pas les correspondances attendues avec les synonymes—que vérifier ?
R : Vérifiez que le dictionnaire est correctement importé, que setUseSynonymSearch(true) est actif, et que les termes sont présents dans les groupes de synonymes.

Ressources

Dernière mise à jour : 2025-12-19
Testé avec : GroupDocs.Search 25.4 for Java
Auteur : GroupDocs