Package org.keycloak.models.dblock

Class DBLockGlobalLockProvider

java.lang.Object

org.keycloak.models.dblock.DBLockGlobalLockProvider

All Implemented Interfaces:

GlobalLockProvider, Provider

public class DBLockGlobalLockProvider
extends Object
implements GlobalLockProvider

Nested Class Summary

Nested classes/interfaces inherited from interface org.keycloak.models.locking.GlobalLockProvider

GlobalLockProvider.Constants

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DATABASE

Constructor Summary

Constructors

Constructor	Description
DBLockGlobalLockProvider(KeycloakSession session, DBLockProvider dbLockProvider)

Method Summary

Modifier and Type	Method	Description
void	close()
void	forceReleaseAllLocks()
<V> V	withLock(String lockName, Duration timeToWaitForLock, KeycloakSessionTaskWithResult<V> task)	Acquires a new non-reentrant global lock that is visible to all Keycloak nodes.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.keycloak.models.locking.GlobalLockProvider

withLock

Field Details

DATABASE

public static final String DATABASE

See Also:

• Constant Field Values

Constructor Details

DBLockGlobalLockProvider

public DBLockGlobalLockProvider(KeycloakSession session,
 DBLockProvider dbLockProvider)

Method Details

withLock

public <V> V withLock(String lockName,
 Duration timeToWaitForLock,
 KeycloakSessionTaskWithResult<V> task)

Acquires a new non-reentrant global lock that is visible to all Keycloak nodes. If the lock was successfully acquired the method runs the task and return result to the caller.

See GlobalLockProvider.withLock(String, Duration, KeycloakSessionTaskWithResult) for more details.

This implementation does NOT meet all requirements from the JavaDoc of GlobalLockProvider.withLock(String, Duration, KeycloakSessionTaskWithResult) because DBLockProvider does not provide a way to lock and unlock in separate transactions. Also, the database schema update currently requires to be running in the same thread that initiated the update therefore the task is also running in the caller thread/transaction.

Specified by:

withLock in interface GlobalLockProvider

forceReleaseAllLocks

public void forceReleaseAllLocks()

Specified by:

forceReleaseAllLocks in interface GlobalLockProvider

close

public void close()

Specified by:

close in interface Provider