Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,40 +1,75 @@
---
date: '2026-01-21'
description: 了解如何添加 GroupDocs Maven 依赖、配置并同步 Java 搜索网络,以及使用 GroupDocs.Search 将目录添加到索引中
date: '2026-05-17'
description: 了解如何添加 groupdocs Maven 依赖,设置 Java 搜索网络,并将目录添加到索引,以实现快速、可扩展的文档检索
keywords:
- Java Search Network Configuration
- GroupDocs.Search for Java
- Document Indexing and Retrieval
title: GroupDocs Maven 依赖 – Java 搜索网络同步
- how to add groupdocs
- add directories to index
- set up search cluster
schemas:
- author: GroupDocs
dateModified: '2026-05-17'
description: Learn how to add groupdocs Maven dependency, set up a Java search network,
and add directories to index for fast, scalable document retrieval.
headline: How to Add GroupDocs Maven Dependency for Search Network
type: TechArticle
- description: Learn how to add groupdocs Maven dependency, set up a Java search network,
and add directories to index for fast, scalable document retrieval.
name: How to Add GroupDocs Maven Dependency for Search Network
steps:
- name: '**Legal Document Management** – Quickly retrieve case files and precedents.'
text: '**Legal Document Management** – Quickly retrieve case files and precedents.'
- name: '**Financial Record Keeping** – Access statements and audit trails in seconds.'
text: '**Financial Record Keeping** – Access statements and audit trails in seconds.'
- name: '**Academic Research** – Search across thousands of papers to find relevant
citations.'
text: '**Academic Research** – Search across thousands of papers to find relevant
citations.'
type: HowTo
- questions:
- answer: It provides fast, scalable search capabilities across large document sets
with minimal configuration.
question: What is the primary benefit of using GroupDocs.Search?
- answer: Yes, you can set custom paths, ports, and other options via the `Configuration`
object.
question: Can I customize node configurations in a search network?
- answer: Call `IndexingDocuments.addDirectories(masterNode, "path")` whenever you
need to index new folders.
question: How do I add directories to index after the network is running?
- answer: Use the `synchronizeShards` method shown above on the newly added node.
question: How to sync shards when a new node joins the network?
- answer: A free trial license is sufficient for testing; a commercial license is
required for production.
question: Do I need a license for development?
type: FAQPage
title: 如何为搜索网络添加 GroupDocs Maven 依赖
type: docs
url: /zh/java/search-network/java-groupdocs-search-configuration-sync-guide/
weight: 1
---

# GroupDocs Maven 依赖:配置和同步 Java 搜索网络
# 如何为搜索网络添加 GroupDocs Maven 依赖

在本综合指南中,您将了解 **如何将 GroupDocs Maven 依赖** 添加到项目中,然后使用 GroupDocs.Search 配置强大的 Java 搜索网络。无论您处理的是法律简报、财务报告还是学术论文,以下步骤都将帮助您高效地建立索引、搜索并保持分片同步
在本综合指南中,您将了解 **如何添加 groupdocs Maven 依赖**,使用 GroupDocs.Search 配置强大的 Java 搜索网络,并保持分片同步。无论是索引法律简报、财务报表还是学术论文,下面的步骤都将帮助您创建可搜索的索引、在节点之间分配查询负载,并以最小的工作量保持数据一致性

## Introduction
## 快速答案
- **GroupDocs Maven 依赖是什么?** Maven 构件,捆绑了适用于 Java 项目的 GroupDocs.Search 库。
- **为什么使用搜索网络?** 它在多个节点之间分配索引和查询负载,提高速度和可靠性。
- **如何添加目录进行索引?** 在主节点上使用 `IndexingDocuments.addDirectories`。
- **如何同步分片?** 在每个节点的 `Indexer` 上调用 `SynchronizeOptions`。
- **我需要许可证吗?** 是的,生产使用需要试用或商业许可证。

管理和搜索海量文档集合是许多组织的日常挑战。通过集成 **GroupDocs Maven 依赖**,您可以获得一个强大的索引引擎,该引擎能够跨多个节点扩展。本教程将引导您完成依赖的设置、网络节点的部署、向索引添加目录以及同步分片以实现最佳性能的全过程。
## 什么是 GroupDocs Maven 依赖

### Quick Answers
- **What is the GroupDocs Maven dependency?** 一个 Maven 构件,将 GroupDocs.Search 库引入您的 Java 项目。
- **Why use a search network?** 它将索引和查询负载分布到多个节点,提高速度和可靠性。
- **How do I add directories to index?** 在主节点上使用 `IndexingDocuments.addDirectories`。
- **How to sync shards?** 在每个节点的 `Indexer` 上调用 `SynchronizeOptions`。
- **Do I need a license?** 是的,生产环境需要试用或商业许可证。
`GroupDocs Maven 依赖` 是一个 Maven 构件,捆绑了适用于 Java 项目的 GroupDocs.Search 库。
它提供创建可搜索索引、管理网络节点和执行快速查询所需的所有类,Maven 会自动解析传递依赖,使您只需在 `pom.xml` 中添加几行代码即可获得可直接使用的搜索引擎。

