如何使用 GroupDocs.Search for Java 索引文档

在当今数据驱动的世界中，如何索引文档 是任何处理大量文件的 Java 开发者的关键技能。无论您在处理法律合同、财务报表还是内部报告，能够快速定位所需信息都能节省数小时的人工工作。在本教程中，您将学习使用 GroupDocs.Search 库 如何索引文档，并对创建的索引执行基于文本和基于对象的查询。让我们开始吧！

快速答案

索引文档的第一步是什么？ 初始化一个指向存放索引的文件夹的 Index 对象。
哪个方法向索引添加文档？ 使用 index.add("PATH_TO_DOCUMENTS")。
我可以搜索数值范围吗？ 可以，使用类似 "400 ~~ 4000" 的文本查询或通过 SearchQuery.createNumericRangeQuery 的对象查询。
我需要许可证吗？ 有免费试用版；商业许可证可解锁全部功能。
需要哪个 Java 版本？ JDK 8 或更高。

什么是使用 GroupDocs.Search 进行文档索引？

文档索引是指扫描文件夹中文件的内容，并将可搜索的标记存储在专用的索引文件夹中。此预处理步骤使后续的查找速度极快，因为库搜索的是已准备好的索引，而不是每次都读取原始文件。

为什么使用 GroupDocs.Search for Java？

性能： 即使在成千上万的文件上，搜索也能在毫秒级完成。
格式支持： 处理 PDF、Word、Excel、PowerPoint 等多种格式。
灵活性： 支持纯文本查询、数值范围以及复杂的对象查询。
可扩展性： 通过添加新文档即可轻松更新索引，无需从头重建。

前置条件

已安装 Maven 用于依赖管理。
使用 IntelliJ IDEA 或 Eclipse 等 IDE。
基础 Java 知识（面向对象概念、异常处理）。

设置 GroupDocs.Search for Java

Maven 设置

在您的 pom.xml 中添加仓库和依赖：

<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 下载最新的 JAR。

获取许可证的步骤

免费试用 – 免费探索该库。
临时许可证 – 请求短期密钥以进行更长时间的评估。
购买 – 获取用于生产的完整许可证。

基本初始化和设置

要 向索引添加文档，首先创建一个指向存放索引文件的文件夹的 Index 对象：

import com.groupdocs.search.Index;

// Initialize the index by specifying a directory path
Index index = new Index("YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\NumericRangeSearch");

此行创建（或打开）一个准备接收文档的索引。

实施指南

创建和索引文档

如何向索引添加文档

add 方法扫描文件夹并为每个文件存储可搜索的数据。

import com.groupdocs.search.Index;

// Initialize an index at the specified path
Index index = new Index("YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\NumericRangeSearch");

// Add documents from a directory for indexing
index.add("YOUR_DOCUMENT_DIRECTORY");

参数： 路径字符串指向包含您想要索引的文件的文件夹。
目的： 此步骤完成后，索引包含所有受支持文档类型的标记，从而实现快速搜索。

文本查询搜索

如何执行基于文本的数值范围搜索

您可以使用定义范围的简单字符串进行搜索。

import com.groupdocs.search.*;
import com.groupdocs.search.results.*;

// Define a query for numeric values within a specific range
String query1 = "400 ~~ 4000";

// Execute text-based search on indexed data
SearchResult result1 = index.search(query1);

参数： 查询字符串 "400 ~~ 4000" 告诉引擎查找介于 400 到 4000 之间的数字。
返回值： SearchResult 包含匹配文档的列表及高亮信息。

对象查询搜索

如何使用对象查询进行数值范围搜索

基于对象的查询为您提供对搜索条件的编程控制。

import com.groupdocs.search.*;
import com.groupdocs.search.results.*;

// Create a numeric range query object
SearchQuery query2 = SearchQuery.createNumericRangeQuery(400, 4000);

// Perform search using the query object
SearchResult result2 = index.search(query2);

参数： createNumericRangeQuery 接收起始和结束整数。
目的： 当您需要组合多个条件或动态构建查询时，此方法非常适用。

实际应用

以下是一些实际场景，在这些场景中 如何索引文档 能带来颠覆性改变：

法律文档管理 – 在成千上万的合同中定位条款、案件编号或日期。
财务报告 – 提取落在特定金额范围内的交易。
库存跟踪 – 通过序列号、批次码或 SKU 范围查找项目。

将 GroupDocs.Search 与数据库、云存储或消息队列集成，可进一步自动化文档工作流。

性能考虑

定期更新索引： 对新文件重新运行 index.add 以保持索引最新。
资源管理： 监控堆使用情况；大型索引受益于调优的 JVM 垃圾回收设置。
查询优化： 对复杂过滤使用对象查询，以减少不必要的扫描。

常见问题及解决方案

问题	原因	解决方案
搜索未返回结果	索引未构建或文件夹路径不正确	确认已在正确的目录上执行 `index.add`，且索引文件夹可写。
索引期间出现 OutOfMemoryError	文件过大或堆内存不足	增加 JVM `-Xmx` 参数值或将文件分批索引。
不受支持的文件格式	文件类型未被 GroupDocs.Search 识别	确保文件扩展名在支持列表中（PDF、DOCX、XLSX 等）。

常见问答

问：如何使用新文档更新已有索引？
答：再次调用 index.add("NEW_DOCUMENT_PATH")；库会合并新条目，而无需重新创建整个索引。

问：GroupDocs.Search 能处理不同的文件格式吗？
答：可以，它支持 PDF、Word、Excel、PowerPoint、纯文本以及许多其他常见格式。

问：使用 GroupDocs.Search 的系统要求是什么？
答：Java 8+ 运行时，足够的内存（中等规模集合至少 2 GB），以及对索引文件夹的读写权限。

问：如何排查搜索性能问题？
答：确保索引是最新的，对查询进行分析，并检查 JVM 内存设置。减少索引的字段数量也能提升速度。

问：是否可以使用同义词或模糊匹配进行搜索？
答：可以，GroupDocs.Search 提供同义词词典和模糊搜索选项，可通过 SearchOptions 类启用。

结论

您现在已经对使用 GroupDocs.Search for Java 如何索引文档、如何 向索引添加文档 以及如何运行基于文本和基于对象的查询有了扎实的了解。通过整合这些技术，您的 Java 应用程序将在任何文档库中提供快速、准确的搜索体验。

准备好下一步了吗？探索分面搜索、同义词处理，或将索引与 REST API 集成，以向其他服务提供搜索功能。

最后更新： 2026-02-06
测试环境： GroupDocs.Search 25.4 for Java
作者： GroupDocs