如何在 Java 中使用 GroupDocs.Search 建立索引指南

在當今以數據為驅動的世界,how to create index 是建立快速、可靠搜尋體驗的基礎步驟。無論您是管理法律合約、客戶記錄,或任何大型文件庫,精心打造的索引都能在毫秒內檢索資訊。在本教學中,您將逐步設定 GroupDocs.Search、建立索引、加入文件,並產生詳細報告——同時關注效能與可擴展性。

快速回答

  • 在 Java 中 create index 的第一步是什麼? 初始化一個指向索引檔案資料夾的 Index 物件。
  • 哪個函式庫提供 Java 文件索引? GroupDocs.Search for Java。
  • 如何將文件加入現有的索引? 呼叫 index.add(path) 以索引每個您想要的資料夾。
  • 什麼工具有助於優化搜尋效能? 結合增量索引與適當的 JVM 記憶體調校。
  • 有沒有 Java 搜尋範例? 下面的操作說明展示了完整的端到端工作流程。

您將學習

  • 使用 GroupDocs.Search create index 的方法
  • 在現有索引中 add documents to index 與 add files to index 的技巧
  • 如何取得並顯示索引報告,以 optimize search performance
  • 真實案例與 java search example 的技巧

前置條件

必要的函式庫與版本

  • GroupDocs.Search for Java:版本 25.4 或更新——支援 50+ 輸入與輸出格式,包括 DOCX、PDF、TXT、HTML 以及多種影像類型。
  • Java Development Kit (JDK):已正確安裝與設定(建議使用 JDK 11+)。

環境設定需求

建議使用 IntelliJ IDEA、Eclipse 或 NetBeans 等 IDE 來執行程式碼片段。

知識前置條件

基本的 Java 概念(類別、方法、檔案處理)以及對 Maven 的熟悉度,將有助於您順利跟隨本教學。

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

取得授權步驟

  1. 免費試用 – 註冊免費試用以探索 GroupDocs 功能。
  2. 臨時授權 – 前往 temporary license page 取得臨時授權,以進行延長測試。
  3. 購買 – 若用於正式環境,請考慮從 GroupDocs website 購買完整授權。

基本初始化與設定

Index 是 GroupDocs.Search 中的核心類別,代表儲存在磁碟上的可搜尋索引。建立指向索引檔案儲存資料夾的 Index 實例:

import com.groupdocs.search.*;

public class InitializeSearch {
    public static void main(String[] args) {
        String indexFolder = "YOUR_OUTPUT_DIRECTORY\\AdvancedUsage\\Indexing";
        Index index = new Index(indexFolder);
        System.out.println("GroupDocs.Search initialized successfully!");
    }
}

實作指南

如何使用 GroupDocs.Search 在 Java 中建立索引

建立索引資料夾、設定索引參數,並實例化 Index 物件。載入索引、設定必要選項,即可開始索引文件。 這個直接答案在 70 個字以內說明了關鍵步驟,讓您在編寫程式碼前先有清晰概念。

import com.groupdocs.search.*;

public class CreateIndexFeature {
    public static void main(String[] args) {
        String indexFolder = "YOUR_OUTPUT_DIRECTORY\\AdvancedUsage\\Indexing\\CreateIndex";
        Index index = new Index(indexFolder);
        System.out.println("Index created at: " + indexFolder);
    }
}

說明: Index 建構子接收所有索引資料將被儲存的路徑。此資料夾成為您 java document indexing 解決方案的核心。

將文件加入索引

add 是將檔案寫入索引的方法。它接受資料夾路徑,並索引其中所有支援的檔案,實現 add documents to index 與 add files to index 工作流程。您可以多次呼叫以進行增量更新。

import com.groupdocs.search.*;

public class AddDocumentsToIndexFeature {
    public static void main(String[] args) {
        String indexFolder = "YOUR_OUTPUT_DIRECTORY\\AdvancedUsage\\Indexing\\AddDocuments";
        String documentsFolder1 = "YOUR_DOCUMENT_DIRECTORY";
        String documentsFolder2 = "YOUR_DOCUMENT_DIRECTORY2";

        Index index = new Index(indexFolder);
        
        index.add(documentsFolder1);
        index.add(documentsFolder2);

        System.out.println("Documents added to the index successfully!");
    }
}

