Search by Attribute Java 与 GroupDocs.Search 指南

您是否希望通过使用 Java 动态修改和索引文档属性来提升文档管理系统？您来对地方了！本教程深入探讨如何利用强大的 GroupDocs.Search for Java 库实现 search by attribute java、更改已索引文档的属性，以及在索引过程中添加属性。无论您是在构建搜索解决方案还是优化文档工作流，掌握这些技术都是关键。

快速答案

  • “search by attribute java” 是什么？ 这是一种使用附加到每个文档的自定义元数据来过滤搜索结果的能力。
  • 可以在索引后修改属性吗？ 可以——使用 AttributeChangeBatch 批量更新文档属性。
  • 如何在索引时添加属性？ 订阅 FileIndexing 事件并以编程方式设置属性。
  • 需要许可证吗？ 免费试用可用于评估；生产环境需要正式许可证。
  • 需要哪个 Java 版本？ 推荐使用 Java 8 或更高版本。

什么是 “search by attribute java”？

search by attribute java 让您能够基于文档的元数据（属性）而非仅内容进行查询。通过为每个文件附加 public、main 或 key 等键值对，您可以快速将结果缩小到最相关的子集。

为什么要修改或添加属性？

  • 动态分类 – 让元数据与业务规则保持同步。
  • 更快的过滤 – 属性过滤在全文搜索之前评估，提升性能。
  • 合规性追踪 – 为保留策略或审计需求标记文档。

前置条件

  • Java 8+（JDK 8 或更高）
  • GroupDocs.Search for Java 库（请参见下方 Maven 配置）
  • 对 Java 和索引概念的基本了解

设置 GroupDocs.Search for Java

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>

直接下载

或者，从 GroupDocs.Search for Java releases 下载最新版本。
如果您不想使用 Maven 等构建工具，可从 GroupDocs 网站 下载 JAR 包。

许可证获取

  • 先使用免费试用版探索功能。
  • 如需长期使用，可通过 license page 获取临时或正式许可证。

基本初始化

import com.groupdocs.search.Index;

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

实现指南

Search by Attribute Java – 更改文档属性

概述

您可以在已索引文档上添加、删除或替换属性，从而实现 batch update document attributes，无需重新索引整个集合。

步骤说明

步骤 1：将文档添加到索引

index.add("YOUR_DOCUMENT_DIRECTORY");

步骤 2：检索已索引文档信息

import com.groupdocs.search.results.DocumentInfo;

DocumentInfo[] documents = index.getIndexedDocuments();

步骤 3：批量更新文档属性

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

步骤 4：使用属性过滤进行搜索

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

使用 AttributeChangeBatch 批量更新文档属性

AttributeChangeBatch 类是实现 batch update document attributes 的核心工具。将更改聚合到单个批次，可降低 I/O 开销并保持索引一致性。

Search by Attribute Java – 索引期间添加属性

概述

通过挂钩 FileIndexing 事件，在每个文件加入索引时分配自定义属性。

步骤说明

步骤 1：订阅 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" });
        }
    }
});

步骤 2：索引文档

index.add("YOUR_DOCUMENT_DIRECTORY");

实际应用

  1. 文档管理系统 – 在摄取过程中自动添加元数据，实现自动分类。
  2. 大型内容档案 – 使用属性过滤缩小搜索范围，显著降低响应时间。
  3. 合规与报告 – 动态为文档打标签，以满足保留计划或审计追踪需求。

性考量

  • 内存管理 – 监控 JVM 堆并根据需要调优 -Xmx。
  • 批处理 – 使用 AttributeChangeBatch 对属性更改进行分组，以最小化索引写入。
  • 库更新 – 保持 GroupDocs.Search 为最新版本，以获取性能补丁。

常见问题

Q: 使用 GroupDocs.Search for Java 的前置条件是什么？
A: 您需要 Java 8+、GroupDocs.Search 库以及对索引概念的基本了解。

Q: 如何通过 Maven 安装 GroupDocs.Search？
A: 将 Maven 设置章节中展示的仓库和依赖添加到 pom.xml 中。

Q: 索引后可以修改属性吗？
A: 可以，使用 AttributeChangeBatch 批量更新文档属性，无需重新索引。

Q: 如果我的索引过程很慢怎么办？
A: 优化 JVM 内存设置，使用批量更新，并确保使用最新的库版本。

Q: 哪里可以找到更多关于 GroupDocs.Search for Java 的资源？
A: 访问 official documentation 或浏览社区论坛。

资源

最后更新： 2025-12-24
测试环境： GroupDocs.Search 25.4 for Java
作者： GroupDocs