Padroneggiare il filtro di estensione file java con GroupDocs.Search

Gestire un repository di documenti in crescita può diventare rapidamente opprimente, soprattutto quando è necessario indicizzare solo determinati tipi di file. Il filtro di estensione file java consente di indicare a GroupDocs.Search esattamente quali estensioni includere o escludere, offrendo un controllo preciso sul tuo flusso di indicizzazione. In questa guida vedremo come configurare GroupDocs.Search per Java e come combinare il filtraggio per estensione di file con gli operatori logici AND, OR e NOT, oltre ai filtri per intervallo di date e percorsi.

Risposte rapide

  • Che cos’è il filtro di estensione file java? Una configurazione che indica a GroupDocs.Search quali estensioni di file includere o escludere durante l’indicizzazione.
  • Quale libreria fornisce questa funzionalità? GroupDocs.Search for Java.
  • Ho bisogno di una licenza? Una prova gratuita funziona per la valutazione; è necessaria una licenza completa per la produzione.
  • Posso combinare i filtri? Sì – è possibile concatenare filtri di estensione, data, dimensione e percorso con logica AND, OR, NOT.
  • È compatibile con Maven? Assolutamente – aggiungi la dipendenza GroupDocs.Search al tuo pom.xml.

Che cos’è un filtro di estensione file java?

Un filtro di estensione file java è un insieme di regole che valuta l’estensione di ogni file prima che venga inviato al motore di indicizzazione. Specificando estensioni come .txt, .pdf o .epub, è possibile includere file per estensione o escludere file per estensione per mantenere l’indice focalizzato e i risultati di ricerca pertinenti.

Perché utilizzare il filtraggio per estensione di file con GroupDocs.Search?

  • Prestazioni: Saltare i file indesiderati riduce I/O e velocizza l’indicizzazione.
  • Risparmio di spazio: Solo i documenti rilevanti sono memorizzati nell’indice, riducendo l’uso del disco.
  • Conformità: Previene l’indicizzazione accidentale di tipi di file riservati o non supportati.
  • Flessibilità: Combina con le funzionalità date range filter java per mirare ai file creati o modificati entro periodi specifici.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

Librerie e dipendenze richieste

  • GroupDocs.Search for Java: Version 25.4 o successiva
  • Java Development Kit (JDK): Versione compatibile installata

Configurazione dell’ambiente

  • Ambiente di sviluppo integrato (IDE): IntelliJ IDEA, Eclipse o qualsiasi IDE compatibile con Maven.

Prerequisiti di conoscenza

  • Programmazione Java di base
  • Familiarità con I/O di file in Java
  • Comprensione delle espressioni regolari e della gestione di data‑ora

Configurazione di GroupDocs.Search per Java

Per iniziare a utilizzare GroupDocs.Search, è necessario includerlo come dipendenza nel tuo progetto.

Configurazione Maven

Aggiungi la seguente configurazione di repository e dipendenza 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

  1. Prova gratuita – esplora le funzionalità senza costi.
  2. Licenza temporanea – ottieni la funzionalità completa per un periodo limitato.
  3. Acquisto – ottieni una licenza permanente per l’uso in produzione.

Inizializzazione e configurazione di base

Una volta aggiunta la libreria, inizializza il tuo ambiente di indicizzazione:

import com.groupdocs.search.*;

String indexFolder = "YOUR_OUTPUT_DIRECTORY";
Index index = new Index(indexFolder);

Guida all’implementazione

Di seguito approfondiamo ogni tipo di filtro, spiegando perché è importante e fornendo codice passo‑passo che puoi copiare nel tuo progetto.

Filtraggio per estensione di file

Filtra i file in base alle loro estensioni durante l’indicizzazione. È perfetto quando vuoi elaborare solo e‑book (.fb2, .epub) e file di testo semplice (.txt).

Panoramica

Usa DocumentFilter.createFileExtension per creare una whitelist di estensioni.

