将文档添加到索引 – 掌握 Java 中使用 GroupDocs.Search 的通配符搜索

利用 GroupDocs.Search for Java 解锁基于文本和基于对象的通配符搜索的强大功能。在本指南中，您将学习如何将文档添加到索引、配置高级模式，并保持搜索索引的优化以获得快速结果。

快速答案

“add documents to index” 是什么意思？ 它创建了一个可搜索的数据结构，GroupDocs.Search 可以高效查询。
哪个关键字提升性能？ 使用简洁的通配符模式并定期优化搜索索引操作。
我需要特殊的内存设置吗？ 是的——监控java search memory management以避免在大型数据集上出现内存不足错误。
我可以在 Spring Boot 应用中使用这些功能吗？ 当然；只需包含 Maven 依赖并配置索引文件夹。
生产环境需要许可证吗？ 商业部署需要有效的 GroupDocs.Search 许可证。

什么是 GroupDocs.Search 中的 “add documents to index”？

将文档添加到索引意味着将您的源文件（PDF、DOCX、TXT 等）导入到 GroupDocs.Search 在后台构建的可搜索仓库中。索引完成后，您可以快速执行通配符查询，而无需每次扫描原始文件。

为什么在 GroupDocs.Search 中使用通配符搜索？

通配符搜索允许匹配部分单词或模式——非常适合用户只记得词语片段的场景。这种灵活性提升了文档管理系统、内容门户和数据挖掘工具中的用户体验。

前置条件

Java Development Kit (JDK) – 版本 8 或更高。
基本的 Java 编程知识。
如 IntelliJ IDEA 或 Eclipse 等 IDE。
用于依赖管理的 Maven（或您也可以直接下载 JAR）。

为 Java 设置 GroupDocs.Search

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>

直接下载

如果您不想使用 Maven，可从 GroupDocs.Search for Java releases 下载最新的 JAR。

许可证获取

免费试用： 免费探索核心功能。
临时许可证： 在评估期间激活高级功能。
购买： 获取用于生产的商业许可证。

实施指南

功能 1：基于文本的通配符搜索

步骤 1 – 设置索引并add documents to index

首先，创建索引文件夹并添加您的源文档：

String indexFolder = "YOUR_OUTPUT_DIRECTORY\\AdvancedUsage\\Searching\\WildcardSearch\\QueryInTextForm";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";

Index index = new Index(indexFolder);
index.add(documentsFolder);

步骤 2 – 执行通配符查询

直接在文本上运行基于模式的搜索：

// Search for words matching 'm???is'
String query1 = "m???is";
SearchResult result1 = index.search(query1); // Finds words like 'mauris', 'mollis'

// Search for words matching 'pri?(1~7)'
String query2 = "pri?(1~7)";
SearchResult result2 = index.search(query2); // Finds words like 'private', 'principles'

Explanation

indexFolder 在磁盘上存储可搜索的索引。
documentsFolder 指向您想要add documents to index的文件位置。
search() 执行通配符查询并返回匹配结果。

功能 2：基于对象的通配符搜索

步骤 1 – 设置索引（同上）

String indexFolder = "YOUR_OUTPUT_DIRECTORY\\AdvancedUsage\\Searching\\WildcardSearch\\QueryInObjectForm";
Index index = new Index(indexFolder);
index.add(documentsFolder);

步骤 2 – 为复杂查询构建 `WordPattern`

基于对象的搜索让您对每个模式元素进行细粒度控制：

// Create a WordPattern for 'm???is'
WordPattern pattern1 = new WordPattern();
pattern1.appendString("m");
pattern1.appendOneCharacterWildcard();
pattern1.appendOneCharacterWildcard();
pattern1.appendOneCharacterWildcard();
pattern1.appendString("is");

SearchQuery query1 = SearchQuery.createWordPatternQuery(pattern1);
SearchResult result1 = index.search(query1); // Finds words like 'mauris', 'mollis'

// Create a WordPattern for 'pri?(1~7)'
WordPattern pattern2 = new WordPattern();
pattern2.appendString("pri");
pattern2.appendWildcard(1, 7);

SearchQuery query2 = SearchQuery.createWordPatternQuery(pattern2);
SearchResult result2 = index.search(query2); // Finds words like 'private', 'principles'

Explanation

WordPattern 让您一步步组装搜索模式。
appendOneCharacterWildcard() 添加一个 ? 占位符。
appendWildcard(min, max) 添加基于范围的通配符（?(min~max)）。

实际应用

文档管理： 当仅知道词语的一部分时快速定位文件。
内容检索引擎： 为 CMS 平台的搜索栏提供灵活匹配功能。
数据挖掘： 从大型语料库中提取模式化数据，无需全文扫描。

性能考虑

优化搜索索引

定期重新索引： 大批量更新后，重建索引以保持查询时间低。
紧凑存储： 使用 index.optimize()（如果可用）来缩小索引大小。

Java 搜索内存管理

堆大小： 为大型文档集分配足够的堆（-Xmx2g 或更高）。
流式索引： 分批处理文件，以避免一次性将所有内容加载到内存中。

通用最佳实践

尽可能使通配符模式具体；过于宽泛的模式会增加 CPU 负载。
如果在高负载搜索期间注意到延迟峰值，请监控 GC 暂停。

结论

通过学习如何add documents to index并利用基于文本和基于对象的通配符查询，您可以显著提升任何 Java 应用的搜索体验。请记住定期optimize search index并明智地管理内存，以实现可扩展的性能。尝试不同的模式，将代码集成到您的服务中，今天即可享受快速、灵活的搜索结果！

常见问题

Q1: 什么是通配符搜索？
A: 通配符搜索允许您使用占位符（如 ?（单字符）或 *（多字符））匹配单词或短语。

Q2: 如何安装 GroupDocs.Search for Java？
A: 使用上面显示的仓库和依赖通过 Maven 安装，或直接从官方发布页面下载 JAR。

Q3: 通配符搜索能处理大数据集吗？
A: 可以，但您应optimize search index并监控java search memory management以保持性能。

Q4: 常见的陷阱有哪些？
A: 索引路径错误、使用过于通用的通配符以及忽视内存配置都可能导致搜索缓慢或内存不足错误。

Q5: 我在哪里可以找到更多资源？
A: 访问 GroupDocs documentation 获取详细指南和 API 参考。

资源

文档： GroupDocs Search Documentation
API 参考： GroupDocs Search API Reference
下载： GroupDocs.Search Downloads
GitHub： GroupDocs.Search on GitHub
免费支持： GroupDocs Forum
临时许可证： Obtain a Temporary License

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