建立搜尋索引目錄並從檔案設定授權於 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 會將文件的索引表示儲存在此處。若沒有此目錄，搜尋引擎無法持久化資料，查詢將無法執行。建立此目錄是實現快速、精確搜尋大型文件集合的基礎步驟。

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

從檔案套用授權（apply license from file）可解鎖 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 堆積，當索引大型語料庫時，必要時調高 -Xmx 以避免 OutOfMemoryError。
使用增量索引 進行即時更新，避免每次都全量重建。

結論

現在您已掌握如何 建立搜尋索引目錄 以及 從檔案套用授權，並利用 GroupDocs.Search for Java 解鎖完整功能，打造任何文件密集型應用程式的強大搜尋解決方案。

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

常見問答

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

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

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

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

Q: GroupDocs.Search 能有效處理大型資料集嗎？
A: 能，只要採取適當的索引策略並配置足夠的 JVM 記憶體，即可擴展至百萬級文件。

其他資源

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