Class: Familia::Lock

Inherits:
StringKey show all
Defined in:
lib/familia/data_type/types/lock.rb

Instance Attribute Summary collapse

Attributes included from Settings

#current_key_version, #default_expiration, #delim, #encryption_keys, #encryption_personalization, #logical_database, #prefix, #schema_path, #schema_validator, #schemas, #suffix, #transaction_mode

Instance Method Summary collapse

Methods included from Features::Autoloader

autoload_files, included, normalize_to_config_name

Methods included from DataType::Serialization

#deserialize_value, #deserialize_values, #deserialize_values_with_nil, #serialize_value

Methods included from DataType::DatabaseCommands

#current_expiration, #delete!, #echo, #exists?, #expire, #expireat, #move, #persist, #rename, #renamenx, #type

Methods included from DataType::Connection

#dbclient, #dbkey, #direct_access, #uri

Methods included from Connection::Behavior

#connect, #create_dbclient, #multi, #normalize_uri, #pipeline, #pipelined, #transaction, #uri=, #url, #url=

Methods included from Settings

#configure, #default_suffix, #pipelined_mode, #pipelined_mode=

Methods included from Base

add_feature, #as_json, #expired?, #expires?, find_feature, #generate_id, #to_json, #to_s, #ttl, #update_expiration, #uuid

Constructor Details

#initialize(*args) ⇒ Lock

Returns a new instance of Lock.



7
8
9
10
 
# File 'lib/familia/data_type/types/lock.rb', line 7

def initialize(*args)
  super
  @opts[:default] = nil
end

Instance Attribute Details

#features_enabled ⇒ Object (readonly) Originally defined in module Features

Returns the value of attribute features_enabled.

#logical_database(val = nil) ⇒ Object Originally defined in module DataType::ClassMethods

#parent ⇒ Object Originally defined in module DataType::ClassMethods

Returns the value of attribute parent.

#prefix ⇒ Object Originally defined in module DataType::ClassMethods

Returns the value of attribute prefix.

#suffix ⇒ Object Originally defined in module DataType::ClassMethods

Returns the value of attribute suffix.

#uri(val = nil) ⇒ Object Originally defined in module DataType::ClassMethods

Returns the value of attribute uri.

Instance Method Details

#acquire(token = SecureRandom.uuid, ttl: 10) ⇒ String, false

Acquire a lock with optional TTL

Parameters:

  • token (String) (defaults to: SecureRandom.uuid) —

    Unique token to identify lock holder (auto-generated if nil)

  • ttl (Integer, nil) (defaults to: 10) —

    Time-to-live in seconds. nil = no expiration, <=0 rejected

Returns:

  • (String, false) —

    Returns token if acquired successfully, false otherwise



16
17
18
19
20
21
22
23
24
 
# File 'lib/familia/data_type/types/lock.rb', line 16

def acquire(token = SecureRandom.uuid, ttl: 10)
  success = setnx(token)
  # Handle both integer (1/0) and boolean (true/false) return values
  return false unless [1, true].include?(success)
  return del && false if ttl&.<=(0)
  return del && false if ttl&.positive? && !expire(ttl)

  token
end

#force_unlock! ⇒ Object 



40
41
42
 
# File 'lib/familia/data_type/types/lock.rb', line 40

def force_unlock!
  del
end

#held_by?(token) ⇒ Boolean

Returns:

  • (Boolean) 


36
37
38
 
# File 'lib/familia/data_type/types/lock.rb', line 36

def held_by?(token)
  value == token
end

#locked? ⇒ Boolean

Returns:

  • (Boolean) 


32
33
34
 
# File 'lib/familia/data_type/types/lock.rb', line 32

def locked?
  !value.nil?
end

#release(token) ⇒ Object 



26
27
28
29
30
 
# File 'lib/familia/data_type/types/lock.rb', line 26

def release(token)
  # Lua script to atomically check token and delete
  script = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end"
  dbclient.eval(script, [dbkey], [token]) == 1
end