Hướng dẫn Search by Attribute Java với GroupDocs.Search

Bạn đang muốn nâng cao hệ thống quản lý tài liệu của mình bằng cách động chỉnh sửa và lập chỉ mục các thuộc tính tài liệu bằng Java? Bạn đã đến đúng nơi! Bài hướng dẫn này sẽ đi sâu vào việc tận dụng thư viện mạnh mẽ GroupDocs.Search for Java để search by attribute java, thay đổi các thuộc tính tài liệu đã lập chỉ mục và thêm chúng trong quá trình lập chỉ mục. Dù bạn đang xây dựng giải pháp tìm kiếm hay tối ưu hoá quy trình tài liệu, việc nắm vững các kỹ thuật này là chìa khóa.

Câu trả lời nhanh

  • What is “search by attribute java”? Đó là khả năng lọc kết quả tìm kiếm bằng siêu dữ liệu tùy chỉnh được gắn vào mỗi tài liệu.
  • Can I modify attributes after indexing? Có — sử dụng AttributeChangeBatch để cập nhật hàng loạt các thuộc tính tài liệu.
  • How do I add attributes while indexing? Đăng ký sự kiện FileIndexing và thiết lập thuộc tính bằng mã.
  • Do I need a license? Bản dùng thử miễn phí đủ cho việc đánh giá; giấy phép vĩnh viễn là bắt buộc cho môi trường sản xuất.
  • Which Java version is required? Khuyến nghị sử dụng Java 8 hoặc phiên bản 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 (thuộc tính) của chúng thay vì chỉ nội dung. Bằng cách gắn các cặp key‑value như public, main, hoặc key vào mỗi tệp, bạn có thể nhanh chóng thu hẹp kết quả tới tập con phù hợp nhất.

Tại sao cần sửa đổi hoặc thêm thuộc tính?

  • Dynamic categorization – giữ metadata đồng bộ với các quy tắc kinh doanh.
  • Faster filtering – bộ lọc thuộc tính được đánh giá trước tìm kiếm toàn văn, giúp cải thiện hiệu năng.
  • Compliance tracking – 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.

Yêu cầu trước

  • Java 8+ (JDK 8 hoặc mới hơn)
  • GroupDocs.Search for Java library (xem phần Cài đặt Maven bên dưới)
  • Kiến thức cơ bản về Java và các khái niệm lập chỉ mục

Cài đặt GroupDocs.Search cho Java

Cài đặt Maven

<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

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 công cụ xây dựng như Maven, tải JAR từ GroupDocs website.

Cách lấy 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, lấy giấy phép tạm thời hoặc đầy đủ qua license page.

Khởi tạo cơ bản

import com.groupdocs.search.Index;

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

Hướng dẫn triển khai

Search by Attribute Java – Thay đổi Thuộc tính Tài liệu

Tổng quan

Bạn có thể thêm, xóa hoặc thay thế thuộc tính trên các tài liệu đã được lập chỉ mục, cho phép batch update document attributes mà không cần lập chỉ mục lại toàn bộ bộ sưu tập.

Các bước thực hiện

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

index.add("YOUR_DOCUMENT_DIRECTORY");

B 2: Lấy thông tin tài liệu đã lập chỉ mục

import com.groupdocs.search.results.DocumentInfo;

DocumentInfo[] documents = index.getIndexedDocuments();

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

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

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

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

Cập nhật hàng loạt Thuộc tính Tài liệu bằng AttributeChangeBatch

Lớp AttributeChangeBatch là công cụ cốt lõi cho batch update document attributes. Bằng cách nhóm các thay đổi thành một batch duy nhất, bạn giảm tải I/O và giữ cho chỉ mục luôn nhất quán.

Search by Attribute Java – Thêm Thuộc tính Khi Lập chỉ mục

Tổng quan

Kết nối vào sự kiện FileIndexing để gán các thuộc tính tùy chỉnh khi mỗi tệp được thêm vào chỉ mục.

Các bước thực hiện

Bước 1: Đăng ký Sự kiện FileIndexing

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("Lorem ipsum.pdf")) {
            args.setAttributes(new String[] { "main", "key" });
        }
    }
});

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

index.add("YOUR_DOCUMENT_DIRECTORY");

Ứng dụng Thực tiễn

  1. Document Management Systems – Tự động phân loại bằng cách thêm metadata trong quá trình nhập.
  2. Large Content Archives – Sử dụng bộ lọc thuộc tính để thu hẹp tìm kiếm, giảm thời gian phản hồi đáng kể.
  3. Compliance & Reporting – Gắn thẻ tài liệu động cho lịch trình lưu trữ hoặc theo dõi kiểm toán.

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

  • Memory Management – Giám sát heap của JVM và điều chỉnh -Xmx khi cần.
  • Batch Processing – Nhóm các thay đổi thuộc tính bằng AttributeChangeBatch để giảm số lần ghi chỉ mục.
  • Library Updates – Giữ GroupDocs.Search luôn cập nhật để hưởng lợi từ các bản vá hiệu năng.

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

Q: What are the prerequisites for using GroupDocs.Search in Java?
A: Bạn cần 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: How do I install GroupDocs.Search via Maven?
A: Thêm repository và dependency được hiển thị trong phần Cài đặt Maven vào file pom.xml của bạn.

Q: Can I modify attributes after documents are indexed?
A: Có, sử dụng AttributeChangeBatch để cập nhật hàng loạt các thuộc tính tài liệu mà không cần lập chỉ mục lại.

Q: What if my indexing process is slow?
A: Tối ưu cài đặt bộ nhớ JVM, sử dụng cập nhật hàng loạt, và đảm bảo bạn đang dùng phiên bản thư viện mới nhất.

Q: Where can I find more resources on GroupDocs.Search for Java?
A: Tham khảo official documentation hoặc tham gia các diễn đàn cộng đồng.

Tài nguyên


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