io.flamingock.internal.common.core.error

Class LockAcquisitionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.flamingock.internal.common.core.error.FlamingockException

io.flamingock.internal.common.core.error.LockAcquisitionException

All Implemented Interfaces:

java.io.Serializable

public class LockAcquisitionException
extends FlamingockException

Exception thrown when process lock acquisition or management fails.

This exception provides detailed context about lock failures including:

• Lock key and current ownership information
• Timeout and retry attempt details
• Lock expiration and refresh status
• Competing process information
• Daemon and refresh operation context

This exception should be used for all lock-related failures including acquisition timeouts, refresh failures, and lock release issues.

Since:

6.0.0

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LockAcquisitionException.LockFailureType

Constructor Summary

Constructors

Constructor and Description
LockAcquisitionException(java.lang.String message, LockAcquisitionException.LockFailureType failureType, java.lang.String lockKey, java.lang.String currentOwner, java.lang.String requestingOwner, java.time.Duration attemptDuration, java.time.Duration configuredTimeout, int retryAttempts, java.time.LocalDateTime lockExpiration, java.lang.Throwable cause) Creates a new LockAcquisitionException with comprehensive lock context.
LockAcquisitionException(java.lang.String message, LockAcquisitionException.LockFailureType failureType, java.lang.Throwable cause) Creates a LockAcquisitionException with minimal context (for backward compatibility).

Method Summary

Modifier and Type	Method and Description
java.time.Duration	getAttemptDuration()
java.time.Duration	getConfiguredTimeout()
java.lang.String	getCurrentOwner()
LockAcquisitionException.LockFailureType	getFailureType()
java.time.LocalDateTime	getLockExpiration()
java.lang.String	getLockKey()
java.lang.String	getRequestingOwner()
int	getRetryAttempts()
static LockAcquisitionException	refreshFailed(java.lang.String lockKey, java.time.LocalDateTime lockExpiration, java.lang.Throwable cause) Factory method for lock refresh failures.
static LockAcquisitionException	timeout(java.lang.String lockKey, java.lang.String currentOwner, java.time.Duration attemptDuration, java.time.Duration configuredTimeout, int retryAttempts) Factory method for lock acquisition timeouts.

Methods inherited from class io.flamingock.internal.common.core.error.FlamingockException

toFlamingockException

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

LockAcquisitionException

public LockAcquisitionException(java.lang.String message,
                                LockAcquisitionException.LockFailureType failureType,
                                java.lang.String lockKey,
                                java.lang.String currentOwner,
                                java.lang.String requestingOwner,
                                java.time.Duration attemptDuration,
                                java.time.Duration configuredTimeout,
                                int retryAttempts,
                                java.time.LocalDateTime lockExpiration,
                                java.lang.Throwable cause)

Creates a new LockAcquisitionException with comprehensive lock context.

Parameters:

message - descriptive error message

failureType - the specific type of lock failure

lockKey - the key/identifier of the lock

currentOwner - who currently owns the lock (if known)

requestingOwner - who was trying to acquire the lock

attemptDuration - how long the acquisition attempt took

configuredTimeout - the configured lock timeout

retryAttempts - number of retry attempts made

lockExpiration - when the current lock expires (if applicable)

cause - the underlying exception that caused the failure

LockAcquisitionException

public LockAcquisitionException(java.lang.String message,
                                LockAcquisitionException.LockFailureType failureType,
                                java.lang.Throwable cause)

Creates a LockAcquisitionException with minimal context (for backward compatibility).

Parameters:

message - descriptive error message

failureType - the type of lock failure

cause - the underlying exception

Method Detail

timeout

public static LockAcquisitionException timeout(java.lang.String lockKey,
                                               java.lang.String currentOwner,
                                               java.time.Duration attemptDuration,
                                               java.time.Duration configuredTimeout,
                                               int retryAttempts)

Factory method for lock acquisition timeouts.

Parameters:

lockKey - the lock that couldn't be acquired

currentOwner - who currently owns the lock

attemptDuration - how long we tried

configuredTimeout - the configured timeout

retryAttempts - number of retries attempted

refreshFailed

public static LockAcquisitionException refreshFailed(java.lang.String lockKey,
                                                     java.time.LocalDateTime lockExpiration,
                                                     java.lang.Throwable cause)

Factory method for lock refresh failures.

Parameters:

lockKey - the lock that couldn't be refreshed

lockExpiration - when the lock was set to expire

cause - the underlying exception

getFailureType

public LockAcquisitionException.LockFailureType getFailureType()

getLockKey

public java.lang.String getLockKey()

getCurrentOwner

public java.lang.String getCurrentOwner()

getRequestingOwner

public java.lang.String getRequestingOwner()

getAttemptDuration

public java.time.Duration getAttemptDuration()

getConfiguredTimeout

public java.time.Duration getConfiguredTimeout()

getRetryAttempts

public int getRetryAttempts()

getLockExpiration

public java.time.LocalDateTime getLockExpiration()