Tìm kiếm theo thuộc tính java với hướng dẫn GroupDocs.Search

Trong các ứng dụng hiện đại tập trung vào tài liệu, bạn thường cần định vị tệp không chỉ dựa trên nội dung văn bản mà còn dựa trên siêu dữ liệu tùy chỉnh như phòng ban, mức độ bảo mật hoặc ngày tạo. Search by attribute java cung cấp khả năng này trong một truy vấn duy nhất, hiệu suất cao. Trong hướng dẫn này, bạn sẽ thấy cách cập nhật hàng loạt thuộc tính trên các tệp đã được lập chỉ mục, chèn thuộc tính khi lập chỉ mục, và truy vấn tài liệu hiệu quả bằng siêu dữ liệu sử dụng thư viện GroupDocs.Search cho Java.

Câu trả lời nhanh

• Search by attribute java là gì? Nó cho phép bạn lọc kết quả tìm kiếm bằng siêu dữ liệu key‑value được gắn vào mỗi tài liệu đã được lập chỉ mục.
• Tôi có thể sửa đổi thuộc tính sau khi lập chỉ mục không? Có – sử dụng AttributeChangeBatch để áp dụng các thay đổi hàng loạt mà không cần xây dựng lại toàn bộ chỉ mục.
• Làm sao để thêm thuộc tính khi lập chỉ mục? Đăng ký một trình xử lý cho sự kiện FileIndexing và đặt thuộc tính một cách lập trình cho mỗi tệp.
• Có cần giấy phép không? Bản dùng thử miễn phí đủ cho việc đánh giá; giấy phép vĩnh viễn cần thiết cho triển khai sản xuất.
• Yêu cầu phiên bản Java nào? Khuyến nghị sử dụng Java 8 hoặc mới hơn.

“search by attribute java” là gì?

Search by attribute java cho phép bạn truy vấn tài liệu dựa trên siêu dữ liệu tùy chỉnh (thuộc tính) thay vì chỉ nội dung văn bản. Cách tiếp cận này giảm đáng kể tập kết quả, giảm lưu lượng mạng và tăng tốc thời gian phản hồi vì engine đánh giá bộ lọc thuộc tính trước khi thực hiện quét toàn văn bản.

Tại sao nên sử dụng gắn thẻ siêu dữ liệu động?

Gắn thẻ siêu dữ liệu động cho phép bạn gán, cập nhật và quản lý các thuộc tính tùy chỉnh cho tài liệu mà không cần lập chỉ mục lại, cung cấp khả năng phân loại linh hoạt thích ứng với các quy tắc kinh doanh thay đổi, cải thiện hiệu quả tìm kiếm và giảm nhu cầu di chuyển dữ liệu tốn kém trên các kho lưu trữ lớn đồng thời duy trì tính tuân thủ và khả năng kiểm toán.

• Phân loại động – giữ siêu dữ liệu đồng bộ với các quy tắc kinh doanh đang phát triển.
• Lọc nhanh hơn – bộ lọc thuộc tính được đánh giá trước tìm kiếm toàn văn, tăng tốc thời gian phản hồi.
• Theo dõi tuân thủ – gắn thẻ tài liệu cho các chính sách lưu trữ hoặc yêu cầu kiểm toán.
• Cập nhật thuộc tính hàng loạt – thay đổi nhiều tài liệu trong một thao tác mà không cần lập chỉ mục lại toàn bộ.

Yêu cầu trước

• Java 8+ (JDK 8 hoặc mới hơn)
• Thư viện GroupDocs.Search cho Java (xem phần cấu hình Maven bên dưới)
• Kiến thức cơ bản về các collection của Java và xử lý ngoại lệ

Cài đặt GroupDocs.Search cho Java

Cấu hình Maven

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

<repositories>
    <repository>
        <id>groupdocs-releases</id>
        <url>https://repo.groupdocs.com/maven</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

Ngoài ra, tải phiên bản mới nhất từ GroupDocs.Search for Java releases. Nếu bạn không muốn dùng Maven, hãy tải JAR từ trang web GroupDocs.

Nhận giấy phép

• Bắt đầu với bản dùng thử miễn phí để khám phá các tính năng.
• Đối với việc sử dụng lâu dài, hãy lấy giấy phép tạm thời hoặc đầy đủ qua trang giấy phép.

Khởi tạo cơ bản

