xdev.db.locking

Interface LockNotificationStrategy

All Known Implementing Classes:

DialogLockInUseNotificationStrategy, HybridLockInUseNotificationStrategy, NoNotificationLockInUseNotificationStrategy

public interface LockNotificationStrategy

Defines how the user should be informed about a specific lock state. For example already locked records.

Since:

4.0

Author:

XDEV Software jwill

Method Summary

Modifier and Type	Method and Description
void	lockInUseNotification(LockingException cause, PessimisticLock lock, Lockable lockable) Triggers the notification process for a specific lock state.
void	lockInUseNotification(PessimisticLock lock, Lockable lockable) Triggers the notification process for a specific lock state.
void	lockInUseNotification(RowAlreadyLockedException inUseException, PessimisticLock lock, Lockable lockable) Triggers the notification process for a specific lock state.
void	lockInUseNotificationFinished(PessimisticLock lock, Lockable lockable) Releases the notification process after a specific lock state.

Method Detail

lockInUseNotification

void lockInUseNotification(RowAlreadyLockedException inUseException,
                           PessimisticLock lock,
                           Lockable lockable)
                    throws LockingException

Triggers the notification process for a specific lock state.

Parameters:

inUseException - the specific lock in use information.

lock - the concerned lock

lockable - the lockable which contains the notification monitor - Lockable.getLockInUseNotifier()

Throws:

LockingException - if the locking process fails.

lockInUseNotification

void lockInUseNotification(LockingException cause,
                           PessimisticLock lock,
                           Lockable lockable)
                    throws LockingException

Triggers the notification process for a specific lock state.

Parameters:

cause - the specific locking error information.

lock - the concerned lock

lockable - the lockable which contains the notification monitor - Lockable.getLockInUseNotifier()

Throws:

LockingException - if the locking process fails.

lockInUseNotification

void lockInUseNotification(PessimisticLock lock,
                           Lockable lockable)
                    throws LockingException

Triggers the notification process for a specific lock state.

Parameters:

lock - the concerned lock

lockable - the lockable which contains the notification monitor - Lockable.getLockInUseNotifier()

Throws:

LockingException - if the locking process fails.

lockInUseNotificationFinished

void lockInUseNotificationFinished(PessimisticLock lock,
                                   Lockable lockable)

Releases the notification process after a specific lock state.

Parameters:

lock - the concerned PessimisticLock instance.

lockable - the lockable which contains the notification monitor - Lockable.getLockInUseNotifier()