說明: add() 方法接受資料夾路徑,並索引其中所有支援的檔案。這是 add files to index 工作流程的核心,且在重複呼叫時支援增量索引。

取得與顯示索引報告

IndexingReport 提供關於索引作業的詳細統計資訊,如文件數量、詞彙數量與檔案大小指標。這些數據對於 optimize search performance 至關重要,因為它們能讓您及早發現瓶頸。

import com.groupdocs.search.*;

public class GetIndexingReportsFeature {
    public static void main(String[] args) {
        String indexFolder = "YOUR_OUTPUT_DIRECTORY\\AdvancedUsage\\Indexing\\GetReports";

        Index index = new Index(indexFolder);
        
        IndexingReport[] reports = index.getIndexingReports();
        
        for (IndexingReport report : reports) {
            System.out.println("Time: " + report.getStartTime());
            System.out.println("Duration: " + report.getIndexingTime());
            System.out.println("Documents total: " + report.getTotalDocumentsInIndex());
            System.out.println("Terms total: " + report.getTotalTermCount());
            System.out.println("Indexed documents size (MB): " + report.getIndexedDocumentsSize());
            System.out.println("Index size (MB): " + (report.getTotalIndexSize() / 1024.0 / 1024.0));
        }
    }
}

說明: 此程式碼片段取得包含時間戳記、文件數量、詞彙數量與大小指標的 IndexingReport 物件——這些是監控與 optimize search performance 的關鍵資料。

為何建立索引很重要

精心設計的索引可降低查詢延遲、減輕伺服器負載,且隨著文件集合的增長能平滑擴展。掌握 how to create index 後,您即可為模糊匹配、分面導覽與即時建議等強大搜尋功能奠定基礎。得益於串流架構,GroupDocs.Search 能處理 multi‑hundred‑page documents 而無需將整個檔案載入記憶體。

實務應用

GroupDocs.Search 可嵌入多種實務系統:

  1. Legal document management – 快速定位案件檔案或法規。
  2. Customer support portals – 即時檢索過往工單與解決方案。
  3. Enterprise content management (ECM) – 索引並搜尋整個企業資料庫。

效能考量

為了讓您的 java search example 保持快速與回應即時:

  • Incremental indexing java – 定期新增檔案,而非重新建構整個索引。
  • Memory tuning – 調整 JVM 堆積大小(大型語料庫建議 -Xmx4g)並為大型資料集啟用 G1GC。
  • Report monitoring – 使用索引報告及早發現瓶頸,並調整批次大小。

常見問題與解決方案

問題解決方案
OutOfMemoryError 在大型批次索引期間增加 JVM -Xmx 值,並考慮以較小批次進行索引。
Unsupported file format 錯誤確認檔案類型屬於 GroupDocs.Search 支援的格式(如 DOCX、PDF、TXT 等)。
Index not updating 在加入檔案後確保在相同的 Index 實例上呼叫 index.add(),或在變更後重新開啟索引。

常見問答

Q: 我可以使用 GroupDocs.Search 索引不同的文件格式嗎?
A: 是的,它支援 DOCX、PDF、TXT、HTML 以及其他多種常見格式——總計超過 50 種。

Q: 有沒有辦法在新文件到達時自動更新索引?
A: 當然可以——在自動化工作(例如排程任務)中使用 add() 方法,以執行 incremental indexing java。

Q: 如何提升極大型資料集的搜尋速度?
A: 結合 incremental indexing java 與適當的 JVM 記憶體設定,並定期檢視索引報告以微調效能。

Q: GroupDocs.Search 能處理多語言內容嗎?
A: 可以,它能索引多種語言;只需確保已啟用相應的語言分析器。

Q: 是否提供 GroupDocs.Search Java 的免費試用?
A: 是的,您可在 GroupDocs 官方網站註冊免費試用,以在購買前評估所有功能。

結論

透過上述步驟,您已掌握在 Java 中 how to create index、加入文件以及使用 GroupDocs.Search 產生深入報告的技巧。這個基礎讓您能構建強大的搜尋體驗,保持索引即時更新,並在文件集合擴大時維持高效能。

後續步驟

  • 探索進階查詢功能,如模糊搜尋與同義詞處理。
  • 將索引整合至 Web 服務或 REST API,以在應用程式中提供即時搜尋。
  • 嘗試使用雲端儲存(AWS S3、Azure Blob)作為文件來源,以實現可擴展的索引。

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

相關教學