Mettre en évidence le texte Java avec GroupDocs.Search

Dans l’environnement numérique actuel, rapide, pouvoir highlight text java à travers de grandes collections de fichiers est une fonctionnalité indispensable. Que vous construisiez une plateforme d’examen juridique, un moteur de recherche académique ou une console de support client, repérer instantanément les termes recherchés par les utilisateurs rend l’expérience beaucoup plus efficace. Ce tutoriel vous guide dans l’utilisation de GroupDocs.Search for Java pour search documents java, index documents java, et appliquer un surlignage riche — à la fois pour les documents entiers et pour des fragments ciblés.

Réponses rapides

  • What does “search and highlight text” mean? Cela fait référence à la localisation des termes de requête dans un document et à leur mise en évidence visuelle (par exemple, avec une couleur d’arrière‑plan).
  • Which library provides this capability? GroupDocs.Search for Java.
  • Do I need a license? Un essai gratuit suffit pour l’évaluation ; une licence complète est requise pour la production.
  • Can I customize highlight colors? Oui — n’importe quelle couleur RGB peut être définie via HighlightOptions.
  • Is fragment highlighting supported? Absolument ; vous pouvez définir les termes avant/après la correspondance pour créer des extraits concis.

Comment mettre en évidence le texte Java dans les documents

Le surlignage du texte Java implique trois étapes principales :

  1. Index the source files afin qu’ils puissent être recherchés rapidement.
  2. Run a query contre l’index pour trouver les documents correspondants.
  3. Render the results with visual cues en utilisant l’API de surlignage.

Ci‑dessus, nous explorons chaque étape en détail, d’abord pour la sortie de document complet puis pour les extraits au niveau des fragments.

Qu’est‑ce que la recherche et le surlignage de texte ?

La recherche et le surlignage de texte est le processus de scan d’un index de documents pour une requête donnée, de récupération des documents correspondants, puis de marquage de chaque occurrence du terme de requête dans la sortie du document (HTML, PDF, etc.). Cette indication visuelle aide les utilisateurs finaux à repérer instantanément les informations pertinentes.

Pourquoi utiliser GroupDocs.Search pour Java ?

  • High‑performance indexing avec compression configurable (index documents java).
  • Rich highlighting API qui fonctionne sur des documents complets et sur des fragments personnalisés (highlight search terms java).
  • Cross‑format support (DOCX, PDF, PPTX, TXT, et plus).
  • Simple Maven integration et un design centré sur Java propre.

Prérequis

  • Java Development Kit (JDK) 8 ou plus récent.
  • Maven pour la gestion des dépendances.
  • Un IDE tel qu’IntelliJ IDEA ou Eclipse.
  • Une connaissance de base de la syntaxe Java.

Configuration de GroupDocs.Search pour Java

Ajoutez le dépôt GroupDocs 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>

Vous pouvez également télécharger le dernier JAR directement depuis le site officiel : GroupDocs.Search for Java releases.

Acquisition de licence

Commencez avec un essai gratuit ou obtenez une licence temporaire pour l’évaluation. Pour les déploiements en production, achetez une licence complète afin de débloquer toutes les fonctionnalités.

Guide d’implémentation

L’implémentation est divisée en deux sections pratiques : highlighting in entire documents et highlighting in fragments. Les deux sections incluent les étapes essentielles pour how to highlight Java documents en utilisant GroupDocs.Search.

Configuration des paramètres d’index

Avant l’indexation, configurez le stockage pour utiliser une haute compression — cela réduit l’utilisation du disque tout en préservant la vitesse de recherche.

IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));

Surlignage dans les documents entiers

Étape 1 : Créer et remplir l’index

Créez un dossier d’index et ajoutez tous les fichiers sources que vous souhaitez rechercher.

String indexFolder = "/path/to/your/document/directory/HighlightingInEntireDocument";
Index index = new Index(indexFolder, settings);
index.add("/path/to/your/documents");

Étape 2 : Effectuer la recherche et appliquer le surlignage

Recherchez le terme (par ex., ipsum) et générez un fichier HTML avec les correspondances surlignées.

SearchResult result = index.search("ipsum");

if (result.getDocumentCount() > 0) {
    FoundDocument document = result.getFoundDocument(0);
    OutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, "/path/to/your/output/directory/Highlighted.html");
    
    Highlighter highlighter = new DocumentHighlighter(outputAdapter);
    HighlightOptions options = new HighlightOptions();
    options.setHighlightColor(new Color(150, 255, 150)); // Custom green shade
    options.setUseInlineStyles(false); // Prefer CSS for styling
    
    index.highlight(document, highlighter, options);
}

