使用 GroupDocs.Search for Java 建立搜尋索引 GroupDocs - 完整指南

如果您需要在 Java 應用程式中 create search index groupdocs，您來對地方了。在本教學中，我們將逐步說明設定 GroupDocs.Search、建立索引、加入檔案以及擷取文件文字的完整流程——所有程式碼皆可直接複製到您的專案中。完成後，您將清楚了解 how to index documents java 的作法，並能將強大的搜尋功能整合至任何企業解決方案。

快速解答

GroupDocs.Search 的主要目的為何？
提供快速、全文索引與檢索，支援 Java 中各種文件格式。
建議使用哪個版本的函式庫？
最新的穩定版（例如撰寫時的 25.4 版）。
執行範例是否需要授權？
可取得臨時授權以進行評估；正式上線則需商業授權。
建立搜尋索引的主要步驟是什麼？
安裝函式庫、設定索引參數、加入文件，最後查詢索引。
可以將索引文字以壓縮形式儲存嗎？
可以 — 使用 TextStorageSettings 搭配 Compression.High。

如何使用 GroupDocs.Search for Java 建立搜尋索引 groupdocs

建立可搜尋的索引是任何快速查詢解決方案的基礎。以下我們將把流程拆解為可執行的步驟，說明每個動作背後的「為什麼」，並提供您所需的完整程式碼。

什麼是「create search index groupdocs」？

使用 GroupDocs 建立搜尋索引即是構建一個可搜尋的資料結構，將文件中每個詞彙映射到其所在位置。這樣即可即時關鍵字查詢、片語搜尋與進階篩選，而無需每次都掃描原始檔案。

為什麼使用 GroupDocs.Search for Java？

廣泛的格式支援 – PDF、Word、Excel、PowerPoint 等多種檔案。
高效能 – 經過最佳化的索引演算法，即使處理百萬檔案亦能保持低搜尋延遲。
易於整合 – 簡潔的 Java API、基於 Maven 的相依管理，以及清晰的文件說明。

前置條件

必要的函式庫與相依性

Java Development Kit (JDK) 8 或以上。
Maven 用於相依管理。

環境設定需求

確保 Maven 已正確設定，可從 GroupDocs 儲存庫下載套件。

知識前置需求

具備基本的 Java 程式設計、檔案 I/O 操作經驗，以及對索引概念的了解，將有助於順利跟隨本教學。

設定 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 下載最新版本。

取得授權

您可前往 Temporary License page 取得臨時授權，於購買前完整體驗 GroupDocs 功能。此試用期讓您能在自己的環境中評估此函式庫。

基本初始化與設定

首先建立指向索引檔案儲存資料夾的 Index 物件：

String indexFolder = "YOUR_INDEX_DIRECTORY";
Index index = new Index(indexFolder);

實作指南

如何使用 GroupDocs.Search 索引 Java 文件

概觀

建立索引是啟用快速搜尋功能的第一步。以下我們將逐項說明每個必要的動作。

步驟 1：指定目錄

定義索引儲存位置以及來源文件所在的資料夾。

String indexFolder = "YOUR_INDEX_DIRECTORY";
String documentsFolder = "YOUR_DOCUMENTS_DIRECTORY";

步驟 2：建立索引

實例化 Index 物件，開始構建可搜尋的結構。

Index index = new Index(indexFolder);

步驟 3：將文件加入索引

一次呼叫即可將來源資料夾內的所有檔案加入索引。

index.add(documentsFolder);

步驟 4：取得已索引的文件

索引完成後，您可以列舉已索引的項目：

DocumentInfo[] documents = index.getIndexedDocuments();
for (DocumentInfo document : documents) {
    String filePath = document.getFilePath();
    // Process each file path or perform further actions here
}

參數與方法目的

indexFolder：儲存索引資料的路徑。
documentsFolder：包含待索引檔案的資料夾。

故障排除提示

確認資料夾路徑正確且可存取。
若在索引時遇到「access denied」錯誤，請檢查檔案系統權限。

使用文字儲存設定建立索引

概觀

您可以微調每份文件原始文字的儲存方式，例如啟用高壓縮以減少磁碟使用量。

步驟 1：設定索引參數

建立 IndexSettings 實例並設定文字儲存。

IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));

步驟 2：使用設定初始化索引

在建構索引時傳入自訂設定。

Index index = new Index(indexFolder, settings);

步驟 3：擷取並儲存文件文字

擷取文件的完整文字，並以 HTML（或其他支援格式）儲存。

DocumentInfo[] documents = index.getIndexedDocuments();
if (documents.length > 0) {
    String outputPath = "YOUR_OUTPUT_DIRECTORY/Text.html";
    FileOutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, outputPath);
    index.getDocumentText(documents[0], outputAdapter);
}

關鍵設定選項

Compression.High – 透過壓縮擷取的文字以最佳化儲存空間。

實務應用

企業文件管理 – 在龐大的資料庫中快速定位合約、政策或報告。
內容管理系統 (CMS) – 為全站搜尋提供即時結果。
法律文件處理 – 透過關鍵字搜尋在案件檔案與證據庫中快速發現相關文件。

效能考量

優化索引大小 – 定期清除過時的條目，以維持索引精簡。
記憶體管理 – 為大規模索引作業調整 JVM 的垃圾回收器。
最佳實踐 – 批次建立索引、重複使用 Index 實例，並在大量工作負載時優先使用非同步操作。

常見問題與解決方案

症狀	可能原因	解決方法
呼叫 `index.add()` 時出現 “Access denied”	資料夾權限不正確	授予執行程序使用者讀寫權限
已知關鍵字卻無結果返回	未啟用文字儲存	啟用 `TextStorageSettings` 或以正確設定重新索引
大量批次時發生記憶體不足錯誤	JVM 堆積太小	增加 `-Xmx` 參數或將文件分成較小批次處理

常見問答

GroupDocs.Search for Java 是什麼？
一個強大的函式庫，讓開發者能有效地在 Java 應用程式中加入全文搜尋功能。
如何使用 GroupDocs.Search 處理大型資料集？
使用批次處理並最佳化索引設定，以有效管理資源。
可以自訂文字儲存設定中的壓縮等級嗎？
可以，您可以設定不同的壓縮等級，例如 Compression.High 或 Compression.Low。
GroupDocs.Search 支援哪些類型的文件？
支援多種格式，包括 PDF、Word、Excel、PowerPoint 以及其他許多檔案類型。
GroupDocs.Search 有社群支援嗎？
有，您可透過他們的論壇取得免費支援，網址為 GroupDocs Forum。

資源

文件說明: https://docs.groupdocs.com/search/java/
API 參考: https://reference.groupdocs.com/search/java
下載: https://releases.groupdocs.com/search/java/
GitHub 倉庫: https://github.com/groupdocs-search/GroupDocs.Search-for-Java
免費支援論壇: https://forum.groupdocs.com/c/search/10

透過使用上述資源並嘗試不同設定，您可以進一步提升對 GroupDocs.Search for Java 的了解與運用。祝開發順利！

最後更新： 2026-03-09
測試版本： GroupDocs.Search 25.4
作者： GroupDocs