Passaggi di implementazione

  1. Crea filtro:

    DocumentFilter filter = DocumentFilter.createFileExtension(".fb2", ".epub", ".txt");
IndexSettings settings = new IndexSettings();
settings.setDocumentFilter(filter);

  2. Inizializza l’indice e aggiungi documenti:

    Index index = new Index("YOUR_OUTPUT_DIRECTORY\\FileExtensionFilter", settings);
index.add("YOUR_DOCUMENT_DIRECTORY");

Filtro logico NOT

Escludi estensioni specifiche, come pagine web e PDF, quando non sono necessarie per il tuo scenario di ricerca.

Passaggi di implementazione

  1. Crea filtro di esclusione:

    DocumentFilter filterNot = DocumentFilter.createFileExtension(".htm", ".html", ".pdf");
DocumentFilter invertedFilter = DocumentFilter.createNot(filterNot);

  2. Applica alle impostazioni dell’indice:

    IndexSettings settingsNot = new IndexSettings();
settingsNot.setDocumentFilter(invertedFilter);

  3. Aggiungi documenti:

    Index indexNot = new Index("YOUR_OUTPUT_DIRECTORY\\LogicalNotFilter", settingsNot);
indexNot.add("YOUR_DOCUMENT_DIRECTORY");

Filtro logico AND

Combina diverse condizioni—data di creazione, estensione e dimensione del file—così che solo i file che soddisfano tutti i criteri vengano indicizzati.

Panoramica

DocumentFilter.createAnd unisce più filtri in una singola regola.

Passaggi di implementazione

  1. Definisci i filtri:

    DocumentFilter filter1 = DocumentFilter.createCreationTimeRange(Utils.createDate(2015, 1, 1), Utils.createDate(2016, 1, 1));
DocumentFilter filter2 = DocumentFilter.createFileExtension(".txt");
DocumentFilter filter3 = DocumentFilter.createFileLengthUpperBound(8 * 1024 * 1024);

  2. Combina i filtri:

    DocumentFilter finalFilterAnd = DocumentFilter.createAnd(filter1, filter2, filter3);
IndexSettings settingsAnd = new IndexSettings();
settingsAnd.setDocumentFilter(finalFilterAnd);

  3. Indicizza i documenti:

    Index indexAnd = new Index("YOUR_OUTPUT_DIRECTORY\\LogicalAndFilter", settingsAnd);
indexAnd.add("YOUR_DOCUMENT_DIRECTORY");

Filtro logico OR

Includi i file che soddisfano una qualsiasi delle condizioni specificate—utile quando vuoi catturare sia piccoli file di testo sia file non‑testo più grandi.

Passaggi di implementazione

  1. Definisci i filtri:

    DocumentFilter txtFilter = DocumentFilter.createFileExtension(".txt");
DocumentFilter notTxtFilter = DocumentFilter.createNot(txtFilter);

  2. Combina i filtri con condizioni logiche:

    DocumentFilter bound5Filter = DocumentFilter.createFileLengthUpperBound(5 * 1024 * 1024);
DocumentFilter bound10Filter = DocumentFilter.createFileLengthUpperBound(10 * 1024 * 1024);

DocumentFilter txtSizeFilter = DocumentFilter.createAnd(txtFilter, bound5Filter);
DocumentFilter notTxtSizeFilter = DocumentFilter.createAnd(notTxtFilter, bound10Filter);

  3. Finalizza il filtro OR:

    DocumentFilter finalFilterOr = DocumentFilter.createOr(txtSizeFilter, notTxtSizeFilter);

IndexSettings settingsOr = new IndexSettings();
settingsOr.setDocumentFilter(finalFilterOr);
Index indexOr = new Index("YOUR_OUTPUT_DIRECTORY\\LogicalOrFilter", settingsOr);
indexOr.add("YOUR_DOCUMENT_DIRECTORY");

Filtri per data di creazione

Seleziona i file creati entro un periodo specifico—uno scenario classico di date range filter java.

