Comment mettre en évidence les résultats de recherche en Java avec GroupDocs.Search

Si vous devez mettre en évidence les résultats de recherche en Java pour vos applications, vous êtes au bon endroit. Ce guide vous accompagne dans le processus de mise en évidence visuelle des termes correspondants à l’intérieur des documents originaux et des aperçus HTML à l’aide de GroupDocs.Search for Java. Que vous construisiez un portail de recherche de documents, une base de connaissances d’entreprise ou un simple explorateur de fichiers, les techniques présentées ici vous aideront à offrir une expérience utilisateur plus claire et plus intuitive.

Réponses rapides

  • Que fait “highlight search results java” ?
    Il marque visuellement chaque occurrence d’un terme de requête dans un document ou un aperçu, rendant les correspondances faciles à repérer.
  • Quels types de fichiers sont pris en charge ?
    Word, PDF, Excel, PowerPoint, plain text, and many more via GroupDocs.Search.
  • Ai-je besoin d’une licence ?
    A temporary license works for development; a full license is required for production use.
  • Puis-je personnaliser le style de mise en évidence ?
    Yes—colors, fonts, and opacity can be set programmatically.
  • Une configuration supplémentaire est‑elle requise ?
    Just add the GroupDocs.Search for Java library to your project and reference the API.

Qu’est-ce que la mise en évidence des résultats de recherche en Java ?

La mise en évidence des résultats de recherche en Java est la technique qui consiste à appliquer programmaticalement des marqueurs visuels (généralement des couleurs d’arrière‑plan) à chaque occurrence d’un terme de recherche trouvé par GroupDocs.Search dans un document. Cela permet aux utilisateurs finaux de localiser facilement les informations pertinentes sans parcourir manuellement le fichier entier.

Pourquoi utiliser la mise en évidence avec GroupDocs.Search for Java ?

GroupDocs.Search prend en charge la mise en évidence dans plus de 30 formats de fichiers, y compris DOCX, PDF, XLSX, PPTX, TXT, HTML, et plus encore. Il peut indexer jusqu’à 10 millions de documents tout en maintenant une latence de requête inférieure à une seconde sur du matériel serveur standard. L’API vous permet de personnaliser les couleurs, l’opacité, et même d’appliquer différents styles par terme, afin que vous puissiez correspondre parfaitement aux directives UI de votre marque.

Prérequis

  • Java 8 ou version supérieure installé.
  • Bibliothèque GroupDocs.Search for Java ajoutée à votre projet (dépendance Maven/Gradle).
  • Un fichier de licence temporaire ou complet GroupDocs.Search.

Guide étape par étape

Étape 1 : initialiser le moteur de recherche

SearchEngine est la classe principale qui indexe et interroge votre collection de documents. Créez une instance de SearchEngine et chargez l’index contenant les documents que vous souhaitez rechercher.

Note : Le code pour cette étape est fourni dans le guide complet lié ci‑dessous.

Étape 2 : exécuter une requête de recherche

SearchResult représente un document unique contenant des correspondances pour la requête de l’utilisateur. Appelez la méthode search avec la chaîne de requête ; elle renvoie une collection d’objets SearchResult.

Étape 3 : mettre en évidence les correspondances dans le document original

HighlightOptions vous permet de spécifier le style visuel — couleur, opacité, et si vous devez mettre en évidence le fragment entier ou seulement le terme exact. Pour chaque SearchResult, appelez l’API de mise en évidence pour intégrer les marqueurs visuels directement dans le fichier source.

Étape 4 : générer un aperçu HTML (optionnel)

Si vous préférez afficher un aperçu web plutôt que le fichier original, utilisez la classe HighlightResult pour produire un extrait HTML avec les termes mis en évidence. Cela est utile pour les visionneuses basées sur le navigateur ou les applications mobiles légères.

Étape 5 : enregistrer ou diffuser la sortie mise en évidence

Après la mise en évidence, vous pouvez soit écraser le document original, enregistrer une nouvelle copie mise en évidence, ou diffuser le résultat directement vers le navigateur du client.

Comment mettre en évidence les termes dans un PDF

Chargez votre PDF avec le SearchEngine et appliquez HighlightOptions utilisant une couleur jaune vif avec 30 % d’opacité—cette combinaison est prouvée comme étant clairement visible sur les arrière‑plans PDF typiques tout en conservant la mise en page originale. L’API calcule automatiquement les coordonnées correctes pour chaque correspondance, préservant le flux de texte et les images. Après la mise en évidence, vous pouvez enregistrer le PDF modifié sur le disque ou le diffuser directement vers le client. Cette approche fonctionne pour les PDF à page unique et multi‑pages sans modifier la structure du fichier original.

Mettre en évidence les correspondances dans les documents Word

HighlightResult fonctionne avec les fichiers Word de la même manière, mais vous devez choisir un HighlightColor qui respecte le style natif de Word (par ex., un teal clair qui n’est pas supprimé lorsque le document est ouvert dans Microsoft Word). Cela garantit que la mise en évidence persiste à travers différentes versions de Word.

Problèmes courants et solutions

  • Aucun surlignement n’apparaît : Assurez‑vous que le format du document est pris en charge et que la requête de recherche correspond réellement au contenu du fichier.
  • Ralentissement des performances sur les gros fichiers : Activez l’indexation asynchrone ou traitez les documents par lots.
  • Couleurs incorrectes : Vérifiez que vous utilisez les bonnes valeurs d’énumération HighlightColor et que le style n’est pas écrasé par du CSS dans votre UI.

Tutoriels disponibles

GroupDocs.Search for Java: Mettre en évidence les termes de recherche dans les documents | Guide complet

Apprenez à utiliser GroupDocs.Search for Java pour mettre en évidence les termes de recherche dans les documents. Découvrez les techniques de mise en évidence sur l’ensemble des documents et des fragments spécifiques.

Ressources supplémentaires

Questions fréquentes

Q : Puis‑je mettre en évidence les résultats de recherche dans les PDF protégés par mot de passe ?
R : Oui. Fournissez le mot de passe lors du chargement du document, puis appliquez les mêmes méthodes de mise en évidence.

Q : La mise en évidence modifie‑t‑elle le fichier original de façon permanente ?
R : Par défaut, elle crée une nouvelle copie, mais vous pouvez choisir d’écraser la source si vous le souhaitez.

Q : Est‑il possible de mettre en évidence plusieurs termes de requête à la fois ?
R : Absolument. Passez une liste de termes au moteur de recherche ; chaque terme sera mis en évidence en utilisant le style configuré.

Q : Comment changer la couleur de mise en évidence pour différents termes ?
R : Utilisez la classe HighlightOptions pour attribuer des valeurs HighlightColor distinctes par terme avant d’appeler la méthode de mise en évidence.

Q : Que faire si un document contient des millions de pages ?
R : Traitez le document par morceaux et utilisez les API de streaming pour éviter de charger le fichier complet en mémoire.

Dernière mise à jour : 2026-09-27
Testé avec : GroupDocs.Search for Java 23.11
Auteur : GroupDocs

Tutoriels associés