Maîtriser le filtre d’extension de fichier java avec GroupDocs.Search

<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>

import com.groupdocs.search.*;

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

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

2. **Initialize Index and Add Documents** :

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

### Filtre logique NOT
Exclure des extensions de fichiers spécifiques lors de l’indexation, telles que HTM, HTML et PDF.

#### Étapes de mise en œuvre
1. **Create Exclusion Filter** :

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

2. **Apply to Index Settings** :

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

3. **Add Documents** :

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

### Filtre logique AND
Combiner plusieurs critères pour n’inclure que les fichiers qui répondent à toutes les conditions spécifiées.

#### Vue d'ensemble
Utiliser les opérations logiques AND pour filtrer les fichiers en fonction du temps de création, de l’extension de fichier et de la longueur.

#### Étapes de mise en œuvre
1. **Define Filters** :

```java
    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. **Combine Filters** :

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

3. **Index Documents** :

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

### Filtre logique OR
Inclure les fichiers qui répondent à l’un des critères spécifiés à l’aide d’opérations logiques OR.

#### Étapes de mise en œuvre
1. **Define Filters** :

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

2. **Combine Filters with Logical Conditions** :

```java
    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. **Finalize OR Filter** :

```java
    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");
    ```

### Filtres de temps de création
Filtrer les fichiers en fonction de leur temps de création pour n’inclure que ceux situés dans une plage de dates spécifiée.

#### Étapes de mise en œuvre
1. **Define Date Range Filter** :

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

2. **Index Documents** :

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

### Filtres de temps de modification
Exclure les fichiers modifiés après une date précise.

#### Étapes de mise en œuvre
1. **Define Filter** :

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

2. **Index Documents** :

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

### Filtrage par chemin de fichier
Filtrer les fichiers en fonction de leurs chemins pour n’inclure que ceux situés dans des répertoires spécifiques.

#### Étapes de mise en œuvre
1. **Define File Path Filter** :

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

2. **Initialize Index and Add Documents** :

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

## Pièges courants & conseils
- **Never mix absolute and relative paths** dans la même configuration de filtre – cela peut entraîner des exclusions inattendues.  
- **Remember to reset the `IndexSettings`** lorsque vous passez d’un jeu de filtres à un autre ; sinon les filtres précédents peuvent persister.  
- **Large file collections** bénéficient de la combinaison d’une borne supérieure de longueur avec un filtre d’extension afin de réduire l’utilisation de la mémoire.  

## Questions fréquentes

**Q : Puis‑je modifier les critères de filtrage après la création de l’index ?**  
R : Oui. Vous pouvez reconstruire l’index avec un nouveau `DocumentFilter` ou utiliser l’indexation incrémentielle avec des paramètres mis à jour.

**Q : Le java file extension filter fonctionne‑t‑il sur les archives compressées (par ex., ZIP) ?**  
R : GroupDocs.Search peut indexer les formats d’archives pris en charge, mais le filtre d’extension s’applique à l’archive elle‑même, pas aux fichiers internes. Utilisez des filtres imbriqués si nécessaire.

**Q : Comment déboguer la raison pour laquelle un fichier particulier a été exclu ?**  
R : Activez la journalisation de la bibliothèque (`LoggingOptions.setEnabled(true)`) et examinez le journal généré ; il indique quel filtre a rejeté chaque fichier.

**Q : Est‑il possible de combiner le java file extension filter avec des filtres regex personnalisés ?**  
R : Absolument. Vous pouvez encapsuler un filtre regex à l’intérieur de `DocumentFilter.createAnd()` aux côtés du filtre d’extension.

**Q : Quel impact sur les performances l’ajout de nombreux filtres entraîne‑t‑il ?**  
R : Chaque filtre supplémentaire ajoute une légère surcharge lors de l’indexation, mais le bénéfice d’une taille d’index réduite l’emporte généralement sur le coût. Testez avec un jeu d’échantillons pour trouver le compromis optimal.

---

**Last Updated:** 2025-12-19  
**Tested With:** GroupDocs.Search 25.4 for Java  
**Author:** GroupDocs