Come abilitare la ricerca fuzzy in Java con GroupDocs.Search – Tutorial introduttivo

In questa guida completa imparerai come abilitare la ricerca fuzzy in Java usando la libreria GroupDocs.Search. Ti guideremo attraverso l’installazione dell’SDK, l’applicazione di una licenza, la configurazione del fuzzy matching e l’indicizzazione di vari tipi di documenti affinché i tuoi utenti possano trovare contenuti pertinenti anche quando commettono errori di ortografia o usano terminologia alternativa. Alla fine del tutorial avrai una soluzione di ricerca completamente funzionale pronta in meno di 15 minuti.

Risposte rapide

  • Qual è il primo passo? Aggiungi la dipendenza GroupDocs.Search al tuo pom.xml Maven o al build.gradle Gradle.
  • Ho bisogno di una licenza? Sì—una licenza di sviluppo temporanea funziona per i test; è necessaria una licenza permanente per le distribuzioni in produzione.
  • Quale IDE è il migliore? Qualsiasi IDE Java che supporti Maven o Gradle (IntelliJ IDEA, Eclipse, VS Code).
  • Posso indicizzare PDF, Word e file Excel? Assolutamente—GroupDocs.Search supporta nativamente oltre 50 formati di file, inclusi PDF, DOCX, XLSX, PPTX e molti tipi di immagine.
  • Come abilito la ricerca fuzzy? Imposta la proprietà fuzzySearch su true in un’istanza di SearchOptions prima di eseguire una query.
  • Quanto tempo richiede l’intera configurazione? Tipicamente meno di 15 minuti per un progetto nuovo.

Cos’è “abilitare la ricerca fuzzy” in GroupDocs.Search?

Abilitare la ricerca fuzzy indica al motore di tollerare piccole variazioni ortografiche, caratteri mancanti o lettere trasposte durante il confronto dei termini di ricerca. Questa funzionalità migliora notevolmente la reperibilità in scenari come errori di digitazione degli utenti, testo generato da OCR o contenuti multilingue, poiché l’algoritmo di ricerca restituirà documenti pertinenti anche quando la parola chiave esatta non è presente.

Perché configurare GroupDocs.Search per Java e abilitare la ricerca fuzzy?

Ottieni immediatamente capacità di ricerca pronte per la produzione con un codice minimo, offrendo al contempo un’esperienza utente più fluida. GroupDocs.Search indicizza i documenti senza caricarli completamente in memoria, supporta oltre 50 formati di input e output e può scalare a milioni di file su hardware di consumo. Abilitare la ricerca fuzzy aggiunge uno strato di tolleranza che riduce le query fallite fino all’80 %, trasformando input utente errati in risultati accurati senza sforzi di sviluppo aggiuntivi.

Prerequisiti

  • Java Development Kit (JDK) 8 o versioni successive.
  • Maven 3 o Gradle 5 per la gestione delle dipendenze.
  • Una chiave di licenza GroupDocs.Search temporanea o permanente.

Guida passo‑passo

Passo 1: aggiungi GroupDocs.Search al tuo progetto

Aggiungi la dipendenza GroupDocs.Search al tuo pom.xml (Maven) o al build.gradle (Gradle). Questo rende la libreria disponibile nel classpath per la compilazione e l’esecuzione.

Passo 2: applica la tua licenza

License carica e valida il file di licenza GroupDocs.Search, sbloccando tutte le funzionalità premium come il fuzzy matching. Crea un’istanza License e puntala al file .lic ricevuto da GroupDocs.

Passo 3: inizializza le impostazioni dell’indice

Definisci una cartella su disco dove verranno memorizzati i file dell’indice. Puoi anche configurare la sensibilità al maiuscolo/minuscolo, le parole stop e altre opzioni di indicizzazione in questa fase.

Passo 4: indicizza i tuoi documenti

