Implementa GroupDocs.Search Java per la ricerca di documenti

Nell’ambiente odierno guidato dai dati, implement groupdocs search java è essenziale per qualsiasi applicazione che necessiti di una ricerca full‑text veloce e affidabile su PDF, file Word, fogli di calcolo e altro. Che tu stia costruendo un repository di contratti legali, un portale di ricerca accademica o una base di conoscenza per il supporto clienti, questo tutorial ti guida attraverso l’installazione dell’SDK, la creazione di un indice, l’esecuzione di query fuzzy e la generazione di HTML con termini di ricerca evidenziati — tutto con Java.

Risposte rapide

  • Quale libreria aiuta a implementare groupdocs search java? GroupDocs.Search for Java.
  • Posso evidenziare i termini di ricerca java nei risultati? Sì — l’HTML generato può avvolgere automaticamente le corrispondenze con tag <mark>.
  • È necessaria una licenza per la produzione? È disponibile una prova gratuita; è richiesta una licenza completa per l’uso commerciale.
  • Quale IDE funziona meglio? Qualsiasi IDE Java — IntelliJ IDEA, Eclipse o VS Code.
  • Maven è supportato? Assolutamente — aggiungi il repository e la dipendenza al tuo pom.xml.

Cos’è GroupDocs.Search per Java?

GroupDocs.Search è un SDK Java che indicizza e ricerca testo su più di 50+ formati di documento (PDF, DOCX, XLSX, PPTX, TXT, ecc.) senza caricare l’intero file in memoria. Offre corrispondenza fuzzy, operatori Booleani, query di frase e evidenziazione dei risultati integrata, rendendolo una soluzione chiavi in mano per repository di documenti ricercabili.

Perché usare Search Documents Java con GroupDocs.Search?

Fornisce velocità con ricerche indicizzate che restituiscono risultati in meno di 10 ms per 10 k documenti, flessibilità grazie alla ricerca fuzzy, logica Booleana, query di frase e espansione dei sinonimi, evidenziazione generando anteprime HTML che marcano automaticamente le corrispondenze, e scalabilità operando on‑premise, nel cloud o in ambienti ibridi gestendo file di centinaia di pagine senza un consumo eccessivo di memoria.

Prerequisiti

  • Java Development Kit (JDK) 8 o superiore.
  • Maven (o gestione manuale dei JAR).
  • Un IDE come IntelliJ IDEA, Eclipse o VS Code.
  • Familiarità di base con la struttura dei progetti Java e Maven.

Configurazione di GroupDocs.Search per Java

Installazione via Maven

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

Download diretto

Se preferisci non usare Maven, scarica l’ultimo JAR dalla pagina di rilascio ufficiale: GroupDocs.Search for Java releases.

Passaggi per l’acquisizione della licenza

  • Prova gratuita: Inizia con una prova gratuita per esplorare le funzionalità.
  • Licenza temporanea: Ottienila tramite GroupDocs’ official site.
  • Acquisto: Acquista una licenza completa per uso illimitato in produzione.

Inizializzazione e configurazione di base

La classe Index è il componente principale che rappresenta un indice ricercabile memorizzato su disco. Dopo aver creato una cartella per l’indice, istanzi l’oggetto Index per aggiungere, eliminare o interrogare documenti:

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/ObtainSearchResultInformation";
Index index = new Index(indexFolder);

Come cercare documenti Java – Funzione 1: Estrarre le informazioni dei risultati di ricerca

Questa funzionalità spiega come eseguire una query, recuperare i documenti corrispondenti e ottenere dati dettagliati di occorrenza per ogni termine. Seguendo i passaggi puoi creare dashboard analitiche o generare report dettagliati dai risultati della ricerca.

Passo 1: Creare un indice

La classe Index è l’oggetto di livello superiore che memorizza i metadati ricercabili su disco. Creandola si indica una cartella dove risiederanno tutti i file dell’indice:

String indexFolder = YOUR_DOCUMENT_DIRECTORY + "/ObtainSearchResultInformation";
Index index = new Index(indexFolder);
index.add(documentFolder);

Passo 2: Configurare le opzioni di ricerca (Abilitare la ricerca fuzzy)

SearchOptions ti consente di affinare il comportamento della query. Impostare FuzzySearch su true abilita la corrispondenza approssimativa, utile per gestire errori di battitura o errori OCR:

SearchOptions options = new SearchOptions();
options.getFuzzySearch().setEnabled(true);
options.getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(3));

Passo 3: Eseguire la ricerca

Index.search esegue la query sull’indice preparato e restituisce una collezione SearchResult contenente i documenti corrispondenti e le occorrenze dei termini:

String query = "favourable OR \"ipsum dolor\"";
SearchResult result = index.search(query, options);

L’oggetto SearchResult contiene l’elenco dei documenti che corrispondono alla query e i loro punteggi di rilevanza.

Passo 4: Estrarre le occorrenze

Ogni elemento SearchResult fornisce getOccurrences() che restituisce le posizioni esatte dei termini della query all’interno del file sorgente, permettendoti di costruire dashboard analitiche o report dettagliati:

