Lọc phần mở rộng tệp java với 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** – áp dụng bộ lọc khi tạo `IndexSettings`.

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

### Bộ lọc NOT logic
Loại trừ các phần mở rộng cụ thể, chẳng hạn như trang web và PDF, khi chúng không cần thiết cho kịch bản tìm kiếm của bạn.

#### Các bước thực hiện
1. **Create exclusion filter** – chỉ định các phần mở rộng cần loại bỏ.

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

2. **Apply to index settings** – kết hợp bộ lọc NOT với các quy tắc khác.

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

3. **Add documents** – chỉ các tệp vượt qua bộ lọc kết hợp mới được lập chỉ mục.

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

### Bộ lọc AND logic
Kết hợp nhiều điều kiện—ngày tạo, phần mở rộng và kích thước tệp—để **chỉ các tệp đáp ứng tất cả tiêu chí** được lập chỉ mục.

#### Tổng quan
`DocumentFilter.createAnd` hợp nhất nhiều bộ lọc thành một quy tắc duy nhất.

#### Các bước thực hiện
1. **Define filters** – tạo các bộ lọc riêng cho mỗi điều kiện.

```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** – sử dụng toán tử AND để yêu cầu tất cả các điều kiện.

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

3. **Index documents** – đưa bộ lọc kết hợp vào quy trình lập chỉ mục.

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

### Bộ lọc OR logic
Bao gồm các tệp thỏa mãn **bất kỳ** điều kiện nào được chỉ định—hữu ích khi bạn muốn nắm bắt cả tệp văn bản nhỏ và tệp không phải văn bản lớn hơn.

#### Các bước thực hiện
1. **Define filters** – tạo các bộ lọc riêng cho mỗi điều kiện thay thế.

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

2. **Combine filters with logical conditions** – sử dụng toán tử OR.

```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** – gắn bộ lọc kết hợp vào cấu hình chỉ mục.

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

### Bộ lọc thời gian tạo
Nhắm mục tiêu các tệp được tạo trong một khoảng thời gian cụ thể—một kịch bản **date range filter java** điển hình.

#### Các bước thực hiện
1. **Define date‑range filter** – chỉ định ngày bắt đầu và ngày kết thúc.

```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** – chỉ các tệp có dấu thời gian tạo nằm trong khoảng sẽ được lập chỉ mục.

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

### Bộ lọc thời gian sửa đổi
Loại trừ các tệp đã được sửa đổi sau một ngày cắt cụ thể.

#### Các bước thực hiện
1. **Define filter** – đặt dấu thời gian sửa đổi tối đa.

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

2. **Index documents** – các tệp mới hơn ngày cắt sẽ bị bỏ qua.

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

### Lọc đường dẫn tệp
Hạn chế việc lập chỉ mục chỉ các tệp nằm trong các thư mục cụ thể hoặc khớp với một mẫu—lý tưởng cho **include files by extension** trong một cấu trúc thư mục nhất định.

#### Các bước thực hiện
1. **Define file‑path filter** – sử dụng mẫu glob hoặc regex để khớp thư mục.

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

2. **Initialize index and add documents** – áp dụng bộ lọc đường dẫn cùng với các quy tắc khác.

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

## Những lỗi thường gặp & mẹo
- **Never mix absolute and relative paths** trong cùng một cấu hình bộ lọc – có thể dẫn đến việc loại trừ không mong muốn.  
- **Reset the `IndexSettings`** khi chuyển bộ lọc; nếu không các bộ lọc trước có thể vẫn tồn tại.  
- **Combine a length upper bound with an extension filter** cho các bộ sưu tập lớn để giữ mức sử dụng bộ nhớ thấp.  
- LoggingOptions kiểm soát cấu hình ghi log cho GroupDocs.Search.  
- **Enable logging** (`LoggingOptions.setEnabled(true)`) để xem lý do một tệp bị từ chối.  

## Câu hỏi thường gặp

**Q: Can I change the filter criteria after the index is created?**  
A: Có. Tái tạo chỉ mục với một `DocumentFilter` mới hoặc sử dụng lập chỉ mục tăng dần với các thiết lập đã cập nhật.

**Q: Does the java file extension filter work on compressed archives (e.g., ZIP)?**  
A: GroupDocs.Search có thể lập chỉ mục các định dạng archive được hỗ trợ, nhưng bộ lọc phần mở rộng áp dụng cho chính archive, không phải các tệp bên trong. Sử dụng bộ lọc lồng nhau để kiểm soát sâu hơn.

**Q: How do I debug why a particular file was excluded?**  
A: Bật ghi log của thư viện (`LoggingOptions.setEnabled(true)`) và kiểm tra log – nó sẽ báo cáo bộ lọc nào đã từ chối mỗi tệp.

**Q: Is it possible to combine the java file extension filter with custom regex filters?**  
A: Chắc chắn. Đặt một bộ lọc regex bên trong `DocumentFilter.createAnd()` cùng với bộ lọc phần mở rộng.

**Q: What performance impact does adding many filters have?**  
A: Mỗi bộ lọc thêm một phần tải nhẹ trong quá trình lập chỉ mục, nhưng việc giảm dữ liệu được lập chỉ mục thường bù đắp chi phí. Kiểm thử với mẫu đại diện để tìm cân bằng tối ưu.

**Last Updated:** 2026-09-06  
**Tested With:** GroupDocs.Search 25.4 for Java  
**Author:** GroupDocs

## Hướng dẫn liên quan

- [Định dạng ngày tùy chỉnh Java | Tìm kiếm theo phạm vi ngày với GroupDocs](/search/java/advanced-features/master-date-range-searches-groupdocs-java/)
- [java boolean and or: Nắm vững tìm kiếm Boolean với GroupDocs.Search cho Java](/search/java/searching/implement-boolean-searches-groupdocs-java/)
- [Tối ưu hiệu suất tìm kiếm với kỹ thuật lập chỉ mục nâng cao trong GroupDocs.Search cho Java](/search/java/indexing/groupdocs-search-java-advanced-indexing/)