分布式中间件：Zookeeper 入门

分布式中间件：Zookeeper 入门

引言

在分布式系统的开发中，协调服务是至关重要的。Zookeeper 作为一个高性能的分布式协调服务，为分布式应用提供了一致性服务，如配置管理、命名服务、分布式锁等。本文将带你快速入门 Zookeeper，从环境搭建到 Java 代码集成，让你对 Zookeeper 有一个初步的了解。

环境搭建

使用 Docker 安装 Zookeeper

我们可以使用 Docker 快速搭建 Zookeeper 环境，避免繁琐的安装和配置过程。以下是具体步骤：

1. 拉取 Zookeeper 镜像

首先，我们需要从 Docker Hub 拉取 Zookeeper 3.8.1 版本的镜像。在终端中执行以下命令：

docker pull zookeeper:3.8.1

这个命令会从 Docker Hub 下载 Zookeeper 3.8.1 版本的镜像到本地。

2. 运行 Zookeeper 容器

拉取完镜像后，我们可以使用以下命令启动一个 Zookeeper 容器：

docker run -d --name zookeeper -p 2181:2181 -p 2888:2888 -p 3888:3888 zookeeper:3.8.1

• -d：表示以守护进程的方式在后台运行容器。
• --name zookeeper：为容器指定一个名称为 zookeeper。
• -p 2181:2181：将容器的 2181 端口映射到主机的 2181 端口，2181 是 Zookeeper 的客户端连接端口。
• -p 2888:2888 和 -p 3888:3888：用于 Zookeeper 集群内部节点之间的通信。

Java 代码集成

添加依赖

在 Maven 项目的 pom.xml 文件中添加 Zookeeper 和 Curator 相关的依赖。Curator 是 Apache 提供的一个 Zookeeper 客户端框架，简化了 Zookeeper 的使用。

<dependency>
    <groupId>org.apache.zookeeper</groupId>
    <artifactId>zookeeper</artifactId>
    <version>3.8.1</version>
    <exclusions>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-framework</artifactId>
    <version>5.3.0</version>
</dependency>
<dependency>
    <groupId>org.apache.curator</groupId>
    <artifactId>curator-recipes</artifactId>
    <version>5.3.0</version>
</dependency>

这里排除了 slf4j-log4j 和 slf4j-api，是为了避免可能的依赖冲突。

配置 Zookeeper 连接信息

在 application.yml 或 application.properties 文件中添加 Zookeeper 的连接信息：

zk:
  host: 127.0.0.1:2181
  namespace: test

• zk.host：Zookeeper 的连接地址和端口。
• zk.namespace：Zookeeper 的命名空间，用于隔离不同的应用。

创建 Curator 客户端

在 Spring Boot 项目中，我们可以通过创建一个 CuratorFramework 客户端来连接 Zookeeper。以下是示例代码：

import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.CuratorFrameworkFactory;
import org.apache.curator.retry.RetryNTimes;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
import org.springframework.context.annotation.Bean;
import org.springframework.core.env.Environment;

@SpringBootApplication
public class DistributedMiddlewareApplication extends SpringBootServletInitializer {

    public static void main(String[] args) {
        SpringApplication.run(DistributedMiddlewareApplication.class, args);
    }

    @Autowired
    private Environment environment;

    @Bean
    public CuratorFramework curatorFramework() {
        // 创建 Curator 客户端
        // 重试策略，重试 5 次，每次间隔 1s
        CuratorFramework client = CuratorFrameworkFactory.builder()
               .connectString(environment.getProperty("zk.host"))
               .namespace(environment.getProperty("zk.namespace"))
               .sessionTimeoutMs(15000)
               .retryPolicy(new RetryNTimes(5, 1000))
               .build();
        client.start();
        return client;
    }
}

在上述代码中，我们使用 CuratorFrameworkFactory 来创建一个 CuratorFramework 客户端，并设置了连接地址、命名空间、会话超时时间和重试策略。最后，调用 start() 方法启动客户端。

总结

通过本文的介绍，你已经了解了如何使用 Docker 快速搭建 Zookeeper 环境，以及如何在 Java 项目中集成 Zookeeper。Zookeeper 作为一个强大的分布式协调服务，在分布式系统中有着广泛的应用。在后续的学习中，你可以进一步探索 Zookeeper 的更多功能，如分布式锁、配置管理等。

希望本文能帮助你快速入门 Zookeeper，开启分布式系统开发的之旅！

以上博客内容从 Zookeeper 的环境搭建到 Java 代码集成进行了详细的介绍，希望对你有所帮助。你可以根据实际情况对内容进行调整和扩展。