rlock-spring-boot-starter

License	GNU LESSER GENERAL PUBLIC LICENSE, Version 3
Categories	Spring Boot Container Microservices
GroupId	com.github.dawn9117
ArtifactId	rlock-spring-boot-starter
Last Version	1.1.0
Release Date	Apr 17, 2020
Type	jar
Description	rlock-spring-boot-starter rlock-spring-boot-starter
Project URL	https://projects.spring.io/spring-boot/#/spring-boot-starter-parent/rlock-spring-boot-starter

Download rlock-spring-boot-starter

Filename	Size
rlock-spring-boot-starter-1.1.0.pom
rlock-spring-boot-starter-1.1.0.jar	1 KB
rlock-spring-boot-starter-1.1.0-sources.jar	1 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.dawn9117/rlock-spring-boot-starter/ -->
<dependency>
    <groupId>com.github.dawn9117</groupId>
    <artifactId>rlock-spring-boot-starter</artifactId>
    <version>1.1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.dawn9117/rlock-spring-boot-starter/
implementation 'com.github.dawn9117:rlock-spring-boot-starter:1.1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.dawn9117/rlock-spring-boot-starter/
implementation ("com.github.dawn9117:rlock-spring-boot-starter:1.1.0")

Apache Buildr

'com.github.dawn9117:rlock-spring-boot-starter:jar:1.1.0'

Apache Ivy

<dependency org="com.github.dawn9117" name="rlock-spring-boot-starter" rev="1.1.0">
  <artifact name="rlock-spring-boot-starter" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.dawn9117', module='rlock-spring-boot-starter', version='1.1.0')
)

Scala SBT

libraryDependencies += "com.github.dawn9117" % "rlock-spring-boot-starter" % "1.1.0"

Leiningen

[com.github.dawn9117/rlock-spring-boot-starter "1.1.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.springframework.boot : spring-boot-starter Optional	jar	2.2.4.RELEASE
com.github.dawn9117 : rlock-spring-boot-autoconfigure	jar	1.1.0

Project Modules

There are no modules declared in this project.

rlock-spring-boot-starter

基于Redisson的分布式锁starter

特别提示: 配置项使用优先级(1 > 2 > 3):

• 1. 优先使用通过 RedissonProperties.config 指定的配置
• 2. 配置文件中 spring.redis 前缀的配置
• 3. 默认配置

默认的锁会使用WatchDog自动延长锁的持有时间, 且无限等待获取锁, 如需修改, 可修改@Rlock中的参数

简介

该项目主要利用Spring Boot的自动化配置特性来实现快速的将redis分布式锁引入spring boot应用，简化Redisson的操作。

源码地址

GitHub：https://github.com/dawn9117/rlock-spring-boot-starter

小工具一枚，欢迎使用和Star支持，如使用过程中碰到问题，可以提出Issue，我会尽力完善该Starter

版本基础

• spring-boot-starter-parent: 2.2.4.RELEASE
• redisson: 3.12.0
• fastjson: 1.2.62
• commons-collections4: 4.3
• commons.lang3: 3.9

如何使用

在该项目的帮助下，我们的Spring Boot可以轻松的引入redis分布式锁，主需要做下面两个步骤：

step1. 在pom.xml中引入依赖：

<dependency>
  <groupId>com.github.dawn9117</groupId>
  <artifactId>rlock-spring-boot-starter</artifactId>
  <version>${version}</version>
</dependency>

step2. 根据需求配置参数

参考:

• com.github.dawn9117.rlock.config.RlockProperties
• org.springframework.boot.autoconfigure.data.redis.RedisProperties
• org.redisson.config.Config

step3. 在需要加分布式锁的方法上增加@Rlock注解

@Service
public class UserService implements IUserService {

	@Rlock(keys = "#user.name")
	@Override
	public User add(User user) {
		// do something
		return user;
	}
	
}

锁说明: 默认使用ReentrantLock(可通过LockModal指定)
规则如下(key构建规则可自定义, 参考 com.github.dawn9117.rlock.core.lock.name.LockNameBuilder):

• 注解未指定keys: prefix + 项目名称 + 类全路径 + 方法名, 例如: /locks/project/com.github.dawn.UserService/add
• 指定keys: prefix + 项目名称 + 类全路径 + 方法名 + key, 例如 /locks/project/com.github.dawn.UserService/add/zhangsan
• SPEL: prefix + 项目名称 + 类全路径 + 方法名 + SPEL, 例如 @Rlock("#param1"): /locks/project/com.github.dawn.UserService/add/解析#param1得到的值

Versions

Version
1.1.0 Apr 17, 2020
1.0.9 Feb 28, 2020
1.0.8 Feb 28, 2020
1.0.7 Feb 28, 2020
1.0.6 Feb 28, 2020
1.0.5 Feb 27, 2020
1.0.2 Feb 24, 2020
1.0.1 Jan 22, 2020
1.0.0 Jan 22, 2020