在 GroupDocs.Search for Java 中建立搜尋索引目錄並從檔案設定授權

有效管理授權至關重要，但在套用授權之前，您必須先 建立搜尋索引目錄，讓 GroupDocs.Search 能將資料儲存於其中。本指南將逐步說明整個流程——從設定 Maven 相依性、建立搜尋索引資料夾，到最後從檔案套用授權。完成後，您將擁有一個完整授權、隨時可搜尋的 Java 應用程式，解鎖程式庫的全部功能。

快速解答

第一步是什麼？ 使用 new Index("path/to/index") 建立搜尋索引目錄。
如何套用授權？ 使用 License license = new License(); license.setLicense("path/to/license.lic");。
需要 Maven 嗎？ 需要，請將 GroupDocs.Search 的儲存庫與相依性加入 pom.xml。
可以不使用授權執行嗎？ 程式庫可在評估模式下運行，但功能會受限。
需要哪個 Java 版本？ 建議使用 Java 8 以上，以確保完整相容性。

什麼是「搜尋索引目錄」以及為什麼需要它？

搜尋索引目錄是磁碟上的一個資料夾，GroupDocs.Search 會將文件的索引表示儲存在此處。若沒有此目錄，搜尋引擎無法持久化資料，查詢將無法執行。建立目錄是基礎步驟，讓大型文件集合能快速、精確搜尋，並 建構驅動查詢結果的搜尋索引。

為什麼要從檔案套用授權？

套用 授權檔案 後，GroupDocs.Search 會解鎖全部功能、移除評估水印，並確保符合供應商的授權條款。這是一種簡單且程式化的方式，讓您的應用程式保持上線狀態，並 為每次搜尋操作解鎖完整功能。

前置條件

GroupDocs.Search for Java 版本 25.4（或更新版本）
IntelliJ IDEA、Eclipse 等 IDE
用於相依性管理的 Maven
有效的 GroupDocs.Search 授權檔案（.lic）

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

如何建立搜尋索引目錄

建立索引目錄相當簡單。使用 SDK 提供的 Index 類別：

import com.groupdocs.search.*;

// Create or load an index
Index index = new Index("path/to/index/directory");

專業提示： 選擇應用程式在執行時可讀寫的路徑，例如專案 resources 目錄下的資料夾或外部資料磁碟。此路徑即為您的 搜尋索引路徑。

實作「從檔案套用授權」

步驟 1：匯入所需套件

這些匯入讓您可以使用授權 API 以及 Java NIO 的檔案處理工具。

import com.groupdocs.search.licenses.License;
import java.nio.file.Files;
import java.nio.file.Paths;

步驟 2：定義授權檔案路徑

將 YOUR_DOCUMENT_DIRECTORY 替換為實際存放 .lic 檔案的資料夾路徑。

String licensePath = "YOUR_DOCUMENT_DIRECTORY/license.lic";

步驟 3：驗證授權檔案是否存在並套用

以下程式碼會先檢查授權檔案是否存在，避免執行時發生錯誤。

if (Files.exists(Paths.get(licensePath))) {
    License license = new License();

    // Step 4: Set the License Using the Specified File
    license.setLicense(licensePath);
    
    // License is successfully applied at this point.
}

主要語句說明

Files.exists(Paths.get(licensePath)) – 安全 驗證授權檔案 是否存在。
new License() – 建立授權輔助物件。
license.setLicense(licensePath) – 載入並 套用授權檔案，解鎖全部功能。

常見問題與除錯

問題	可能原因	解決方案
找不到檔案	`licensePath` 錯誤或檔案遺失	再次確認路徑，確保 `.lic` 檔案已隨應用程式部署。
權限被拒絕	應用程式缺乏讀取權限	為目錄授予讀取權限，或以具備相應權限的身分執行 JVM。
授權未套用	使用了過期或不相容的授權版本	確認授權檔案與您使用的 GroupDocs.Search 版本相符。

實務應用

GroupDocs.Search 在需要快速、可擴充文字搜尋的情境中表現卓越：

內容管理系統 – 索引並搜尋成千上萬的 PDF、Word 文件與 HTML 頁面。
法律文件審查 – 在龐大的合約庫中迅速定位條款。
客服支援平台 – 讓客服人員即時取得相關知識庫文章。

效能建議

定期重新建構索引，於大量上傳後保持搜尋結果的即時性。
監控 JVM 堆積，索引大型語料庫時若出現 OutOfMemoryError，請考慮提升 -Xmx 設定。
使用增量索引 以即時更新資料，避免每次都完整重新建索引。

為什麼這很重要

建立可靠的 搜尋索引目錄 並正確 套用授權檔案 是讓您在大規模環境中發揮 GroupDocs.Search 能力的兩大支柱。缺少任一步驟都會導致功能受限或執行時錯誤，進而阻礙開發並影響最終使用者體驗。

常見陷阱須避免

將授權檔案放入唯讀的 JAR 中——SDK 需要磁碟上的實體檔案。
硬編碼絕對路徑，導致開發與正式環境不一致。請改用相對路徑或配置檔。
忘記在任何搜尋操作前呼叫 license.setLicense(...)；SDK 會在首次使用時檢查授權。

結論

現在您已掌握 建立搜尋索引目錄、建構搜尋索引，以及 從檔案套用授權 的完整流程。此設定可解鎖程式庫的全部功能，讓您能為任何文件密集型應用程式打造穩健的搜尋解決方案。

下一步： 嘗試使用模糊搜尋、布林運算子與自訂計分等進階查詢功能，將結果調整至符合您的業務需求。

常見問答

Q: 如何取得 GroupDocs.Search 的臨時授權？
A: 前往 GroupDocs Temporary License 取得免費試用。

Q: 可以不使用 Maven 嗎？
A: 可以，直接下載 JAR 檔並加入專案的 classpath 即可。

Q: 執行時若找不到授權檔案會發生什麼事？
A: SDK 會以評估模式運行，搜尋文件數量受限，且可能顯示水印。

Q: 應該多久重新建構一次搜尋索引？
A: 每當新增、刪除或大量修改文件時，都應重新建構，以確保搜尋精確度。

Q: GroupDocs.Search 能有效處理大型資料集嗎？
A: 能，配合適當的索引策略與足夠的 JVM 記憶體配置，可擴展至百萬文件規模。

其他資源

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