Come aggiungere documenti all’indice con GroupDocs.Search per Java

Cercare attraverso grandi collezioni di documenti può essere impegnativo, ma GroupDocs.Search per Java semplifica l’aggiunta di documenti all’indice e il loro recupero rapido. In questa guida vedrai come configurare la cartella dell’indice, aggiungere documenti all’indice e ottimizzare le prestazioni di ricerca per applicazioni reali.

Risposte rapide

Qual è il primo passo? Installa GroupDocs.Search via Maven o scarica la libreria.
Come aggiungo documenti all’indice? Chiama index.add(yourDocumentsFolder) dopo aver inizializzato l’indice.
Quale cartella dovrebbe contenere l’indice? Usa una cartella dedicata come output e configurala con new Index(indexFolder).
Posso migliorare la velocità di ricerca? Sì—mantieni regolarmente l’indice ed esegui l’indicizzazione in un thread in background.
Ho bisogno di una licenza? Una licenza di prova o temporanea è sufficiente per i test; è necessaria una licenza completa per la produzione.

Cos’è “aggiungere documenti all’indice”?

Aggiungere documenti a un indice significa elaborare i file sorgente (PDF, DOCX, TXT, ecc.) e memorizzare token ricercabili in un archivio dati strutturato. Questo consente query full‑text rapide su tutto il contenuto indicizzato.

Perché usare GroupDocs.Search per Java?

Alte prestazioni – le ottimizzazioni integrate mantengono bassa la latenza di ricerca anche con milioni di file.
Integrazione semplice – API semplice per creare indici, aggiungere documenti ed eseguire query.
Architettura scalabile – funziona on‑premises o nel cloud, e può essere personalizzata con funzionalità di sinonimi o ranking.

Prerequisiti

Java Development Kit (JDK) 8 o superiore.
IDE come IntelliJ IDEA o Eclipse.
Maven per la gestione delle dipendenze.
Familiarità di base con la programmazione Java.

Configurazione di GroupDocs.Search per Java

Installazione con Maven

Aggiungi quanto segue al tuo file 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

In alternativa, scarica l’ultima versione direttamente da GroupDocs.Search for Java releases.

Acquisizione della licenza

Prova gratuita – esplora tutte le funzionalità senza impegno.
Licenza temporanea – estendi i test oltre il periodo di prova.
Acquisto – ottieni una licenza completa per l’uso in produzione.

Inizializzazione di base

import com.groupdocs.search.Index;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        // Create an index in the specified folder
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output";
        Index index = new Index(indexFolder);
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

Come aggiungere documenti all’indice

Passo 1: Configura la cartella dell’indice e la cartella sorgente

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SynonymSearch";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with your actual document path

Spiegazione: indexFolder è dove verrà memorizzato l’indice ricercabile, mentre documentsFolder punta ai file che desideri aggiungere all’indice.

Passo 2: Crea l’indice (configura la cartella dell’indice)

Index index = new Index(indexFolder);

Spiegazione: Questa riga crea una nuova istanza di indice che scrive i dati nella cartella configurata.

Passo 3: Aggiungi documenti per l’indicizzazione

index.add(documentsFolder);

Spiegazione: Il metodo add scansiona documentsFolder e aggiunge documenti all’indice, rendendo il loro contenuto ricercabile.

Suggerimenti per la risoluzione dei problemi

Dipendenze mancanti – verifica nuovamente le voci Maven in pom.xml.
Percorso cartella non valido – assicurati che sia indexFolder sia documentsFolder esistano e siano accessibili dalla JVM.

Applicazioni pratiche

Gestione documentale aziendale – recupera rapidamente contratti, politiche o file HR.
Ricerca legale – individua fascicoli e precedenti con latenza minima.
Biblioteche accademiche – consenti agli studiosi di cercare tra migliaia di articoli di ricerca.

Considerazioni sulle prestazioni

Ottimizza le prestazioni di ricerca ricostruendo o unendo regolarmente i segmenti dell’indice.
Gestione delle risorse – monitora l’uso dell’heap; aumenta la memoria JVM se indicizzi grandi collezioni.
Best practice – esegui l’indicizzazione in un thread separato per mantenere reattiva l’applicazione principale.

Problemi comuni e soluzioni

Problema	Soluzione
Errori out‑of‑memory durante l’indicizzazione di massa	Dividi la cartella sorgente in batch più piccoli e indicizza ogni batch separatamente.
La ricerca restituisce risultati obsoleti	Riapri l’oggetto `Index` dopo aggiornamenti importanti o chiama `index.update()` se disponibile.
Licenza non riconosciuta	Verifica che il percorso del file di licenza sia corretto e che la versione della licenza corrisponda alla versione della libreria.

Domande frequenti

D: Qual è la versione minima di Java richiesta?
R: Java 8 o superiore è consigliato per la piena compatibilità.

D: Come posso gestire set di documenti molto grandi in modo efficiente?
R: Usa l’elaborazione a batch, esegui l’indicizzazione in thread in background e regola le impostazioni di memoria JVM.

D: GroupDocs.Search può essere distribuito in un ambiente cloud?
R: Sì, ma assicurati che la posizione di archiviazione della cartella dell’indice sia accessibile a tutte le istanze.

D: Quali vantaggi offre la ricerca con sinonimi?
R: Espande i termini di ricerca con parole correlate, migliorando il recall senza sacrificare la precisione.

D: Dove posso trovare documentazione più avanzata?
R: Visita il riferimento API ufficiale su GroupDocs.Search API Reference.

Risorse

Documentazione: GroupDocs Search for Java
Riferimento API: GroupDocs Search API
Download: Latest Releases
GitHub: GroupDocs.Search on GitHub
Supporto gratuito: GroupDocs Forum
Licenza temporanea: Acquire a License

Seguendo questi passaggi ora sai come aggiungere documenti all’indice, configurare la cartella dell’indice e ottimizzare le prestazioni di ricerca con GroupDocs.Search per Java. Buon coding!

Ultimo aggiornamento: 2026-01-03
Testato con: GroupDocs.Search 25.4 per Java
Autore: GroupDocs