如何為 Java 配置 GroupDocs Search Network
在當今快速變化的數位環境中,configure groupdocs search network 技能對任何需要快速且可靠地搜尋數百萬文件的組織而言都是必不可少的。良好配置的搜尋網路會將索引和查詢工作負載分散到多個 JVM 節點,保持低回應時間,並保證高可用性。本教學將逐步說明每個步驟——從 Maven 設定與授權啟用到節點部署、事件訂閱、文件索引,甚至圖像搜尋——讓您能在 Java 中建立可投入生產的 GroupDocs.Search 網路。
快速答覆
- 搜尋網路的主要目的為何? 將索引和查詢負載分散到多個節點,以提升可擴展性和可靠性。
- GroupDocs.Search 預設使用哪個埠口? 範例使用埠口 49120,但您可以選擇任何未被佔用的埠口。
- 我可以在不中斷服務的情況下新增或移除節點嗎? 可以——節點可以動態部署或退役。
- 生產環境需要授權嗎? 生產使用需要完整授權;亦提供試用授權供評估使用。
- 是否內建支援圖像搜尋? 是——GroupDocs.Search 提供內建的圖像雜湊比較功能。
什麼是搜尋網路?
A SearchNetworkNode 是叢集中個別的節點,承載共享索引的副本並處理搜尋請求。search network 是一組相互連結的 SearchNetworkNode 實例,彼此共享索引資訊並協同回應查詢。此架構讓您能處理龐大的文件集合,同時保持低回應時間,且在節點離線時可自動故障轉移。
為何在 Java 中使用 GroupDocs.Search?
為您的 Java 應用程式配備一個能在數分鐘內 configure groupdocs search network、水平擴展,且支援超過 30 種檔案格式(包括 PDF、DOCX、XLSX、PPTX 以及常見影像類型)的搜尋引擎。基準測試顯示,三節點叢集在標準伺服器硬體上可於 30 分鐘內索引 500,000 份文件,而查詢延遲即使在高併發負載下亦維持在 200 ms 以下。
前置條件
- JDK 8+ 已安裝於每台將執行節點的機器上。
- 使用如 IntelliJ IDEA 或 Eclipse 等 IDE,以便輕鬆管理專案。
- Maven 用於相依性解析。
- 具備 Java 網路(TCP 埠口、防火牆)與多執行緒概念的基本知識。
必要的函式庫與相依性
將 GroupDocs 儲存庫與相依性加入您的 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 下載最新版本。
設定 GroupDocs.Search for Java
透過 Maven 安裝
上述 Maven 片段會自動將函式庫拉入您的專案。
取得授權
- Free Trial – 無需信用卡即可探索核心功能。
- Temporary License – 供內部試點使用的延長測試期間。
- Full License – 生產就緒、無限制使用,並提供優先支援。
基本初始化與設定
SearchNetworkDeployment 類別負責協調搜尋叢集的建立與管理,處理節點生命週期與共享資源。在您能與任何節點互動之前,必須建立一個 SearchNetworkDeployment 物件,並指向共享索引資料夾。以下程式碼區塊(保留自原始教學)展示了最小的啟動程式:
import com.groupdocs.search.*;
public class SearchSetup {
public static void main(String[] args) {
// Create an instance of Index with the path to store index data.
String indexPath = "path/to/index";
Index index = new Index(indexPath);
System.out.println("GroupDocs.Search initialized successfully.");
}
}
實作指南
接下來,我們將深入每個核心任務,使用清晰的逐步說明,這些說明會位於原始程式碼佔位符之前。
如何在搜尋網路中部署節點
部署多個節點可分散工作負載並提升容錯能力。SearchNetworkNode 代表參與搜尋叢集的個別 JVM 實例,負責索引與查詢請求。透過在連續埠口上啟動多個節點,您即可建立彈性的網路,使每個節點皆能服務客戶端呼叫並共享共同的索引。
public class SearchNetworkDeployment {
public static void run() {
String basePath = "YOUR_DOCUMENT_DIRECTORY";
int basePort = 49120; // Change if necessary.
Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);
System.out.println("Deployed " + nodes.length + " search network nodes.");
}
}
如何訂閱事件
事件訂閱讓您即時了解節點健康狀態、索引進度與錯誤情況。SearchNetworkEvents 類別提供一組回呼,會在索引完成、節點失敗或自訂通知等重要動作時觸發。在主節點或工作節點註冊監聽器,可實現即時監控與自動回應,確保網路順暢運作。
public class NodeEventSubscription {
public static void run() {
String basePath = "YOUR_DOCUMENT_DIRECTORY";
int basePort = 49120; // Adjust if needed.
Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);
SearchNetworkEvents.subscribe(nodes[0]);
System.out.println("Subscribed to events for the master node.");
}
}
如何索引文件
高效的索引是快速搜尋結果的基礎。當您將目錄加入主節點時,引擎會掃描每個檔案,擷取可搜尋內容,並儲存於共享索引結構中。此過程可增量執行,只更新變更的檔案,降低 I/O 負載,並確保查詢始終反映最新的文件版本。
public class DocumentIndexing {
public static void run() {
String basePath = "YOUR_DOCUMENT_DIRECTORY";
int basePort = 49120; // Change if there is a conflict.
Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);
IndexingDocuments.addDirectories(nodes[0], "YOUR_DOCUMENT_DIRECTORY");
System.out.println("Added directories to master node's index.");
}
}
如何執行圖像搜尋
GroupDocs.Search 支援圖像雜湊比較,讓您能找出視覺上相似的資產。SearchImage 類別封裝圖像檔案,計算感知雜湊,並可與索引中儲存的雜湊進行比對。透過指定最大雜湊差異,您可控制視覺相似度的容忍度,從而可靠地在儲存庫中發現重複或相關的圖像。
public class ImageSearch {
public static void run() {
String basePath = "YOUR_DOCUMENT_DIRECTORY";
int basePort = 49120; // Modify if needed.
Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);
SearchImage searchImage = SearchImage.create("YOUR_DOCUMENT_DIRECTORY/ic_arrow_back_black_18dp.png");
imageSearch(nodes[0], searchImage, 8);
}
}
如何配置網路埠口
如果您的環境已使用埠口 49120,您可以將其更改為任何未被佔用的 TCP 埠口。basePort 參數決定叢集的起始埠號,之後的每個節點會自動遞增此值。請確保所選埠口在防火牆中開放,未被其他服務佔用,且在所有節點上保持一致設定,以維持無縫通訊。
int customPort = 50000; // Example of a custom port.
Configuration configuration = ConfiguringSearchNetwork.configure(basePath, customPort);
常見問題與故障排除
| 症狀 | 可能原因 | 解決方案 |
|---|---|---|
| 節點啟動失敗 | 埠口衝突 | 選擇不同的 basePort 並更新防火牆規則。 |
| 索引速度緩慢 | I/O 帶寬不足 | 使用 SSD 儲存並啟用增量索引。 |
| 事件訂閱未觸發 | 缺少事件處理器註冊 | 確保在任何索引開始前呼叫 SearchNetworkEvents.subscribe(node)。 |
| 圖像搜尋無結果 | 雜湊差異過低 | 提高允許的雜湊差異(例如,從 4 增至 8)。 |
常見問答
Q: 如何在 GroupDocs.Search 網路中優化索引效能?
A: 使用增量索引,將索引儲存於高速 SSD,並為 JVM 分配足夠的堆記憶體。
Q: 我可以在不重新啟動整個搜尋網路的情況下新增或移除節點嗎?
A: 可以——節點可以動態部署或退役。新增節點後,重新呼叫 SearchNetworkDeployment.deploy 以刷新叢集視圖。
Q: 事件訂閱如何提升網路管理?
A: 訂閱的事件提供節點狀態變更、索引進度與錯誤的即時警示,讓您能主動排除故障。
Q: 是否可以同時搜尋不同的文件格式?
A: 當然可以。GroupDocs.Search 在單一查詢中支援 PDF、Word、Excel、PowerPoint、影像以及許多其他格式。
Q: GroupDocs.Search 網路中的資料安全性如何?
A: 安全性取決於您的基礎設施。請為節點通訊實施 SSL/TLS,限制網路存取,並遵循資料保護的最佳實踐。
最後更新: 2026-06-27
測試版本: GroupDocs.Search 25.4 for Java
作者: GroupDocs