新增文件至索引 – 精通 Java 中的通配符搜尋與 GroupDocs.Search

利用 GroupDocs.Search for Java 解鎖文字型與物件型通配符搜尋的威力。本指南將教您如何 add documents to index、設定進階模式，並保持搜尋索引最佳化以獲得快速結果。

快速解答

What does “add documents to index” mean? 它會建立一個可搜尋的資料結構，讓 GroupDocs.Search 能有效查詢。
Which keyword boosts performance? 使用簡潔的通配符模式，並定期執行 optimize search index 操作。
Do I need special memory settings? 是的——監控 java search memory management 以避免在大型資料集上發生記憶體不足錯誤。
Can I use these features in a Spring Boot app? 當然可以；只需加入 Maven 相依性並設定索引資料夾。
Is a license required for production? 商業部署需要有效的 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）。

設定 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>

直接下載

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

取得授權

Free Trial: 免費試用核心功能。
Temporary License: 在評估期間啟用進階功能。
Purchase: 取得商業授權以供正式環境使用。

實作指南

功能 1：文字型通配符搜尋

步驟 1 – 設定索引並 add documents to index

首先，建立索引資料夾並 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'

說明

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'

說明

WordPattern 讓您一步一步組合搜尋模式。
appendOneCharacterWildcard() 新增 ? 佔位符。
appendWildcard(min, max) 新增基於範圍的通配符（?(min~max)）。

實務應用

Document Management: 當僅知道詞彙的一部分時，快速定位檔案。
Content Retrieval Engines: 為 CMS 平台的搜尋欄提供彈性匹配功能。
Data Mining: 從大型語料庫中提取符合模式的資料，無需完整文字掃描。

效能考量

最佳化搜尋索引

Regular Re‑indexing: 大量更新後，重新建構索引以維持查詢時間低。
Compact Storage: 使用 index.optimize()（若支援）壓縮索引大小。

Java 搜尋記憶體管理

Heap Size: 為大型文件集合分配足夠的堆積記憶體（-Xmx2g 或更高）。
Streaming Indexing: 以批次方式處理檔案，避免一次載入全部至記憶體。

一般最佳實踐

盡可能使用具體的通配符模式；過於寬泛的模式會增加 CPU 負載。
若在大量搜尋工作負載時出現延遲峰值，請監控 GC 暫停情況。

結論

透過學習如何 add documents to index 以及運用文字型與物件型通配符查詢，您可以大幅提升任何 Java 應用程式的搜尋體驗。請記得定期 optimize search index，並聰明地管理記憶體以確保可擴充的效能。嘗試不同的模式，將程式碼整合至您的服務中，立即享受快速且彈性的搜尋結果！

常見問題

Q1: What is a wildcard search?
A: 通配符搜尋允許您使用 ?（單一字元）或 *（多字元）等佔位符來匹配單詞或片語。

Q2: How do I install GroupDocs.Search for Java?
A: 使用上述的 Maven 儲存庫與相依性，或直接從官方發布頁面下載 JAR。

Q3: Can wildcard searches handle large datasets?
A: 可以，但您應該 optimize search index 並監控 java search memory management 以維持效能。

Q4: What are common pitfalls?
A: 索引路徑錯誤、使用過於寬泛的通配符，以及忽略記憶體設定，都可能導致搜尋緩慢或記憶體不足錯誤。

Q5: Where can I find more resources?
A: 前往 GroupDocs documentation 取得詳細指南與 API 參考。

資源

Documentation: GroupDocs Search Documentation
API Reference: GroupDocs Search API Reference
Download: GroupDocs.Search Downloads
GitHub: GroupDocs.Search on GitHub
Free Support: GroupDocs Forum
Temporary License: Obtain a Temporary License

最後更新: 2026-03-23
測試環境: GroupDocs.Search 25.4 for Java
作者: GroupDocs