com.neocoretechs.rocksack

Class LockingTransactionId

java.lang.Object

com.neocoretechs.rocksack.TransactionId

com.neocoretechs.rocksack.LockingTransactionId

All Implemented Interfaces:

java.io.Serializable

public class LockingTransactionId
extends TransactionId
implements java.io.Serializable

Encapsulates a transaction id guaranteed to be unique across all usage via UUID. Typically represented in string form and generated via LockingTransactionId.generate() static factory method.

Also contains transactionLockTimeout. If positive, specifies the default wait timeout in milliseconds when a transaction attempts to lock a key if not specified by TransactionOptions.setLockTimeout(long) If 0, no waiting is done if a lock cannot instantly be acquired. If negative, there is no timeout. Not using a timeout is not recommended as it can lead to deadlocks. Currently, there is no deadlock-detection to recover from a deadlock. Default: 1000

Author:

Jonathan Groff Copyright (C) NeoCoreTechs 2025

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
LockingTransactionId()
LockingTransactionId(byte[] transactionId, long transactionLockTimeout)
LockingTransactionId(java.lang.String transactionId, long transactionLockTimeout)

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
static LockingTransactionId	generate() Factory method to generate a locking id with default timeout of 1000 millis.
static LockingTransactionId	generate(long timeout) Factory method to generate new locking id with given timeout in millis
long	getLockTimeout()
int	hashCode()
void	setLockTimeout(long timeout)
java.lang.String	toString()

Methods inherited from class com.neocoretechs.rocksack.TransactionId

getTransactionId, setTransactionId, setTransactionId

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

LockingTransactionId

public LockingTransactionId()

LockingTransactionId

public LockingTransactionId(java.lang.String transactionId,
                            long transactionLockTimeout)

LockingTransactionId

public LockingTransactionId(byte[] transactionId,
                            long transactionLockTimeout)

Method Detail

setLockTimeout

public void setLockTimeout(long timeout)

getLockTimeout

public long getLockTimeout()

generate

public static LockingTransactionId generate()

Factory method to generate a locking id with default timeout of 1000 millis.

Returns:

the new instance

generate

public static LockingTransactionId generate(long timeout)

Factory method to generate new locking id with given timeout in millis

Parameters:

timeout - the timeout in milliseconds

Returns:

the new instance

hashCode

public int hashCode()

Overrides:

hashCode in class TransactionId

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class TransactionId

toString

public java.lang.String toString()

Overrides:

toString in class TransactionId