La classe Indexer legge i file, estrae il testo ricercabile e scrive i dati nella cartella dell’indice. Rileva automaticamente il tipo di file, così puoi fornire un mix di PDF, DOCX, XLSX e immagini senza codice aggiuntivo.

Passo 5: abilita la ricerca fuzzy nella tua query

SearchOptions configura i parametri per un’operazione di ricerca, come il fuzzy matching e i filtri.
Quando crei un oggetto SearchOptions, imposta il suo flag fuzzySearch su true. Puoi anche regolare fuzzinessLevel (ad esempio, 2) per controllare quanto il motore debba essere tollerante.

Passo 6: esegui una query di ricerca

Il metodo search esegue la query sull’indice e restituisce i risultati corrispondenti.
Chiama il metodo search con la stringa di query e le SearchOptions configurate. Il metodo restituisce un elenco di oggetti SearchResult, ognuno contenente il percorso del documento e un punteggio di rilevanza che riflette le corrispondenze fuzzy. SearchResult rappresenta una singola corrispondenza di documento, includendo il suo percorso e il punteggio di rilevanza.

Passo 7: revisiona i risultati

SearchResult rappresenta una singola corrispondenza di documento, includendo il suo percorso e il punteggio di rilevanza.
Itera sulla collezione SearchResult, visualizza i nomi dei file e, facoltativamente, evidenzia i termini corrispondenti nella tua interfaccia. Le corrispondenze fuzzy hanno tipicamente un punteggio di rilevanza leggermente inferiore rispetto alle corrispondenze esatte, che puoi usare per ordinare i risultati.

Problemi comuni e soluzioni

  • Licenza non riconosciuta – Verifica che il percorso del file di licenza sia corretto e che il file corrisponda alla versione di GroupDocs.Search in uso.
  • Formati di documento mancanti – Installa l’add‑on opzionale groupdocs-conversion per ottenere il supporto a tipi di file meno comuni.
  • La ricerca fuzzy non restituisce risultati – Assicurati che il flag fuzzySearch sia true e che la lunghezza della query soddisfi il requisito minimo di caratteri (di solito tre caratteri).
  • Colli di bottiglia delle prestazioni – Usa l’indicizzazione incrementale e memorizza la cartella dell’indice su un SSD per migliorare la velocità di lettura/scrittura.

Domande frequenti

Q: Posso eseguire GroupDocs.Search su un server Linux?
A: Sì, la libreria è indipendente dalla piattaforma e funziona su qualsiasi sistema operativo che supporti Java.

Q: Come aggiungo nuovi file a un indice esistente?
A: Richiama nuovamente Indexer con i nuovi file; l’SDK li unisce all’indice corrente automaticamente.

Q: È possibile limitare i risultati della ricerca a una cartella specifica?
A: Sì, imposta un filtro di cartella in SearchOptions prima di eseguire la query.

Q: Cosa succede quando scade la licenza temporanea?
A: L’API passa alla modalità di valutazione con funzionalità limitate; sostituisci la chiave temporanea con una licenza permanente per riottenere la piena funzionalità.

Q: GroupDocs.Search supporta la ricerca fuzzy?
A: Assolutamente—abilita il flag fuzzySearch in SearchOptions per recuperare risultati che contengono piccole variazioni ortografiche.

Q: Posso combinare la ricerca fuzzy con altri filtri come intervalli di date?
A: Sì, puoi aggiungere filtri aggiuntivi a SearchOptions mantenendo attivo il fuzzy matching.

Risorse aggiuntive

Tutorial disponibili

Distribuire GroupDocs.Search per Java: Guida completa di configurazione

Impara come distribuire e configurare GroupDocs.Search per Java con questa guida passo‑passo. Migliora l’indicizzazione dei documenti e le capacità di ricerca nei tuoi progetti.


Ultimo aggiornamento: 2026-10-17
Testato con: GroupDocs.Search 23.12 per Java
Autore: GroupDocs

Tutorial correlati