# redis-cluster

**Repository Path**: kongt/redis-cluster

## Basic Information

- **Project Name**: redis-cluster
- **Description**: 业务开发过程中常有一种场景，多节点部署时，只需要一个节点做某一个操作。例如mq消费消息的时候，只需要一个节点将数据写入数据库等等。
redis-cluster为该场景而生，其实现了master挂机自动选举，当有新节点加入重新选举master等功能。所有的业务操作将在master上执行！

- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-10
- **Last Updated**: 2025-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# redis-cluster

#### 介绍

业务开发过程中常有一种场景，多节点部署时，只需要一个节点做某一个操作。例如mq消费消息的时候，只需要一个节点将数据写入数据库等等。
redis-cluster为该场景而生，其实现了master挂机自动选举，当有新节点加入重新选举master等功能。所有的业务操作将在master上执行！

#### 软件架构

软件架构说明

#### 安装教程

    在pom.xml中加入依赖
       <dependency>
               <groupId>com.kongt</groupId>
                <artifactId>redis-cluster</artifactId>
                <version>1.0.1</version>
        </dependency>

#### 使用说明

    1.请实现当选主节点接口ElectMasterEvent，和丢失主节点接口LossMasterEvent，注意当节点丢掉master后，LossMasterEvent将会持续触发。
    2.请为节点设置一个唯一的node名称，建议使用hutool的 cn.hutool.core.util.RuntimeUtil.execForStr("hostname")+应用名方式，防止多应用使用时node名称撞衫带来的不必要的问题。
    3.在spring工程中注入一个RedisClusterService，并在应用启动后调用其start方法，非spring工程需要实例化一个RedisClusterService，并手动调用start方法。

### 使用举例
    spring项目使用
![1.png](1.png)
![2.png](2.png)
    非spring项目使用
![3.png](3.png)

#### 参与贡献

    kongtcheng@163.com