Cách thêm thư mục vào chỉ mục với GroupDocs.Search trong Java

Nếu bạn cần java full text search có thể mở rộng lên hàng triệu tài liệu, bạn đang ở đúng nơi. Trong hướng dẫn này, bạn sẽ học cách add folder to index bằng cách sử dụng GroupDocs.Search, cấu hình lưu trữ nén cao, và thực hiện các truy vấn siêu nhanh. Khi kết thúc, bạn sẽ có một giải pháp sẵn sàng cho sản xuất mà bạn có thể tích hợp vào bất kỳ dự án Java nào.

Câu trả lời nhanh

  • Thư viện chính là gì? GroupDocs.Search for Java
  • Cách thêm thư mục vào chỉ mục? Use index.add(folderPath)
  • Tôi có thể cấu hình nén văn bản không? Yes, via TextStorageSettings(Compression.High)
  • Phiên bản Java nào được yêu cầu? JDK 8 or higher
  • Nơi lấy giấy phép dùng thử? From the GroupDocs website or the repository page

Java full text search là gì và tại sao nó quan trọng?

Java full text search chuyển đổi tài liệu thô thành một chỉ mục đảo ngược, cho phép truy xuất dưới một giây bất kỳ thuật ngữ nào trên hàng ngàn tệp. Khả năng này là thiết yếu cho các kho lưu trữ pháp lý, thư viện nghiên cứu và cơ sở tri thức doanh nghiệp, nơi người dùng mong đợi kết quả ngay lập tức. Nó cũng nâng cao năng suất trong các ứng dụng hiện đại.

GroupDocs.Search cung cấp khả năng lập chỉ mục và thực thi truy vấn tốc độ cao đồng thời tích hợp nén cao. Nó hỗ trợ 50+ input and output formats—bao gồm PDF, DOCX, EML và HTML—và có thể xử lý các tài liệu hàng trăm trang mà không cần tải toàn bộ tệp vào bộ nhớ, giữ dung lượng bộ nhớ dưới 200 MB cho các khối lượng công việc điển hình.

Yêu cầu trước

  • GroupDocs.Search for Java (phiên bản 25.4 hoặc mới hơn) – thư viện cốt lõi cung cấp khả năng lập chỉ mục và tìm kiếm.
  • JDK 8+ đã cài đặt và cấu hình – môi trường chạy tối thiểu cần cho SDK.
  • Maven để quản lý phụ thuộc – đơn giản hoá việc thêm thư viện vào dự án của bạn.
  • Một IDE như IntelliJ IDEA hoặc Eclipse – để viết và gỡ lỗi mã Java.

Cài đặt GroupDocs.Search cho java

Cấu hình Maven

Thêm kho lưu trữ và phụ thuộc vào tệp pom.xml của bạn:

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

Tải trực tiếp

Hoặc, tải phiên bản mới nhất từ GroupDocs.Search for Java releases.

Nhận giấy phép

  • Free trial – khám phá tất cả tính năng mà không cần cam kết.
  • Temporary license – thời gian thử nghiệm kéo dài.
  • Purchase – mở khóa đầy đủ khả năng sản xuất.

Khởi tạo và cấu hình cơ bản

Index là lớp cốt lõi được sử dụng để tạo, mở và quản lý một chỉ mục tìm kiếm.

import com.groupdocs.search.Index;

public class InitializeSearch {
    public static void main(String[] args) {
        // Path to store index data
        String indexPath = "path/to/index";
        
        // Creating an index at specified location
        Index index = new Index(indexPath);
        
        System.out.println("GroupDocs.Search initialized successfully!");
    }
}

Lập chỉ mục văn bản với nén tùy chỉnh

Bước 1: xác định thư mục chỉ mục

Chọn một thư mục nơi các tệp chỉ mục sẽ được lưu trữ:

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";

Bước 2: cấu hình cài đặt chỉ mục

TextStorageSettings cấu hình cách văn bản được lưu trong chỉ mục, bao gồm mức nén. Compression là một enum xác định thuật toán nén mong muốn.

import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.options.TextStorageSettings;
import com.groupdocs.search.compression.Compression;

IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));

Bước 3: tạo chỉ mục với cài đặt tùy chỉnh

Khởi tạo chỉ mục bằng cách sử dụng cấu hình đã định nghĩa ở trên:

Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");

Cách thêm thư mục vào chỉ mục

Index là lớp chính đại diện cho chỉ mục có thể tìm kiếm.