Options clés expliquées

  • Compression – la haute compression économise le stockage.
  • HighlightColor – définissez n’importe quelle valeur RGB pour correspondre à votre palette UI.
  • UseInlineStyles – false génère un HTML propre qui peut être stylisé globalement avec du CSS.

Surlignage dans les fragments

Étape 1 : Indexer et rechercher (identique ci‑dessus)

String indexFolder = "/path/to/your/document/directory/HighlightingInFragments";
Index index = new Index(indexFolder, settings);
index.add("/path/to/your/documents");

SearchResult result = index.search("ipsum");

Étape 2 : Définir le contexte du fragment et le surlignage

Spécifiez combien de termes avant et après la correspondance doivent apparaître dans chaque fragment.

HighlightOptions options = new HighlightOptions();
options.setTermsBefore(5); // Include 5 terms before the match
options.setTermsAfter(5);   // Include 5 terms after the match
options.setHighlightColor(new Color(127, 200, 255)); // Custom blue shade
options.setUseInlineStyles(true); // Use inline styles for emphasis

FoundDocument document = result.getFoundDocument(0);
FragmentHighlighter highlighter = new FragmentHighlighter(OutputFormat.Html);

index.highlight(document, highlighter, options);

Étape 3 : Récupérer et écrire les fragments surlignés

Collectez les fragments générés et écrivez‑les dans un fichier HTML.

StringBuilder stringBuilder = new StringBuilder();
FragmentContainer[] fragmentContainers = highlighter.getResult();

for (FragmentContainer container : fragmentContainers) {
    String[] fragments = container.getFragments();
    
    if (fragments.length > 0) {
        stringBuilder.append("\n<br>").append(container.getFieldName()).append("<br>\n");
        
        for (String fragment : fragments) {
            stringBuilder.append(fragment).append("\n");
        }
    }
}

try {
    Files.write(Paths.get("/path/to/your/output/directory/Fragments.html"), stringBuilder.toString().getBytes());
} catch (IOException ex) {
    // Handle exceptions
}

Applications pratiques

  1. Legal Document Review – surlignez instantanément les lois, clauses ou références de cas.
  2. Academic Research – mettez en avant la terminologie clé à travers des dizaines de PDF et de fichiers Word.
  3. Customer Support – identifiez les numéros de commande ou les codes d’erreur dans les historiques de tickets.

Considérations de performance

  • Index Size – la haute compression (Compression.High) réduit l’empreinte disque.
  • Fragment Context – des valeurs plus grandes de termsBefore/After augmentent la précision mais peuvent affecter la vitesse.
  • Memory Management – surveillez le tas JVM lors de l’indexation de grands corpus ; envisagez une indexation incrémentale pour des ensembles très volumineux.

Problèmes courants et solutions

  • Indexing Errors – vérifiez les chemins de fichiers et assurez‑vous que l’application dispose des permissions de lecture/écriture.
  • No Highlights Appear – confirmez que UseInlineStyles correspond à votre format de sortie (HTML vs. PDF).
  • Color Not Applied – assurez‑vous que les valeurs RGB sont comprises entre 0‑255 et que le visualiseur HTML prend en charge le style.

Questions fréquemment posées

Q: Quels sont les avantages d’utiliser GroupDocs.Search pour Java ?
A: Il offre un indexage rapide et évolutif, un surlignage personnalisable, et la prise en charge de nombreux formats de documents.

Q: Comment intégrer GroupDocs.Search avec une API REST ?
A: Exposez les méthodes de recherche et de surlignage via des contrôleurs Spring Boot, en renvoyant des charges utiles HTML ou JSON.

Q: La bibliothèque gère‑t‑elle les fichiers protégés par mot de passe ?
A: Oui — fournissez le mot de passe lors de l’ajout du document à l’index.

Q: Puis‑je personnaliser le balisage du surlignage au‑delà de la couleur ?
A: Absolument ; vous pouvez injecter des classes CSS via HighlightOptions ou modifier le HTML après génération.

Q: Quelle version a été testée pour ce guide ?
A: Le code a été validé avec GroupDocs.Search 25.4.

Q: Comment définir les highlight options java pour utiliser une classe CSS au lieu de styles en ligne ?
A: Définissez options.setUseInlineStyles(false) et ajoutez une règle CSS pour la classe que vous assignez via options.setCssClass("myHighlight").

Q: Existe‑t‑il un moyen de highlight terms pdf java directement lorsque la source est un PDF ?
A: Oui — GroupDocs.Search fonctionne avec des entrées PDF, et le surligneur générera du HTML que vous pouvez intégrer dans un visualiseur PDF ou reconvertir en PDF à l’aide de GroupDocs.Conversion.

Dernière mise à jour : 2026-02-27
Testé avec : GroupDocs.Search 25.4
Auteur : GroupDocs