## What is the GroupDocs Maven Dependency?
## 如何添加 GroupDocs Maven 依赖

GroupDocs Maven 依赖 (`com.groupdocs:groupdocs-search`) 包含构建可搜索索引、管理网络节点以及执行快速查询所需的所有类。将其添加到 `pom.xml` 可确保 Maven 拉取正确的二进制文件及其传递依赖
将仓库和依赖项条目添加到您的 `pom.xml`,然后运行 `mvn clean install`;Maven 会下载 `groupdocs-search` JAR 及其所需的库,使 API 在您的项目中可用。构建成功后,您即可立即开始使用 `com.groupdocs.search` 类

## How to Add the GroupDocs Maven Dependency
### Maven 配置

### Maven Configuration

将仓库和依赖添加到您的 `pom.xml`:
将仓库和依赖项添加到您的 `pom.xml`:

```xml
<repositories>
Expand All @@ -54,18 +89,22 @@ GroupDocs Maven 依赖 (`com.groupdocs:groupdocs-search`) 包含构建可搜索
</dependencies>
```

> **Pro tip:** 通过检查官方发布页面,保持版本号为最新。
> **专业提示:** 通过检查官方发布页面保持版本号为最新。

您也可以直接从官方网站下载 JAR: [GroupDocs.Search for Java releases](https://releases.groupdocs.com/search/java/)。

您也可以直接从官方网站下载 JAR:[GroupDocs.Search for Java releases](https://releases.groupdocs.com/search/java/)。
## 为什么使用搜索网络?

## Prerequisites
搜索网络通过将索引划分为位于不同节点的分片,实现水平扩展。GroupDocs.Search 能处理 **50+ 输入格式** 并处理 **数百页文档**,无需将整个文件加载到内存中,即使数据量增长也能提供亚秒级查询响应。

- 已安装 **JDK**(11 或更高)。
- IDE,例如 IntelliJ IDEA 或 Eclipse。
- 基本的 Java 知识、Maven 使用经验以及对网络节点概念的了解。
- 有效的 GroupDocs.Search 许可证(免费试用或商业版)。
## 前提条件

## Basic Initialization and Setup
- **JDK**(11 或更高)已安装。
- IntelliJ IDEA 或 Eclipse 等 IDE。
- 基本的 Java 知识、Maven 使用经验以及网络节点概念的了解。
- 有效的 GroupDocs.Search 许可证(免费试用或商业)。

## 基本初始化和设置

首先创建一个索引目录:

Expand All @@ -79,15 +118,17 @@ SearchIndex index = new SearchIndex("YOUR_INDEX_DIRECTORY");

此简单步骤为后续的网络配置做好准备。

## Implementation Guide
## 实施指南

### 功能 1:搜索网络配置

### Feature 1: Configuration of Search Network
#### 概述

#### Overview
配置搜索网络设置节点用于通信的文件路径和端口。

配置搜索网络时,需要设置节点用于通信的文件路径和端口。
##### 设置路径和端口

##### Set Up Paths and Ports
Configuration 是一个类,保存搜索集群的网络路径、端口和其他设置。
```java
import com.groupdocs.search.options.*;
import com.groupdocs.search.scaling.configuring.ConfiguringSearchNetwork;
Expand All @@ -97,16 +138,18 @@ String basePath = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/Scaling/SynchronizingSh
int basePort = 49144; // Adjust if there's a port conflict

Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
```
`configuration` 对象现在包含了搜索网络所需的全部设置。
```
`configuration` 对象现在包含了搜索网络所需的所有设置。

### 功能 2:部署搜索网络节点

### Feature 2: Deploying Search Network Nodes
#### 概述

#### Overview
部署节点以在网络中分配工作负载。主节点管理操作和事件。

部署节点以在网络中分配工作负载。主节点负责管理操作和事件。
##### 部署代码

##### Deployment Code
SearchNetworkNode 表示搜索网络中的一个节点,可以充当主节点或工作节点。
```java
import com.groupdocs.search.scaling.*;
import com.groupdocs.search.options.Configuration;
Expand All @@ -116,41 +159,47 @@ SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, c
SearchNetworkNode masterNode = nodes[0];
```

### Feature 3: Subscribing to Search Network Node Events
### 功能 3:订阅搜索网络节点事件

#### Overview
#### 概述

监听事件可动态处理网络中的变化或更新
监听事件可动态处理网络中的更改或更新

##### Subscription Implementation
##### 订阅实现

SearchNetworkNodeEvents 提供节点生命周期和索引操作的事件钩子。
```java
import com.groupdocs.search.scaling.SearchNetworkNode;
import com.groupdocs.search.scaling.SearchNetworkNodeEvents;

SearchNetworkNodeEvents.subscribe(masterNode);
```

### Feature 4: Adding Directories to Index
### 功能 4:向索引添加目录

#### Overview
#### 概述

添加目录是使文档可搜索的核心步骤。

##### Document Addition
##### 文档添加

`IndexingDocuments.addDirectories` 将文件夹路径添加到索引进行处理。
```java
import com.groupdocs.search.indexing.IndexingDocuments;
import com.groupdocs.search.scaling.SearchNetworkNode;

IndexingDocuments.addDirectories(masterNode, "YOUR_DOCUMENT_DIRECTORY/DocumentsPath");
```

### Feature 5: Synchronizing Shards in Search Network Node
### 功能 5:在搜索网络节点中同步分片

#### Overview
#### 概述

同步确保所有分片之间的数据一致性。

##### Synchronization Code
##### 同步代码

`SynchronizeOptions` 配置分片在节点之间的同步方式。
```java
import com.groupdocs.search.indexing.Indexer;
import com.groupdocs.search.scaling.SearchNetworkNode;
Expand All @@ -165,13 +214,15 @@ def synchronizeShards(SearchNetworkNode node) {
}
```

### Feature 6: Closing Search Network Nodes
### 功能 6:关闭搜索网络节点

#### Overview
#### 概述

正确关闭节点可释放资源并防止内存泄漏。

##### Node Closure
##### 节点关闭

`close()` 释放资源并关闭搜索网络节点。
```java
import com.groupdocs.search.scaling.SearchNetworkNode;

Expand All @@ -180,37 +231,55 @@ for (SearchNetworkNode node : nodes) {
}
```

## Practical Applications
## 实际应用

1. **Legal Document Management** – 快速检索案件文件和判例。
2. **Financial Record Keeping** – 在几秒钟内访问对账单和审计轨迹
3. **Academic Research** – 在成千上万的论文中搜索以找到相关引用
1. **法律文档管理** – 快速检索案件文件和判例。
2. **财务记录保存** – 在几秒钟内访问报表和审计轨迹
3. **学术研究** – 在数千篇论文中搜索以找到相关引用

## Performance Considerations
## 性能考虑

- **Optimize Queries** – 编写简洁的查询以降低响应时间。
-优 – 根据数据量和查询负载按比例添加节点。
- **优化查询** – 编写简洁的查询以降低响应时间。
- **内存管理** – 监控 JVM 堆使用情况;对大型索引考虑 GC 调优。
- **扩展策略** – 根据数据量和查询负载按比例添加节点。

## Common Issues and Solutions
## 常见问题及解决方案

| 问题 | 原因 | 解决方案 |
|-------|-------|----------|
|------|------|----------|
| 节点连接失败 | 端口冲突 | 将 `basePort` 更改为未使用的值 |
| 索引未更新 | 缺少事件订阅 |(masterNode)` |
| 延迟高 | 分片不足 |可以通过 network引新文件夹时,调用 `IndexingDocuments.addDirectories(masterNode, "path")`。
| 索引未更新 | 缺少事件订阅 | 确保调用 `SearchNetworkNodeEvents.subscribe(masterNode)` |
| 高延迟 | 分片不足 | 增加节点数量并平衡文档分布 |

## 常见问答

**Q: 使用 GroupDocs.Search 的主要好处是什么?**
A: 它提供快速、可扩展的搜索能力,能够在大型文档集合上以最少的配置实现高效检索。

**Q: How to sync shards when a new node joins the network?**
A: 在新加入的节点上使用上文展示的 `synchronizeShards` 方法
**Q: 我可以在搜索网络中自定义节点配置吗?**
A: 可以,您可以通过 `Configuration` 对象设置自定义路径、端口和其他选项

**Q: Do I need a license for development?**
A: 测试阶段使用免费试用许可证即可,生产环境需要商业许可证
**Q: 网络运行后,如何向索引添加目录?**
A: 在需要索引新文件夹时,调用 `IndexingDocuments.addDirectories(masterNode, "path")`

## Conclusion
**Q: 新节点加入网络时如何同步分片?**
A: 在新添加的节点上使用上文示例的 `synchronizeShards` 方法。

通过本指南,您现在已经了解如何 **添加 GroupDocs Maven 依赖**、配置多节点搜索网络、索引目录以及保持分片同步。这些步骤为构建高性能文档搜索解决方案奠定了基础,能够随组织需求的增长而扩展。
**Q: 开发阶段需要许可证吗?**
A: 测试使用免费试用许可证即可;生产环境需要商业许可证。

## 结论

通过本指南,您现在了解如何 **添加 groupdocs Maven 依赖**、配置多节点搜索网络、索引目录并保持分片同步。这些步骤为构建高性能文档搜索解决方案奠定了基础,能够随组织需求的增长而扩展。

---

**Last Updated:** 2026-01-21
**Tested With:** GroupDocs.Search 25.4
**Author:** GroupDocs
**最后更新:** 2026-05-17
**测试版本:** GroupDocs.Search 25.4
**作者:** GroupDocs

## 相关教程

- [Tutorials and Examples of GroupDocs.Search for Java](/search/net/)
- [Configuring GroupDocs.Search Network in .NET: A Comprehensive Guide](/search/net/search-network/configuring-groupdocs-search-network-net-guide/)
- [How to Implement a Search Network with GroupDocs.Search in .NET for Document Management Systems](/search/net/search-network/implement-search-network-groupdocs-dotnet/)
Loading
Loading