Meistern des java-Dateierweiterungsfilters mit 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");
    ```

### Logischer NOT‑Filter
Schließen Sie bestimmte Dateierweiterungen beim Indexieren aus, z. B. HTM, HTML und PDF.

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

### Logischer AND‑Filter
Kombinieren Sie mehrere Kriterien, um nur Dateien einzuschließen, die alle angegebenen Bedingungen erfüllen.

#### Überblick
Verwenden Sie logische AND‑Operationen, um Dateien basierend auf Erstellungszeit, Dateierweiterung und Länge zu filtern.

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

### Logischer OR‑Filter
Schließen Sie Dateien ein, die eines der angegebenen Kriterien erfüllen, indem Sie logische OR‑Operationen verwenden.

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

### Erstellungszeit‑Filter
Filtern Sie Dateien basierend auf deren Erstellungszeit, um nur solche innerhalb eines angegebenen Datumsbereichs einzuschließen.

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

### Änderungszeit‑Filter
Schließen Sie Dateien aus, die nach einem bestimmten Datum geändert wurden.

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

### Dateipfad‑Filterung
Filtern Sie Dateien basierend auf ihren Dateipfaden, um nur solche in bestimmten Verzeichnissen einzuschließen.

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

## Häufige Fallstricke & Tipps

- **Mischen Sie niemals absolute und relative Pfade** in derselben Filterkonfiguration – das kann zu unerwarteten Ausschlüssen führen.  
- **Denken Sie daran, die `IndexSettings` zurückzusetzen**, wenn Sie von einem Filtersatz zum anderen wechseln; sonst können vorherige Filter bestehen bleiben.  
- **Große Dateisammlungen** profitieren davon, eine obere Längenbegrenzung mit einem Erweiterungsfilter zu kombinieren, um den Speicherverbrauch gering zu halten.  

## Häufig gestellte Fragen

**Q: Kann ich die Filterkriterien ändern, nachdem der Index erstellt wurde?**  
A: Ja. Sie können den Index mit einem neuen `DocumentFilter` neu aufbauen oder inkrementelles Indexieren mit aktualisierten Einstellungen verwenden.

**Q: Funktioniert der java file extension filter bei komprimierten Archiven (z. B. ZIP)?**  
A: GroupDocs.Search kann unterstützte Archivformate indizieren, jedoch gilt der Erweiterungsfilter für das Archiv selbst, nicht für die inneren Dateien. Verwenden Sie bei Bedarf verschachtelte Filter.

**Q: Wie kann ich debuggen, warum eine bestimmte Datei ausgeschlossen wurde?**  
A: Aktivieren Sie das Logging der Bibliothek (setzen Sie `LoggingOptions.setEnabled(true)`) und prüfen Sie das erzeugte Log – es gibt an, welcher Filter jede Datei abgelehnt hat.

**Q: Ist es möglich, den java file extension filter mit benutzerdefinierten Regex‑Filtern zu kombinieren?**  
A: Absolut. Sie können einen Regex‑Filter innerhalb von `DocumentFilter.createAnd()` zusammen mit dem Erweiterungsfilter einbinden.

**Q: Welche Auswirkungen auf die Leistung hat das Hinzufügen vieler Filter?**  
A: Jeder zusätzliche Filter verursacht einen kleinen Overhead beim Indexieren, aber der Nutzen einer kleineren Indexgröße überwiegt in der Regel die Kosten. Testen Sie mit einem Beispielset, um das optimale Gleichgewicht zu finden.

---

**Zuletzt aktualisiert:** 2025-12-19  
**Getestet mit:** GroupDocs.Search 25.4 für Java  
**Autor:** GroupDocs