for (int i = 0; i < result.getDocumentCount(); i++) {
    FoundDocument document = result.getFoundDocument(i);
    for (FoundDocumentField field : document.getFoundFields()) {
        if (field.getTerms() != null) {
            for (String term : field.getTerms()) {
                int occurrences = field.getTermsOccurrences()[field.getTerms().indexOf(term)];
                System.out.println("Term: " + term + ", Occurrences: " + occurrences);
            }
        }
        if (field.getTermSequences() != null) {
            for (String[] terms : field.getTermSequences()) {
                int occurrences = field.getTermSequencesOccurrences()[ArrayUtils.indexOf(field.getTermSequences(), terms)];
                StringBuilder sequence = new StringBuilder();
                for (String term : terms) {
                    sequence.append(term).append(" ");
                }
                System.out.println("Phrase: " + sequence.toString() + ", Occurrences: " + occurrences);
            }
        }
    }
}

Funzione 2: Evidenziare i termini di ricerca Java nei documenti

Genera un’anteprima HTML dove ogni corrispondenza è avvolta in un tag <mark>, fornendo agli utenti finali indicazioni visive immediate.

Passo 1: Configurare l’indice con alta compressione

L’alta compressione riduce lo spazio di archiviazione fino al 70 % mantenendo la velocità di query entro millisecondi. Regola la proprietà CompressionLevel prima dell’indicizzazione:

String indexFolder = YOUR_DOCUMENT_DIRECTORY + "/HighlightSearchResults";
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));
Index index = new Index(indexFolder, settings);
index.add(documentFolder);

Passo 2: Eseguire la ricerca e evidenziare i risultati

Dopo aver eseguito la ricerca, chiama highlight() sull’oggetto SearchResult per produrre un file HTML che evidenzia ogni occorrenza del termine di ricerca. Il metodo highlight() genera un’anteprima HTML con i termini corrispondenti avvolti in tag <mark>:

SearchResult result = index.search("solicitude");
if (result.getDocumentCount() > 0) {
    FoundDocument document = result.getFoundDocument(0);
    String path = YOUR_OUTPUT_DIRECTORY + "/Highlighted.html";
    OutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, path);
    Highlighter highlighter = new DocumentHighlighter(outputAdapter);
    index.highlight(document, highlighter);
}

Applicazioni pratiche

  1. Revisione di documenti legali – Individua clausole specifiche tra migliaia di contratti in pochi secondi.
  2. Ricerca accademica – Estrai frasi chiave da articoli di ricerca per revisioni della letteratura.
  3. Supporto clienti – Identifica problemi ricorrenti negli archivi email per migliorare le pagine FAQ.
  4. Gestione dei contenuti – Evidenzia parole chiave SEO in articoli e blog per rapidi controlli editoriali.

Considerazioni sulle prestazioni

  • Compressione: L’alta compressione riduce lo spazio di archiviazione ma può aumentare l’uso della CPU; esegui benchmark con il tuo carico di lavoro tipico.
  • Gestione della memoria: Indicizza i documenti in batch di 500 – 1 000 file per mantenere l’heap JVM sotto controllo.
  • Aggiornamento dell’indice: Re‑indicizza i file modificati ogni notte per garantire che i risultati della ricerca siano aggiornati.

Conclusione

Questa guida ha dimostrato come implementare groupdocs search java, estrarre informazioni dettagliate sui risultati e evidenziare i termini di ricerca java nelle anteprime HTML. Seguendo questi passaggi puoi offrire esperienze di ricerca rapide e user‑friendly per qualsiasi repository di documenti.

Prossimi passi

  • Integra l’HTML evidenziato nella tua interfaccia web usando un <iframe> o rendering lato server.
  • Sperimenta con SearchOptions aggiuntivi come SynonymSearch o WildcardSearch.
  • Approfondisci la documentazione API di GroupDocs.Search per punteggi personalizzati, paginazione dei risultati e supporto multilingua.

Domande frequenti

Q: Cos’è GroupDocs.Search?
A: GroupDocs.Search è un SDK Java che indicizza e ricerca testo su più di 50 formati di documento, offrendo corrispondenza fuzzy e evidenziazione dei risultati.

Q: Come funziona la ricerca fuzzy?
A: Tolerà un numero configurabile di differenze di caratteri, consentendo corrispondenze su parole errate o errori OCR.

Q: Posso usare GroupDocs.Search senza licenza?
A: Sì, è disponibile una prova gratuita, ma è necessaria una licenza completa per le distribuzioni in produzione.

Q: Quali formati di file sono supportati?
A: PDF, DOCX, XLSX, PPTX, TXT e molti altri — consulta la documentazione ufficiale per l’elenco completo.

Q: Come visualizzare i risultati evidenziati in un’applicazione web?
A: Servi direttamente il file HTML generato o incorpora il suo contenuto in una pagina usando un <iframe> o rendering lato server.

Last Updated: 2026-07-26
Tested With: GroupDocs.Search 25.4
Author: GroupDocs

Tutorial correlati