Disabilitare le parole stop Java – Aggiungere documenti all’indice con GroupDocs

In questo tutorial scoprirai come disable stop words java mentre aggiungi i tuoi file a un indice ricercabile con GroupDocs.Search per Java. Disattivando il filtro integrato delle parole stop, ogni token—incluse parole comuni come “on”, “by” o “the”—diventa ricercabile, migliorando drasticamente la pertinenza dei risultati per domini specializzati come contratti legali, cataloghi e‑commerce o manuali tecnici.

Risposte rapide

What does “add documents to index” mean? Significa caricare i file di origine in un indice ricercabile in modo che possano essere interrogati in modo efficiente.
Why would I disable stop words? Per includere parole comuni (es. “on”, “the”) nelle ricerche quando tali termini sono significativi per il tuo dominio.
Which library version is required? GroupDocs.Search per Java 25.4 o successiva.
Do I need a license? Una prova gratuita è sufficiente per la valutazione; è necessaria una licenza permanente per la produzione.
Can I use this in a Maven project? Sì – basta aggiungere il repository e la dipendenza mostrati di seguito.

Cosa sono le parole stop nella ricerca e perché potresti volerle disabilitare?

Le parole stop sono termini ad alta frequenza che molti motori di ricerca filtrano automaticamente per velocizzare l’elaborazione delle query. Disabilitarle garantisce che ogni parola—incluse quelle tradizionalmente ignorate—contribuisca all’indice di ricerca, il che è essenziale quando queste parole hanno un significato specifico del dominio. Ad esempio, in un contratto legale la parola “by” può distinguere le parti, e in un catalogo di prodotti “on” può far parte del nome di un modello.

Come funziona l’aggiunta di documenti all’indice in GroupDocs.Search?

Quando aggiungi documenti, GroupDocs.Search legge ogni file, tokenizza il contenuto e memorizza i token in un indice invertito ottimizzato. Questa struttura consente il recupero in meno di un secondo anche per collezioni contenenti centinaia di migliaia di file. La libreria supporta anche aggiornamenti incrementali, così puoi mantenere l’indice aggiornato senza ricostruirlo da zero.

Prerequisiti

Required Libraries: GroupDocs.Search per Java 25.4 (o più recente).
Development Environment: IntelliJ IDEA, Eclipse o qualsiasi IDE Java tu preferisca.
Basic Knowledge: Familiarità con la sintassi Java e il concetto di indicizzazione.

Configurazione di GroupDocs.Search per Java

Installazione con Maven

Se utilizzi Maven, includi quanto segue nel 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

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

Passaggi per l’acquisizione della licenza

Free Trial – inizia a testare subito.
Temporary License – ottieni una chiave a tempo limitato per la funzionalità completa.
Purchase – assicurati una licenza permanente per l’uso in produzione.

Inizializzazione e configurazione di base

IndexSettings è una classe di configurazione che definisce come l’indice è costruito, ricercato e quali funzionalità sono abilitate.

Crea un’istanza di IndexSettings per controllare il comportamento dell’indice:

import com.groupdocs.search.IndexSettings;

// Create an instance of IndexSettings
IndexSettings settings = new IndexSettings();

Come disabilitare le parole stop nella ricerca (Java)?

IndexSettings è l’oggetto di configurazione che controlla il comportamento dell’indice di ricerca. Per impostazione predefinita abilita un filtro integrato per le parole stop. Per disattivare questo filtro, chiama il metodo setUseStopWords(false) sull’istanza IndexSettings. Questa singola chiamata disabilita la rimozione delle parole stop, garantendo che ogni token—incluse parole comuni come “on” o “the”—venga indicizzato e possa essere interrogato.

Come aggiungere documenti all’indice

L’aggiunta di documenti all’indice avviene creando un oggetto Index con le IndexSettings desiderate e poi invocando il suo metodo add per ogni file o cartella. La libreria legge ogni documento, tokenizza il contenuto e memorizza i termini risultanti nell’indice invertito, rendendoli ricercabili immediatamente. Puoi indirizzare l’indice a una directory di output specifica e specificare la cartella sorgente contenente i file da indicizzare.

Definizione della directory di output