// Initialize the search index folder
String indexFolder = "C:/search_index";
Index index = new Index(indexFolder);

// Apply license if you have one
License license = new License();
license.setLicense("C:/licenses/groupdocs.lic");

Cách sửa đổi thuộc tính tài liệu (cập nhật hàng loạt)

Để sửa đổi thuộc tính tài liệu sau khi chúng đã được lập chỉ mục, bạn có thể sử dụng API AttributeChangeBatch để áp dụng các cập nhật hàng loạt. Cách tiếp cận này cập nhật siêu dữ liệu của các tệp đã chọn trong một giao dịch duy nhất, tránh việc phải lập chỉ mục lại toàn bộ bộ sưu tập và giữ nguyên chỉ mục toàn văn.

Câu trả lời trực tiếp: Sử dụng AttributeChangeBatch để nhóm các thao tác thêm, xóa hoặc thay thế siêu dữ liệu thành một hoạt động nguyên tử, sau đó commit batch vào chỉ mục. Điều này cập nhật thuộc tính của nhiều tài liệu trong một lần mà vẫn bảo toàn chỉ mục toàn văn hiện có.

Bước 1: thêm tài liệu vào chỉ mục

index.add("C:/docs/contract1.pdf");
index.add("C:/docs/report2.docx");

Bước 2: lấy thông tin tài liệu đã được chỉ mục

DocumentInfo info = index.getDocumentInfo("contract1.pdf");
System.out.println("Current attributes: " + info.getAttributes());

Bước 3: cập nhật hàng loạt thuộc tính tài liệu

Lớp AttributeChangeBatch nhóm nhiều thay đổi thuộc tính thành một thao tác nguyên tử, giảm tải I/O và đảm bảo tính nhất quán của chỉ mục.

AttributeChangeBatch batch = new AttributeChangeBatch();
batch.addAttribute("contract1.pdf", "department", "Legal");
batch.removeAttribute("report2.docx", "confidential");
batch.replaceAttribute("report2.docx", "status", "archived", "active");
index.applyAttributeChanges(batch);

Bước 4: tìm kiếm với bộ lọc thuộc tính

SearchOptions options = new SearchOptions();
options.addAttributeFilter("department", "Legal");
SearchResult result = index.search("agreement", options);
System.out.println("Found " + result.getCount() + " legal documents.");

Cách thêm thuộc tính trong quá trình lập chỉ mục

Thêm thuộc tính trong quá trình lập chỉ mục đảm bảo mỗi tài liệu đều được làm giàu bằng siêu dữ liệu cần thiết ngay từ đầu. Bằng cách xử lý sự kiện FileIndexing, bạn có thể gắn các cặp key‑value vào đối tượng DocumentInfo trước khi engine xử lý tệp, đảm bảo thuộc tính luôn sẵn sàng cho các truy vấn sau này.

Câu trả lời trực tiếp: Đăng ký sự kiện FileIndexing trước khi thêm tệp; trong trình xử lý sự kiện, gọi addAttribute trên đối tượng DocumentInfo để gắn cặp key‑value, sau đó cho phép chỉ mục tiếp tục xử lý tệp.

Bước 1: đăng ký sự kiện FileIndexing

Sự kiện FileIndexing được kích hoạt cho mỗi tệp khi nó được thêm vào chỉ mục, cho phép bạn chèn siêu dữ liệu tùy chỉnh.

index.getEvents().FileIndexing.add(event -> {
    // Example: set department based on folder name
    String folder = new File(event.getFilePath()).getParentFile().getName();
    event.getDocumentInfo().addAttribute("department", folder);
});

Bước 2: lập chỉ mục tài liệu

index.add("C:/incoming/hr/policy.pdf");
index.add("C:/incoming/finance/budget.xlsx");

Ứng dụng thực tiễn

1. Hệ thống quản lý tài liệu – tự động gắn thẻ tệp khi nhập, cho phép điều hướng facet ngay lập tức.
2. Kho lưu trữ nội dung lớn – kết hợp bộ lọc thuộc tính với tìm kiếm toàn văn để rút ngắn thời gian truy vấn từ vài phút xuống vài giây trên các bộ sưu tập đa gigabyte.
3. Tuân thủ & báo cáo – gán động thời gian lưu trữ, mức độ bảo mật hoặc cờ kiểm toán có thể truy vấn để kiểm tra quy định.

