Package org.springframework.integration.redis.util

Class RedisLockRegistry

java.lang.Object
org.springframework.integration.redis.util.RedisLockRegistry
All Implemented Interfaces:
org.springframework.beans.factory.DisposableBean, org.springframework.integration.support.locks.ExpirableLockRegistry, org.springframework.integration.support.locks.LockRegistry
public final class RedisLockRegistry
extends java.lang.Object
implements org.springframework.integration.support.locks.ExpirableLockRegistry, org.springframework.beans.factory.DisposableBean
Implementation of ExpirableLockRegistry providing a distributed lock using Redis. Locks are stored under the key registryKey:lockKey. Locks expire after (default 60) seconds. Threads unlocking an expired lock will get an IllegalStateException. This should be considered as a critical error because it is possible the protected resources were compromised.

Locks are reentrant.

However, locks are scoped by the registry; a lock from a different registry with the same key (even if the registry uses the same 'registryKey') are different locks, and the second cannot be acquired by the same thread while the first is locked.

Note: This is not intended for low latency applications. It is intended for resource locking across multiple JVMs.

Conditions are not supported.

Since:
4.0

  • Constructor Summary

    Constructors 
    Constructor Description
    RedisLockRegistry​(org.springframework.data.redis.connection.RedisConnectionFactory connectionFactory, java.lang.String registryKey)
    Constructs a lock registry with the default (60 second) lock expiration.
    RedisLockRegistry​(org.springframework.data.redis.connection.RedisConnectionFactory connectionFactory, java.lang.String registryKey, long expireAfter)
    Constructs a lock registry with the supplied lock expiration.

  • Method Summary

    Modifier and Type Method Description
    void destroy()  
    void expireUnusedOlderThan​(long age)  
    java.util.concurrent.locks.Lock obtain​(java.lang.Object lockKey)  
    void setExecutor​(java.util.concurrent.Executor executor)
    Set the Executor, where is not provided then a default of cached thread pool Executor will be used.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • RedisLockRegistry

      public RedisLockRegistry​(org.springframework.data.redis.connection.RedisConnectionFactory connectionFactory, java.lang.String registryKey)
      Constructs a lock registry with the default (60 second) lock expiration.
      Parameters:
      connectionFactory - The connection factory.
      registryKey - The key prefix for locks.

    • RedisLockRegistry

      public RedisLockRegistry​(org.springframework.data.redis.connection.RedisConnectionFactory connectionFactory, java.lang.String registryKey, long expireAfter)
      Constructs a lock registry with the supplied lock expiration.
      Parameters:
      connectionFactory - The connection factory.
      registryKey - The key prefix for locks.
      expireAfter - The expiration in milliseconds.

  • Method Details

    • setExecutor

      public void setExecutor​(java.util.concurrent.Executor executor)
      Set the Executor, where is not provided then a default of cached thread pool Executor will be used.
      Parameters:
      executor - the executor service
      Since:
      5.0.5

    • obtain

      public java.util.concurrent.locks.Lock obtain​(java.lang.Object lockKey)
      Specified by:
      obtain in interface org.springframework.integration.support.locks.LockRegistry

    • expireUnusedOlderThan

      public void expireUnusedOlderThan​(long age)
      Specified by:
      expireUnusedOlderThan in interface org.springframework.integration.support.locks.ExpirableLockRegistry

    • destroy

      public void destroy()
      Specified by:
      destroy in interface org.springframework.beans.factory.DisposableBean