使用 GroupDocs.Search Java 建立字元取代陣列：完整指南

在本教學中，你將 create character replacement array 以在索引期間正規化文字，並了解如何使用 GroupDocs.Search 執行 case sensitive search java 查詢。無論是清理不一致的資料、標準化舊有文件，或僅是提升搜尋相關性，這些功能都讓你在不重新編寫原始檔案的情況下微調索引流程。

快速解答

What does a character replacement array do? 它在索引前將原始字元映射為取代字元，確保斷詞一致。
Do I need a license to try this? 免費試用或臨時授權即可用於開發與測試。
Can I replace multiple characters at once? 是的——你可以在陣列中加入所有需要的 Unicode 字元映射。
Is case‑sensitive search supported? 當然；在 SearchOptions 中啟用 setUseCaseSensitiveSearch(true)。
Where are the replacement rules stored? 可匯出或匯入 .dat 檔案，以便在不同專案間重複使用。

介紹

字元取代是任何必須處理雜訊或異質文字的搜尋解決方案的重要功能。透過設定 GroupDocs.Search Java 以 create character replacement array，可確保連字符、底線或特定語系符號等字元被統一處理，從而大幅提升匹配品質。此外，結合 case sensitive search java 設定，讓你在需要時區分 “Apple” 與 “apple”。

前置條件

Libraries and Dependencies: GroupDocs.Search Java 函式庫版本 25.4 或更新版本。
Environment: Java 8 以上，使用 Maven 管理相依性。
Knowledge Base: 基本的 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 下載最新版本。

取得授權

先以免費試用或申請臨時授權來探索 GroupDocs.Search 的完整功能。長期使用時，建議購買訂閱方案。

基本初始化與設定

import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;

// Define the folder where your index will be stored
String indexFolder = "YOUR_OUTPUT_DIRECTORY/CharacterReplacements/Index";

// Initialize IndexSettings and set up character replacements
IndexSettings settings = new IndexSettings();
settings.setUseCharacterReplacements(true);

// Create an index with specified settings
Index index = new Index(indexFolder, settings);

如何建立字元取代陣列

啟用字元取代於索引設定中僅是第一步。以下將說明如何清除現有映射、加入自訂配對，最終建立完整的陣列，將每個字元取代為其小寫等價字元。

在索引設定中啟用字元取代

清除現有取代規則

if (index.getDictionaries().getCharacterReplacements().getCount() > 0) {
    index.getDictionaries().getCharacterReplacements().clear();
}

新增字元取代

index.getDictionaries().getCharacterReplacements().addRange(
    new CharacterReplacementPair[] { new CharacterReplacementPair('-', '~') }
);

建立新的字元取代

初始化取代陣列

CharacterReplacementPair[] characterReplacements = new CharacterReplacementPair[Character.MAX_VALUE + 1];
for (int i = 0; i < characterReplacements.length; i++) {
    char originalChar = (char)i;
    char replacementChar = Character.toLowerCase(originalChar);
    characterReplacements[i] = new CharacterReplacementPair(originalChar, replacementChar);
}

將取代項目加入字典

index.getDictionaries().getCharacterReplacements().addRange(characterReplacements);

匯出與匯入字元取代

匯出字元取代

String fileName = "YOUR_OUTPUT_DIRECTORY/CharacterReplacements/CharacterReplacements.dat";
index.getDictionaries().getCharacterReplacements().exportDictionary(fileName);

匯入字元取代

index.getDictionaries().getCharacterReplacements().importDictionary(fileName);

新增文件與執行 case sensitive search java

新增文件至索引

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";
index.add(documentsFolder);

執行 case sensitive search java

String query = "Elliot";
SearchOptions options = new SearchOptions();
options.setUseCaseSensitiveSearch(true);
SearchResult result = index.search(query, options);

實務應用

Data Standardization: 在索引前統一取代標點或特定語系符號。
Error Correction: 自動修正常見的排版錯誤（例如 “‑” → “~”）。
Localization: 調整不同語言的字元集，無需更改原始檔案。
Historical Data Analysis: 正規化使用過時字元慣例的舊有文件。
System Integration: 透過在各管道中套用相同的取代規則，保持 CRM/ERP 資料的一致性。

效能考量

Optimize Index Size: 定期修剪過時條目，以維持索引精簡。
Resource Management: 調整 JVM 垃圾回收並在大量索引時監控堆積使用情況。
Batch Processing: 批次索引文件，以減少 I/O 負擔並提升吞吐量。

結論

學會 create character replacement array 並結合 case sensitive search java 設定後，你即可大幅提升搜尋解決方案的相關性與可靠性。嘗試不同的映射、匯出以供重複使用，並探索諸如同義詞等額外字典，獲得更豐富的搜尋體驗。

下一步

在樣本資料集上測試各種取代策略，以觀察其對命中率的影響。
深入了解其他 GroupDocs.Search 功能，如同義詞字典、詞幹分析與模糊搜尋。

常見問題

Q: 使用字元取代於索引的主要好處是什麼？
A: 它標準化文字輸入，提升搜尋準確度與跨多樣文件的一致性。

Q: 我可以一次取代多個字元嗎？
A: 可以，你可以在取代陣列中加入任意多個 CharacterReplacementPair 物件。

Q: 能否在不同專案之間匯出與匯入取代規則？
A: 當然可以。使用 exportDictionary 與 importDictionary 方法共享映射。

Q: 設定字元取代時常見的陷阱是什麼？
A: 在新增新規則前忘記清除現有取代，或索引設定不匹配（如未設定 setUseCharacterReplacements(true)）都可能導致意外結果。

資源

遵循本指南後，你將能夠在 Java 應用程式中實作字元取代並微調搜尋行為。

最後更新： 2026-03-25
測試環境： GroupDocs.Search Java 25.4
作者： GroupDocs