Các lưu ý về hiệu năng

• Quản lý bộ nhớ – giám sát heap JVM và điều chỉnh -Xmx (ví dụ, -Xmx4g cho các chỉ mục lớn hơn 2 GB).
• Xử lý hàng loạt – nhóm các thay đổi thuộc tính bằng AttributeChangeBatch để giảm ghi đĩa; chia các batch lớn hơn 10 000 thay đổi để tránh timeout giao dịch.
• Cập nhật thư viện – luôn sử dụng phiên bản GroupDocs.Search mới nhất; phiên bản 25.4 tăng tốc 30 % việc đánh giá bộ lọc thuộc tính so với 24.x.

Các vấn đề thường gặp và giải pháp

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

Q: Các yêu cầu trước khi sử dụng GroupDocs.Search trong Java là gì?
A: Java 8+, thư viện GroupDocs.Search, và kiến thức cơ bản về các khái niệm lập chỉ mục.

Q: Làm sao để cài đặt GroupDocs.Search qua Maven?
A: Thêm kho lưu trữ và phụ thuộc được hiển thị trong phần cấu hình Maven vào file pom.xml của bạn.

Q: Tôi có thể sửa đổi thuộc tính sau khi tài liệu đã được lập chỉ mục không?
A: Có, sử dụng AttributeChangeBatch để cập nhật hàng loạt thuộc tính tài liệu mà không cần lập chỉ mục lại.

Q: Nếu quá trình lập chỉ mục của tôi chậm thì sao?
A: Tối ưu bộ nhớ JVM (-Xmx), sử dụng cập nhật hàng loạt, và nâng cấp lên phiên bản thư viện mới nhất để nhận các bản vá hiệu năng.

Q: Tôi có thể tìm thêm tài nguyên về GroupDocs.Search cho Java ở đâu?
A: Truy cập tài liệu chính thức hoặc tham gia các diễn đàn cộng đồng.

Tài nguyên

• Tài liệu: GroupDocs.Search for Java Docs
• Tham chiếu API: API Reference
• Tải về: Latest Releases
• GitHub: GitHub GroupDocs.Search
• Diễn đàn hỗ trợ miễn phí: GroupDocs Forums
• Giấy phép tạm thời: License Page

Cập nhật lần cuối: 2026-09-21
Được kiểm tra với: GroupDocs.Search 25.4 for Java
Tác giả: GroupDocs

<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.Index;

// Initialize an index in a specified directory
Index index = new Index("YOUR_OUTPUT_DIRECTORY/ChangeAttributes");

index.add("YOUR_DOCUMENT_DIRECTORY");

import com.groupdocs.search.results.DocumentInfo;

DocumentInfo[] documents = index.getIndexedDocuments();

import com.groupdocs.search.common.AttributeChangeBatch;
import com.groupdocs.search.SearchOptions;

AttributeChangeBatch batch = new AttributeChangeBatch();
batch.addToAll("public"); // Add 'public' to all documents
batch.remove(documents[0].getFilePath(), "public"); // Remove 'public' from a specific document
batch.add(documents[0].getFilePath(), "main", "key"); // Add 'main' and 'key' attributes

// Apply changes
index.changeAttributes(batch);

import com.groupdocs.search.results.SearchResult;

SearchOptions options = new SearchOptions();
options.setSearchDocumentFilter(SearchDocumentFilter.createAttribute("main"));
String query = "length";
SearchResult result = index.search(query, options); // Perform the search

import com.groupdocs.search.events.EventHandler;
import com.groupdocs.search.events.FileIndexingEventArgs;

index.getEvents().FileIndexing.add(new EventHandler<FileIndexingEventArgs>() {
    @Override
    public void invoke(Object sender, FileIndexingEventArgs args) {
        if (args.getDocumentFullPath().endsWith("SampleDocument.pdf")) {
            args.setAttributes(new String[] { "main", "key" });
        }
    }
});

index.add("YOUR_DOCUMENT_DIRECTORY");

Hướng dẫn liên quan

• Cách thêm tài liệu vào chỉ mục với Metadata Indexing trong Java bằng GroupDocs.Search
• Cách cập nhật chỉ mục Java với GroupDocs.Search – Hướng dẫn toàn diện
• Tạo chỉ mục Java với GroupDocs.Search | Hướng dẫn toàn diện về lập chỉ mục và báo cáo