com.github.ddth.dlock.impl.redis

Class RedisDLock

java.lang.Object

com.github.ddth.dlock.impl.AbstractDLock

com.github.ddth.dlock.impl.redis.BaseRedisDLock

com.github.ddth.dlock.impl.redis.RedisDLock

All Implemented Interfaces:

IDLock, AutoCloseable

public class RedisDLock
extends BaseRedisDLock

Redis implementation of IDLock.

Since:

0.1.0

Author:

Thanh Ba Nguyen

Field Summary

Fields

Modifier and Type	Field and Description
static String	LOCK_PROP_REDIS_HOST_AND_PORT To override the setRedisHostAndPort(String) setting.

Fields inherited from class com.github.ddth.dlock.impl.redis.BaseRedisDLock

LOCK_PROP_REDIS_PASSWORD, myOwnRedis

Fields inherited from interface com.github.ddth.dlock.IDLock

DEFAULT_LOCK_DURATION_MS

Constructor Summary

Constructors

Constructor and Description
RedisDLock(String name)

Method Summary

Modifier and Type	Method and Description
protected redis.clients.jedis.Jedis	getJedis()
String	getRedisHostAndPort() Redis' host and port scheme (format host:port).
RedisDLock	init()
LockResult	lock(String clientId, long lockDurationMs) Acquire the lock for clientId for a duration of lockDurationMs.
RedisDLock	setRedisHostAndPort(String redisHostAndPort) Sets Redis' host and port scheme (format host:port).
LockResult	unlock(String clientId) Release the lock.

Methods inherited from class com.github.ddth.dlock.impl.redis.BaseRedisDLock

destroy, getJedisConnector, getRedisPassword, getScriptLock, getScriptUnlock, setJedisConnector, setRedisPassword, setScriptLock, setScriptUnlock, updateLockHolder

Methods inherited from class com.github.ddth.dlock.impl.AbstractDLock

close, getClientId, getLockProperties, getLockProperty, getName, getTimestampExpiry, lock, setClientId, setLockProperties, setName, setTimestampExpiry, toString, updateLockHolder

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

LOCK_PROP_REDIS_HOST_AND_PORT

public static final String LOCK_PROP_REDIS_HOST_AND_PORT

To override the setRedisHostAndPort(String) setting.

See Also:

Constant Field Values

Constructor Detail

RedisDLock

public RedisDLock(String name)

Method Detail

getJedis

protected redis.clients.jedis.Jedis getJedis()

Returns:

getRedisHostAndPort

public String getRedisHostAndPort()

Redis' host and port scheme (format host:port).

Returns:

setRedisHostAndPort

public RedisDLock setRedisHostAndPort(String redisHostAndPort)

Sets Redis' host and port scheme (format host:port).

Parameters:

redisHostAndPort -

Returns:

init

public RedisDLock init()

Overrides:

init in class BaseRedisDLock

lock

public LockResult lock(String clientId,
                       long lockDurationMs)

Acquire the lock for clientId for a duration of lockDurationMs.

Reentrant: lock can be acquired multiple times by the same clientId. Lock's expiry will be extended accordingly.

Parameters:

clientId - within a namespace, only one client is allowed to hold lock as a given time

Returns:

LockResult.SUCCESSFUL if successful, LockResult.HOLD_BY_ANOTHER_CLIENT if lock is currently hold by another client

unlock

public LockResult unlock(String clientId)

Release the lock.

Parameters:

clientId - within a namespace, only one client is allowed to hold lock as a given time

Returns:

LockResult.SUCCESSFUL if successful, LockResult.HOLD_BY_ANOTHER_CLIENT if lock is currently hold by another client, LockResult.NOT_FOUND if the lock is not currently hold by any client (not locked before, or already expired)