Passaggi di implementazione

  1. Definisci il filtro di intervallo di date:

    DocumentFilter filter3CTime = DocumentFilter.createCreationTimeRange(Utils.createDate(2017, 1, 1), Utils.createDate(2018, 6, 15));
IndexSettings settingsCTime = new IndexSettings();
settingsCTime.setDocumentFilter(filter3CTime);

  2. Indicizza i documenti:

    Index indexCTime = new Index("YOUR_OUTPUT_DIRECTORY\\CreationTimeFilters", settingsCTime);
indexCTime.add("YOUR_DOCUMENT_DIRECTORY");

Filtri per data di modifica

Escludi i file che sono stati modificati dopo una certa data di cut‑off.

Passaggi di implementazione

  1. Definisci il filtro:

    DocumentFilter filter2MTime = DocumentFilter.createModificationTimeUpperBound(Utils.createDate(2018, 6, 15));
IndexSettings settingsMTime = new IndexSettings();
settingsMTime.setDocumentFilter(filter2MTime);

  2. Indicizza i documenti:

    Index indexMTime = new Index("YOUR_OUTPUT_DIRECTORY\\ModificationTimeFilters", settingsMTime);
indexMTime.add("YOUR_DOCUMENT_DIRECTORY");

Filtraggio per percorso file

Limita l’indicizzazione ai file situati in cartelle specifiche o che corrispondono a un modello—ideale per includere file per estensione all’interno di una gerarchia di directory specifica.

Passaggi di implementazione

  1. Definisci il filtro per percorso file:

    DocumentFilter pathFilter = DocumentFilter.createPath("*.txt", "documents/");
IndexSettings settingsPath = new IndexSettings();
settingsPath.setDocumentFilter(pathFilter);

  2. Inizializza l’indice e aggiungi documenti:

    Index indexPath = new Index("YOUR_OUTPUT_DIRECTORY\\FilePathFilter", settingsPath);
indexPath.add("YOUR_DOCUMENT_DIRECTORY");

Problemi comuni e consigli

  • Non mescolare mai percorsi assoluti e relativi nella stessa configurazione di filtro – può portare a esclusioni inattese.
  • Reimposta le IndexSettings quando cambi set di filtri; altrimenti i filtri precedenti potrebbero persistere.
  • Combina un limite superiore di lunghezza con un filtro di estensione per collezioni grandi, così da mantenere basso l’uso di memoria.
  • Abilita il logging (LoggingOptions.setEnabled(true)) per vedere perché un file è stato rifiutato.

Domande frequenti

D: Posso modificare i criteri del filtro dopo che l’indice è stato creato?
R: Sì. Ricostruisci l’indice con un nuovo DocumentFilter o utilizza l’indicizzazione incrementale con impostazioni aggiornate.

D: Il filtro di estensione file java funziona su archivi compressi (ad es., ZIP)?
R: GroupDocs.Search può indicizzare i formati di archivio supportati, ma il filtro di estensione si applica all’archivio stesso, non ai file interni. Usa filtri nidificati per un controllo più approfondito.

D: Come posso fare il debug del motivo per cui un file specifico è stato escluso?
R: Abilita il logging della libreria (LoggingOptions.setEnabled(true)) e ispeziona il log – segnala quale filtro ha rifiutato ogni file.

D: È possibile combinare il filtro di estensione file java con filtri regex personalizzati?
R: Assolutamente. Avvolgi un filtro regex dentro DocumentFilter.createAnd() insieme al filtro di estensione.

D: Qual è l’impatto sulle prestazioni dell’aggiunta di molti filtri?
R: Ogni filtro aggiunge un modesto overhead durante l’indicizzazione, ma la riduzione dei dati indicizzati di solito supera il costo. Testa con un campione rappresentativo per trovare il bilancio ottimale.

Last Updated: 2026-02-21
Tested With: GroupDocs.Search 25.4 for Java
Author: GroupDocs