Cerca e Evidenzia Testo nei Documenti con GroupDocs.Search per Java

Nell’era digitale odierna, cerca e evidenzia testo all’interno di collezioni massicce di documenti è una necessità comune. Che tu stia costruendo uno strumento di revisione legale, un portale di ricerca accademica o un cruscotto di assistenza clienti, la capacità di individuare e mettere in risalto istantaneamente i termini chiave migliora notevolmente l’usabilità. In questa guida completa scoprirai come implementare cerca e evidenzia testo con GroupDocs.Search per Java—coprendo sia l’evidenziazione dell’intero documento sia l’evidenziazione a livello di frammento per un contesto più mirato.

Risposte Rapide

  • Cosa significa “cerca e evidenzia testo”? Indica la localizzazione dei termini di ricerca in un documento e la loro evidenziazione visiva (ad es. con colore di sfondo).
  • Quale libreria fornisce questa funzionalità? GroupDocs.Search per Java.
  • È necessaria una licenza? Una prova gratuita è sufficiente per la valutazione; è richiesta una licenza completa per la produzione.
  • Posso personalizzare i colori di evidenziazione? Sì—è possibile impostare qualsiasi colore RGB tramite HighlightOptions.
  • È supportata l’evidenziazione di frammenti? Assolutamente; puoi definire termini prima/dopo la corrispondenza per creare snippet concisi.

Che Cos’è la Ricerca e Evidenziazione di Testo?

La ricerca e evidenziazione di testo è il processo di scansione di un indice di documenti per una query data, il recupero dei documenti corrispondenti e la marcatura di ogni occorrenza del termine di ricerca nell’output del documento (HTML, PDF, ecc.). Questo indizio visivo aiuta gli utenti finali a individuare immediatamente le informazioni rilevanti.

Perché Usare GroupDocs.Search per Java?

  • Indicizzazione ad alte prestazioni con compressione configurabile.
  • API di evidenziazione ricca che funziona su documenti interi e su frammenti personalizzati.
  • Supporto multi‑formato (DOCX, PDF, PPTX, TXT e altri).
  • Integrazione Maven semplice e API chiara orientata a Java.

Prerequisiti

  • Java Development Kit (JDK) 8 o versioni successive.
  • Maven per la gestione delle dipendenze.
  • Un IDE come IntelliJ IDEA o Eclipse.
  • Familiarità di base con la sintassi Java.

Configurazione di GroupDocs.Search per Java

Aggiungi il repository GroupDocs e la dipendenza al tuo 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>

Puoi anche scaricare l’ultimo JAR direttamente dal sito ufficiale: GroupDocs.Search per Java releases.

Acquisizione della Licenza

Inizia con una prova gratuita o ottieni una licenza temporanea per la valutazione. Per le distribuzioni in produzione, acquista una licenza completa per sbloccare tutte le funzionalità.

Guida all’Implementazione

L’implementazione è divisa in due sezioni pratiche: evidenziazione in documenti interi e evidenziazione in frammenti. Entrambe le sezioni includono i passaggi essenziali per come evidenziare documenti Java usando GroupDocs.Search.

Configurazione delle Impostazioni dell’Indice

Prima dell’indicizzazione, configura lo storage per utilizzare alta compressione—ciò riduce l’uso del disco mantenendo la velocità di ricerca.

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

Evidenziazione in Documenti Interi

Passo 1: Creare e Popolare l’Indice

Crea una cartella per l’indice e aggiungi tutti i file sorgente che desideri indicizzare.

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

Passo 2: Eseguire la Ricerca e Applicare l’Evidenziazione

Cerca il termine (ad es. ipsum) e genera un file HTML con le corrispondenze evidenziate.

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);
}

Opzioni chiave spiegate

  • Compression – l’alta compressione salva spazio di archiviazione.
  • HighlightColor – imposta qualsiasi valore RGB per abbinare la tua palette UI.
  • UseInlineStyles – false genera HTML pulito che può essere stilizzato globalmente con CSS.

Evidenziazione in Frammenti

Passo 1: Indicizzare e Ricercare (come sopra)

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");

Passo 2: Definire il Contesto del Frammento e Evidenziare

Specifica quanti termini prima e dopo la corrispondenza devono apparire in ciascun frammento.

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);

Passo 3: Recuperare e Scrivere i Frammenti Evidenziati

Raccogli i frammenti generati e scrivili in un file 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
}

Applicazioni Pratiche

  1. Revisione di Documenti Legali – evidenzia istantaneamente statuti, clausole o riferimenti a casi.
  2. Ricerca Accademica – individua la terminologia chiave tra decine di PDF e file Word.
  3. Assistenza Clienti – individua numeri d’ordine o codici di errore all’interno della cronologia dei ticket.

Considerazioni sulle Prestazioni

  • Dimensione dell’Indice – l’alta compressione (Compression.High) riduce l’ingombro su disco.
  • Contesto del Frammento – valori più alti per termsBefore/After aumentano la precisione ma possono influire sulla velocità.
  • Gestione della Memoria – monitora l’heap JVM durante l’indicizzazione di grandi corpora; considera l’indicizzazione incrementale per insiemi molto grandi.

Problemi Comuni e Soluzioni

  • Errori di Indicizzazione – verifica i percorsi dei file e assicurati che l’applicazione abbia i permessi di lettura/scrittura.
  • Nessuna Evidenziazione – conferma che UseInlineStyles corrisponda al formato di output (HTML vs. PDF).
  • Colore Non Applicato – assicurati che i valori RGB siano compresi tra 0‑255 e che il visualizzatore HTML supporti lo stile.

Domande Frequenti

D: Quali sono i vantaggi di usare GroupDocs.Search per Java?
R: Offre indicizzazione veloce e scalabile, evidenziazione personalizzabile e supporto per molti formati di documento.

D: Come posso integrare GroupDocs.Search con un’API REST?
R: Esporre i metodi di ricerca e evidenziazione tramite controller Spring Boot, restituendo payload HTML o JSON.

D: La libreria gestisce file protetti da password?
R: Sì—fornisci la password al momento dell’aggiunta del documento all’indice.

D: Posso personalizzare il markup di evidenziazione oltre al colore?
R: Assolutamente; puoi iniettare classi CSS tramite HighlightOptions o modificare l’HTML dopo la generazione.

D: Quale versione è stata testata per questa guida?
R: Il codice è stato validato con GroupDocs.Search 25.4.

Ultimo Aggiornamento: 2025-12-26
Testato Con: GroupDocs.Search 25.4
Autore: GroupDocs