提升查詢效能與 GroupDocs.Search Java：最佳化索引與搜尋

有效管理大量文件集合的關鍵在於提升查詢效能。在本教學中，您將學習如何建立與設定高效能索引、將文件加入索引，以及正確轉義特殊字元查詢，讓搜尋快速且返回精確結果。無論是建構企業知識庫或可搜尋的電商目錄，掌握這些步驟都能讓您的應用程式在高負載下保持回應。

快速解答

• 主要目標是什麼？ 透過微調索引與查詢處理來提升查詢效能。
• 使用哪個函式庫？ GroupDocs.Search for Java。
• 需要授權嗎？ 開發階段使用免費試用或暫時授權即可；正式上線需購買正式授權。
• 如何加入文件？ 使用 index.add("YOUR_DOCUMENT_DIRECTORY") 進行批次載入。
• 特殊字元如何處理？ 在執行搜尋前設定字母字典並轉義 ()":&|!^~*? 等字元。

何謂「提升查詢效能」

提升查詢效能是指縮短搜尋請求在索引中 traversing、匹配詞彙並返回結果所需的時間。透過正確設定索引並準備與之相符的查詢，可消除不必要的處理，達成更快的回應時間。

為何使用 GroupDocs.Search Java 進行高效能搜尋？

GroupDocs.Search 能在標準伺服器上，對包含多達 1000 萬文件的索引於 50 毫秒內處理查詢，實現規模化的提升搜尋速度。此函式庫亦內建支援 30 多種字母表的分析器，並自動處理特殊字元，確保結果可靠，無需額外前置處理。

前置條件

在深入之前，請確保已準備好以下項目：

必要的函式庫與相依性

To use GroupDocs.Search in a Maven project, include the following configurations:

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

環境設定

• 已安裝並設定 JDK 8 或更新版本。
• 使用 IntelliJ IDEA 或 Eclipse 等 IDE。

知識前置條件

• 基本的 Java 程式設計。
• 熟悉 Maven。
• 了解文件管理概念。

設定 GroupDocs.Search for Java

1. 透過 Maven 或直接下載安裝

將上述 XML 片段加入您的 pom.xml。若偏好手動方式，請從官方網站下載函式庫：

GroupDocs.Search for Java 版本

2. 取得授權

您可以在此取得免費試用或暫時授權：

GroupDocs 授權頁面

3. 基本初始化

Index 是 GroupDocs.Search 的核心物件，代表儲存在磁碟上的可搜尋文件集合。建立指向索引檔案儲存資料夾的 Index 物件：

import com.groupdocs.search.*;

public class SearchInitialization {
    public static void main(String[] args) {
        Index index = new Index("YOUR_DOCUMENT_DIRECTORY/output/AdvancedUsage");
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

實作指南

建立與設定索引

設定字母字典可讓您決定特殊字元的處理方式，這對提升查詢效能至關重要。

步驟 1：初始化索引

Index index = new Index("YOUR_DOCUMENT_DIRECTORY/output/AdvancedUsage");

步驟 2：設定字元類型

index.getDictionaries().getAlphabet()
    .setRange(new char[] {'&'}, CharacterType.Letter)
    .setRange(new char[] {'-'}, CharacterType.Separator);

將 & 視為字母、- 視為分隔符，可確保搜尋引擎依照您的預期解析查詢。

索引文件

現在讓我們將文件加入索引，使其可被搜尋。

步驟 3：加入文件

index.add("YOUR_DOCUMENT_DIRECTORY");

此方法會遞迴掃描指定資料夾，索引所有支援的檔案類型，讓您能在一次呼叫中批次載入文件。

準備搜尋查詢

為了轉義特殊字元查詢，我們首先根據字母表設定正規化輸入，然後加入轉義序列。

步驟 4：修改特殊字元

StringBuilder result = new StringBuilder();
String word = "rock&roll-music";

for (int i = 0; i < word.length(); i++) {
    char character = word.charAt(i);
    CharacterType characterType = index.getDictionaries().getAlphabet().getCharacterType(character);

    if (characterType == CharacterType.Separator) {
        result.append(' ');
    } else {
        result.append(character);
    }
}

步驟 5：轉義特殊字元

String specialCharacters = "()\":&|!^~*?";
for (int i = result.length() - 1; i >= 0; i--) {
    char c = result.charAt(i);
    if (specialCharacters.indexOf(c) != -1) {
        result.insert(i, '\\');
    }
}
String query = result.toString();
if (query.contains(" ")) {
    query = "\"" + query + "\"";
}

轉義可防止解析器將符號誤認為運算子。

執行搜尋

SearchResult 包含查詢返回的匹配文件列表、摘要與相關性分數。最後，對已準備好的索引執行查詢。

步驟 6：執行搜尋

import com.groupdocs.search.results.*;

SearchResult searchResult = index.search(query);

search 方法返回包含匹配文件、摘要與相關性分數的 SearchResult 物件。

實務應用

案例研究 1：文件管理系統

律師事務所可透過索引 PDF、Word 文件與電子郵件快速定位案件檔案。藉由提升查詢效能，律師減少等待結果的時間，將更多時間投入內容審閱。

案例研究 2：電子商務平台

線上零售商會索引商品說明、規格與評論。正確轉義的查詢讓顧客能搜尋如 4‑K TV 等片語而不產生錯誤，且快速的查詢執行確保購物體驗流暢。

效能考量與技巧

• 在大量匯入或大型更新後重新整理索引，以保持搜尋延遲低。
• 為大型資料集配置足夠的堆記憶體（-Xmx2g 或更高）。
• 在多次搜尋間重複使用 Index 實例，避免每次重新建立。
• 使用 Java 內建工具分析查詢執行，找出效能瓶頸。

常見陷阱與解決方案

常見問答

Q: 如何使用 GroupDocs.Search 處理極大型資料集？
A: 使用增量索引 (index.add) 並排程定期索引最佳化。將索引部署於 SSD 儲存裝置以提升 I/O 效能。

Q: GroupDocs.Search 能與 Spring Boot 整合嗎？
A: 可以。於 @Configuration 類別中定義 Index Bean，並在需要搜尋功能的地方注入使用。

Q: 查詢中必須轉義哪些字元？
A: 必須在字元 ()":&|!^~*? 前加上反斜線 (\) 才能視為字面值。

Q: 如何使用新上傳的文件更新既有索引？
A: 呼叫 index.add("NEW_DOCUMENT_DIRECTORY")；函式庫會合併新條目而不需重新建構整個索引。

Q: GroupDocs.Search 適用於即時搜尋情境嗎？
A: 絕對適用。函式庫支援快速增量更新與低延遲查詢，適合即時搜尋框使用。

資源

• 文件說明
• API 參考文件

最後更新： 2026-05-07
測試版本： GroupDocs.Search Java 25.4
作者： GroupDocs

相關教學

• 在 GroupDocs.Search Java 中加入文件至索引並停用停用詞以提升搜尋精準度
• 將文件加入索引 – GroupDocs.Search Java 教學
• 如何將文件加入索引並管理別名於 GroupDocs.Search for Java