// Disable the use of stop words
tsettings.setUseStopWords(false);

Specifica della directory dei documenti

import com.groupdocs.search.Index;

// Define the path to the output directory for indexing
String indexFolder = "YOUR_OUTPUT_DIRECTORY\\IndexingWithStopWords";

// Create an index at the specified location with the configured settings
Index index = new Index(indexFolder, settings);

Esecuzione di una query di ricerca

// Define the path to your document directory
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";

// Add all documents in the specified folder to the index
index.add(documentsFolder);

Poiché disable stop words java è attivo, una query contenente il termine “on” verrà valutata, restituendo corrispondenze che altrimenti verrebbero ignorate dal filtro predefinito.

Applicazioni pratiche

Enterprise Document Search – Conserva la terminologia critica che verrebbe rimossa dalle liste di parole stop predefinite.
E‑commerce Platforms – Aumenta la scoperta dei prodotti indicizzando ogni parola nelle descrizioni, nei numeri di modello e nelle specifiche.
Legal Research Tools – Cattura ogni termine legale, anche quelli comunemente trattati come parole stop, per evitare di perdere clausole cruciali.

Considerazioni sulle prestazioni

Optimization Tips: Aggiorna e pota regolarmente il tuo indice per mantenere alta la velocità di ricerca. GroupDocs.Search può gestire fino a 1 milione di documenti mantenendo tempi di query inferiori al secondo.
Resource Usage: Monitora la dimensione dell’heap JVM; indici grandi possono richiedere un heap massimo (-Xmx) di 4 GB o più.
Java Memory Management: Usa opzioni di archiviazione off‑heap per corpora molto grandi per mantenere l’impronta on‑heap sotto i 2 GB.

Problemi comuni e soluzioni

Sintomo	Causa probabile	Soluzione
Nessun risultato per parole comuni	`setUseStopWords(true)` (predefinito)	Chiama `setUseStopWords(false)` come mostrato sopra.
Errori out‑of‑memory durante l’indicizzazione	Indicizzazione di troppi file di grandi dimensioni contemporaneamente	Indicizza i file in batch; aumenta l’opzione JVM `-Xmx`.
La ricerca restituisce dati obsoleti	Indice non aggiornato dopo l’aggiunta di nuovi file	Chiama `index.update()` o ri‑aggiungi i documenti modificati.

Domande frequenti

Q: What are stop words?
A: Le parole stop sono termini comuni (es. “the”, “is”, “on”) che molti motori di ricerca ignorano per velocizzare le query. Disabilitarle ti consente di trattare ogni token come ricercabile.

Q: Why disable stop words in search indexes?
A: Quando è necessario il matching di frasi esatte—come in documenti legali o tecnici—ogni parola ha un significato, quindi è necessario includere le parole stop.

Q: How does GroupDocs.Search handle large datasets?
A: La libreria utilizza strutture dati ottimizzate e indicizzazione incrementale per mantenere basso l’uso della memoria, anche con milioni di documenti.

Q: Can I integrate GroupDocs.Search with other Java applications?
A: Sì, l’API è progettata per un facile inserimento in qualsiasi sistema basato su Java, dai servizi web alle applicazioni desktop.

Q: What should I do if my search results are not accurate?
A: Verifica che l’indice includa tutti i file necessari (add documents to index), assicurati che il filtro delle parole stop sia disabilitato quando necessario, e considera di ricostruire l’indice dopo modifiche importanti.

Risorse aggiuntive

Documentation: GroupDocs Search Documentation
API Reference: GroupDocs API Reference
Download: Get the latest GroupDocs.Search for Java
GitHub Repository: Explore on GitHub
Free Support: Join GroupDocs Forum
Temporary License: Apply for a Temporary License

Seguendo questa guida, ora sai come add documents to index e disable stop words java per fornire risultati di ricerca più accurati nelle tue applicazioni Java.

Ultimo aggiornamento: 2026-07-07
Testato con: GroupDocs.Search for Java 25.4
Autore: GroupDocs

import com.groupdocs.search.results.SearchResult;

// Define your search query
tString query = "on";

// Perform the search operation using the index and the specified query
SearchResult result = index.search(query);