What's Changed

• Update dependency gradle to v7.5.1 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/11
• Update dependency com.google.guava:guava to v30.1.1-jre by @renovate in https://github.com/Ahoo-Wang/Simba/pull/18
• Update dependency commons-io:commons-io to v2.11.0 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/19
• Update dependency org.junit-pioneer:junit-pioneer to v1.7.1 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/20
• Update dependency com.google.guava:guava to v31 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/22
• Update dependency org.springframework.boot:spring-boot-dependencies to v2.7.5 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/21
• Java to Kotlin conversion by @Ahoo-Wang in https://github.com/Ahoo-Wang/Simba/pull/24

Full Changelog: https://github.com/Ahoo-Wang/Simba/compare/v0.3.6...v0.5.0

What's Changed

• add Packages Deploy to CI

Full Changelog: https://github.com/Ahoo-Wang/Simba/compare/v0.3.5...v0.3.6

What's Changed

• Configure Renovate by @renovate in https://github.com/Ahoo-Wang/Simba/pull/2
• Update dependency gradle to v7.4.2 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/4
• Update dependency com.github.spotbugs.snom:spotbugs-gradle-plugin to v5.0.6 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/3
• Update dependency org.junit.jupiter:junit-jupiter-api to v5.8.2 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/6
• Update actions/setup-java action to v3 by @renovate in https://github.com/Ahoo-Wang/Simba/pull/7
• Fix lost state when concurrent notifyOwner.

New Contributors

• @renovate made their first contribution in https://github.com/Ahoo-Wang/Simba/pull/2

Full Changelog: https://github.com/Ahoo-Wang/Simba/compare/v0.3.2...v0.3.5

⭐ New Features

• add simba-spring-redis module.

⛏️ Refactor

• refactor code style (checkstyle/spotbugs).
• add Integration Test (GitHub Actions).

• replace io.codearte.nexus-staging -> io.github.gradle-nexus.publish-plugin
• fix the bug caused by mutex guard failure(simba-redis)

Simba(Distributed Mutex)

Introduction

Simba aims to provide easy-to-use and flexible distributed lock services and supports multiple storage implementations: relational databases, Redis, and Zookeeper.

Installation

Gradle

Kotlin DSL

    val simbaVersion = "0.2.0";
    implementation("me.ahoo.simba:simba-spring-boot-starter:${simbaVersion}")

Maven

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>
    <artifactId>demo</artifactId>
    <properties>
        <simba.version>0.2.0</simba.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>me.ahoo.simba</groupId>
            <artifactId>simba-spring-boot-starter</artifactId>
            <version>${simba.version}</version>
        </dependency>
    </dependencies>
    
</project>

application.yaml

simba:
  jdbc:
    enabled: true
#  redis:
#    enabled: true

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/simba_db
    username: root
    password: root

Optional-1: JdbcMutexContendService

Kotlin DSL

    val simbaVersion = "0.2.0";
    implementation("me.ahoo.simba:simba-jdbc:${simbaVersion}")

create table simba_mutex
(
    mutex             varchar(66)     not null primary key comment 'mutex name',
    acquired_at       bigint unsigned not null,
    ttl_at         bigint unsigned not null,
    transition_at bigint unsigned not null,
    owner_id          char(32)        not null,
    version           int unsigned    not null
);

Optional-2: RedisMutexContendService

Kotlin DSL

    val simbaVersion = "0.2.0";
    implementation("me.ahoo.simba:simba-redis:${simbaVersion}")

Optional-3: ZookeeperMutexContendService

Kotlin DSL

    val simbaVersion = "0.2.0";
    implementation("me.ahoo.simba:simba-zookeeper:${simbaVersion}")

Examples

Simba-Examples

Usage

MutexContender

        MutexContendService contendService = contendServiceFactory.createMutexContendService(new AbstractMutexContender(mutex) {
            @Override
            public void onAcquired(MutexState mutexState) {
                    log.info("onAcquired");
            }
            
            @Override
            public void onReleased(MutexState mutexState) {
                    log.info("onReleased");
            }
        });
        contendService.start();

SimbaLocker

        try (Locker locker = new SimbaLocker("mutex-locker", this.mutexContendServiceFactory)) {
            locker.acquire(Duration.ofSeconds(1));
        /**
         * doSomething
         */
        } catch (Exception e) {
            log.error(e.getMessage(), e);
        }

Scheduler

public class ExampleScheduler extends AbstractScheduler implements SmartLifecycle {

    public ExampleScheduler(MutexContendServiceFactory contendServiceFactory) {
        super("example-scheduler", ScheduleConfig.ofDelay(Duration.ofSeconds(0), Duration.ofSeconds(10)), contendServiceFactory);
    }

    @Override
    protected String getWorker() {
        return "ExampleScheduler";
    }

    @Override
    protected void work() {
        if (log.isInfoEnabled()) {
            log.info("do some work!");
        }
    }
}