Comment utiliser les synonymes en Java avec GroupDocs.Search

Si vous souhaitez que vos utilisateurs trouvent le bon contenu même lorsqu’ils tapent des mots différents, la recherche avec synonymes est la solution. Dans ce guide, vous apprendrez comment créer un dictionnaire de synonymes, l’importer ou l’exporter, gérer les groupes de synonymes et exécuter une recherche qui étend automatiquement les requêtes en utilisant ces synonymes. Que vous construisiez un CMS, un catalogue e‑commerce ou un référentiel de documents juridiques, ajouter la prise en charge des synonymes peut augmenter considérablement la pertinence et les taux de conversion.

Réponses rapides

  • Quelle est la première étape pour ajouter des synonymes ? Créez une instance Index et travaillez avec l’API SynonymDictionary.
  • Puis‑je importer un dictionnaire de synonymes prêt à l’emploi ? Oui – appelez importDictionary(path) avec l’emplacement du fichier.
  • Comment activer la recherche sensible aux synonymes ? Activez SearchOptions.setUseSynonymSearch(true).
  • Est‑il possible de modifier les groupes de synonymes à l’exécution ? Absolument – vous pouvez effacer, ajouter ou récupérer des groupes via l’API du dictionnaire.
  • Que dois‑je surveiller lors de la mise à l’échelle de l’index ? Supprimez régulièrement les entrées inutilisées et ajustez le tas JVM pour les gros fichiers de synonymes.

Qu’est‑ce que la recherche avec synonymes ?

La recherche avec synonymes signifie que le moteur considère un ensemble de mots ou d’expressions comme interchangeables. Lorsqu’un utilisateur tape « better », le moteur recherche également « improve », « enhance » ou tout autre terme que vous avez défini dans le même groupe de synonymes, offrant des résultats plus riches sans modifier la requête de l’utilisateur.

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

Activer la prise en charge des synonymes permet au moteur d’élargir automatiquement les requêtes pour inclure des termes équivalents, ce qui améliore la pertinence des résultats, augmente la satisfaction des utilisateurs et peut augmenter les taux de conversion pour les sites e‑commerce ou à contenu. Cela centralise également la gestion de la terminologie, réduisant la charge de maintenance sur plusieurs applications.

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 de projet Maven.

Bibliothèques requises et versions

  • GroupDocs.Search for Java 25.4 ou supérieur.

Configuration de l’environnement

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

Prérequis de connaissances

  • Programmation orientée objet en Java.
  • Opérations de base d’E/S de fichiers.

Configuration de GroupDocs.Search pour Java

Informations d’installation

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

Acquisition de licence

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

Initialisation et configuration de base

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

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

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

La classe Index représente une collection de documents consultables stockés sur disque ou en mémoire.

// 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

SynonymDictionary gère les groupes de synonymes et fournit des méthodes pour interroger les synonymes d’un terme.

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

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

SynonymDictionary.getGroups() renvoie une liste de tous les groupes de synonymes définis avec leurs identifiants.

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

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

add(word, synonym) insère une nouvelle relation de synonymie dans le dictionnaire. clear() supprime toutes les entrées, et remove(word) supprime un terme spécifique du dictionnaire.

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

exportDictionary(path) écrit le dictionnaire de synonymes actuel dans un fichier binaire .dat à l’emplacement spécifié.

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

Fonctionnalité 6 : importation des synonymes depuis un fichier

importDictionary(path) charge un fichier .dat précédemment exporté dans le dictionnaire de synonymes.

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

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

SearchOptions configure le comportement de la requête, y compris si l’expansion des synonymes est activée. setUseSynonymSearch(true) active la recherche sensible aux synonymes pour la requête à venir.

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

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

Comment rechercher avec des synonymes

Chargez votre Index, activez la recherche de synonymes et exécutez une requête. Le moteur étend automatiquement la requête en utilisant le dictionnaire de synonymes que vous avez créé ou importé, retournant des correspondances pour tous les termes associés.

Comment importer le dictionnaire de synonymes

Si vous disposez déjà d’un fichier .dat préparé par 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. L’ajout, la suppression ou la récupération de groupes se fait via l’API SynonymDictionary, comme illustré dans les extraits de code ci‑dessus.

Comment optimiser l’index de recherche

  • Supprimez régulièrement les entrées inutilisées : Utilisez clear() avant les mises à jour en masse.
  • Ajustez le tas JVM : Les gros dictionnaires peuvent nécessiter plus de mémoire ; augmentez le paramètre -Xmx en conséquence.
  • Maintenez la bibliothèque à jour : Les nouvelles versions contiennent des améliorations de performances et des corrections de bugs.

Applications pratiques

  1. Systèmes de gestion de contenu (CMS) : Les utilisateurs trouvent les articles même lorsqu’ils utilisent une terminologie alternative.
  2. Plateformes e‑commerce : Les recherches de produits deviennent tolérantes aux synonymes comme « laptop » vs. « notebook ».
  3. Référentiels de documents : Les archives juridiques ou médicales bénéficient de groupes de synonymes spécifiques au domaine, améliorant la découvrabilité pour les professionnels.

Considérations de performance

  • Optimisez le stockage de l’index : Reconstruisez périodiquement l’index pour supprimer les données obsolètes.
  • Gérez l’utilisation de la mémoire : Surveillez la consommation du tas lors du chargement de gros fichiers de synonymes ; un dictionnaire de 500 Mo nécessite généralement un tas de 2 Go sur une JVM 64 bits.
  • Mises à jour régulières : Restez sur la dernière version de GroupDocs.Search pour les corrections de bugs et les gains de vitesse.

Problèmes courants et solutions

ProblèmeCause probableSolution
Aucun résultat de synonymes n’apparaîtsetUseSynonymSearch(true) non configuré ou dictionnaire non importéVérifiez que l’option est activée et que le fichier du dictionnaire existe.
Erreurs de mémoire insuffisante lors de l’importationFichier .dat très volumineux dépasse le tas JVMAugmentez la taille du tas -Xmx ou importez par lots plus petits.
Entrées dupliquées dans les résultatsLe même terme apparaît dans plusieurs groupes de synonymesConsolidez les groupes qui se chevauchent en utilisant clear() puis addRange().

Questions fréquemment posées

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 actualiser mon dictionnaire de synonymes ?
R : Mettez‑le à jour dès qu’une nouvelle terminologie apparaît — utilisez clear() suivi de addRange() pour un rafraîchissement propre.

Q : Puis‑je exécuter 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 de synonymes attendues—que dois‑je 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 : 2026-10-17
Testé avec : GroupDocs.Search 25.4 for Java
Auteur : GroupDocs

Tutoriels associés