Tải chỉ mục hiện có (hoặc tạo mới) và sau đó gọi phương thức add trên đối tượng Index. Hoạt động add sẽ quét thư mục được cung cấp, trích xuất văn bản từ mỗi tệp được hỗ trợ và lưu nó vào chỉ mục đã nén, sẵn sàng cho việc tìm kiếm ngay lập tức.

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);

Cách tìm kiếm tài liệu đã lập chỉ mục

SearchResult đại diện cho một kết quả khớp duy nhất với đường dẫn tài liệu và mức độ liên quan.

Xác định một chuỗi truy vấn tìm kiếm đại diện cho thuật ngữ hoặc cụm từ bạn muốn tìm, sau đó gọi phương thức search trên thể hiện Index. Phương thức này trả về một tập hợp các đối tượng SearchResult, mỗi đối tượng chứa đường dẫn tài liệu, điểm liên quan và đoạn trích làm nổi bật kết quả.

index.add(documentsFolder);
System.out.println("Documents added successfully.");

Ứng dụng thực tiễn

Các kịch bản thực tế mà java full text search tỏa sáng:

  1. Legal document management – truy xuất ngay lập tức các hồ sơ vụ án.
  2. Academic research libraries – tra cứu nhanh các bài báo và luận văn.
  3. Enterprise knowledge bases – truy cập nhanh vào tài liệu hướng dẫn và FAQ.
  4. Content management systems – khám phá nội dung hiệu quả cho các trang web lớn.
  5. Customer service archives – tìm kiếm nhanh các phiếu hỗ trợ và trò chuyện đã qua.

Các cân nhắc về hiệu năng

  • Compression vs. speed: Nén cao giúp tiết kiệm tới 70 % không gian đĩa nhưng tăng nhẹ chi phí lập chỉ mục; thực hiện các bài kiểm tra benchmark cho khối lượng dữ liệu của bạn.
  • Memory management: Phân bổ ít nhất 2 GB heap cho các chỉ mục lớn hơn 10 GB để tránh OutOfMemoryError.
  • Index updates: Thêm tài liệu mới một cách tăng dần bằng index.add() và định kỳ gọi index.optimize() để giữ chỉ mục gọn gàng.
  • Query optimization: Sử dụng cú pháp truy vấn nâng cao (wildcards, proximity, fuzzy search) để thu hẹp kết quả và giảm thời gian phản hồi.

Những lỗi thường gặp & mẹo chuyên nghiệp

  • Pitfall: Quên gọi index.optimize() sau khi thêm hàng loạt.
    Pro tip: Chạy index.optimize() hàng đêm để giữ chỉ mục gọn gàng.

  • Pitfall: Sử dụng nén mặc định (thấp) trên bộ dữ liệu khổng lồ.
    Pro tip: Chuyển sang Compression.High cho môi trường sản xuất để giảm chi phí lưu trữ.

  • Pitfall: Không xử lý IOException khi thêm tệp từ chia sẻ mạng.
    Pro tip: Bao bọc index.add() trong khối try‑catch và ghi lại bất kỳ lỗi nào để xem lại sau.

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

Q: GroupDocs.Search là gì?
A: Đó là một thư viện Java mạnh mẽ cung cấp khả năng tìm kiếm toàn văn nâng cao, bao gồm lập chỉ mục, nén và hỗ trợ truy vấn phức tạp.

Q: Làm thế nào để xử lý bộ dữ liệu lớn với GroupDocs.Search?
A: Bật nén cao (Compression.High) và định kỳ commit các thay đổi để giữ chỉ mục gọn. Ngoài ra, phân bổ đủ bộ nhớ heap (ví dụ, 4 GB cho các chỉ mục trên 20 GB).

Q: Tôi có thể tích hợp GroupDocs.Search với các hệ thống doanh nghiệp hiện có không?
A: Có, thư viện có thể nhúng vào bất kỳ backend dựa trên Java, dịch vụ REST hoặc kiến trúc micro‑services nào.

Q: Nếu chỉ mục của tôi trở nên lỗi thời thì sao?
A: Sử dụng phương thức index.add() để thêm tệp mới và index.delete() để xóa các tệp không còn dùng, sau đó chạy lại index.optimize() nếu cần.

Q: Tôi có thể nhận hỗ trợ hoặc trợ giúp ở đâu?
A: Truy cập diễn đàn cộng đồng tại GroupDocs forums để được hỗ trợ và các mẹo thực hành tốt nhất.

Tài nguyên bổ sung


Last Updated: 2026-11-02
Tested With: GroupDocs.Search 25.4
Author: GroupDocs

String query = "sample";  
import com.groupdocs.search.results.SearchResult;

SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());

Hướng dẫn liên quan