Class DefaultLockRepository
java.lang.Object
org.springframework.integration.jdbc.lock.DefaultLockRepository
- All Implemented Interfaces:
Closeable
,AutoCloseable
,Aware
,InitializingBean
,SmartInitializingSingleton
,ApplicationContextAware
,LockRepository
public class DefaultLockRepository
extends Object
implements LockRepository, InitializingBean, ApplicationContextAware, SmartInitializingSingleton
The default implementation of the
LockRepository
based on the
table from the script presented in the org/springframework/integration/jdbc/schema-*.sql
.
This repository can't be shared between different JdbcLockRegistry
instances.
Otherwise, it opens a possibility to break Lock
contract,
where JdbcLockRegistry
uses non-shared ReentrantLock
s
for local synchronizations.
- Since:
- 4.3
- Author:
- Dave Syer, Artem Bilan, Glenn Renfro, Gary Russell, Alexandre Strubel, Ruslan Stelmachenko
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Default value for the table prefix property.static final int
Default value for the time-to-live property. -
Constructor Summary
ConstructorDescriptionDefaultLockRepository
(DataSource dataSource) Constructor that initializes the client id that will be associated for all the locks persisted by the store instance to a randomUUID
.DefaultLockRepository
(DataSource dataSource, String id) Constructor that allows the user to specify a client id that will be associated for all the locks persisted by the store instance. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Acquire a lock for a key.void
void
void
close()
void
Remove a lock from this repository.void
Remove all the expired locks.boolean
isAcquired
(String lock) Check if a lock is held by this repository.boolean
Renew the lease for a lock.void
setApplicationContext
(ApplicationContext applicationContext) void
Specify the prefix for target database table used from queries.void
A unique grouping identifier for all locks persisted with this store.void
setTimeToLive
(int timeToLive) Specify the time (in milliseconds) to expire dead-locks.void
setTransactionManager
(PlatformTransactionManager transactionManager) Set aPlatformTransactionManager
for operations.
-
Field Details
-
DEFAULT_TABLE_PREFIX
Default value for the table prefix property.- See Also:
-
DEFAULT_TTL
public static final int DEFAULT_TTLDefault value for the time-to-live property.- See Also:
-
-
Constructor Details
-
DefaultLockRepository
Constructor that initializes the client id that will be associated for all the locks persisted by the store instance to a randomUUID
.- Parameters:
dataSource
- theDataSource
used to maintain the lock repository.
-
DefaultLockRepository
Constructor that allows the user to specify a client id that will be associated for all the locks persisted by the store instance.- Parameters:
dataSource
- theDataSource
used to maintain the lock repository.id
- the client id to be associated with locks handled by the repository.- Since:
- 4.3.13
-
-
Method Details
-
setRegion
A unique grouping identifier for all locks persisted with this store. Using multiple regions allows the store to be partitioned (if necessary) for different purposes. Defaults toDEFAULT
.- Parameters:
region
- the region name to set
-
setPrefix
Specify the prefix for target database table used from queries.- Parameters:
prefix
- the prefix to set (defaultINT_
).
-
setTimeToLive
public void setTimeToLive(int timeToLive) Specify the time (in milliseconds) to expire dead-locks.- Parameters:
timeToLive
- the time to expire dead-locks.
-
setTransactionManager
Set aPlatformTransactionManager
for operations. Otherwise, a primaryPlatformTransactionManager
bean is obtained from the application context.- Parameters:
transactionManager
- thePlatformTransactionManager
to use.- Since:
- 6.0
-
setApplicationContext
- Specified by:
setApplicationContext
in interfaceApplicationContextAware
- Throws:
BeansException
-
afterPropertiesSet
public void afterPropertiesSet()- Specified by:
afterPropertiesSet
in interfaceInitializingBean
-
afterSingletonsInstantiated
public void afterSingletonsInstantiated()- Specified by:
afterSingletonsInstantiated
in interfaceSmartInitializingSingleton
-
close
public void close()- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceLockRepository
-
delete
Description copied from interface:LockRepository
Remove a lock from this repository.- Specified by:
delete
in interfaceLockRepository
- Parameters:
lock
- the lock to remove.
-
acquire
Description copied from interface:LockRepository
Acquire a lock for a key.- Specified by:
acquire
in interfaceLockRepository
- Parameters:
lock
- the key for lock to acquire.- Returns:
- acquired or not.
-
isAcquired
Description copied from interface:LockRepository
Check if a lock is held by this repository.- Specified by:
isAcquired
in interfaceLockRepository
- Parameters:
lock
- the lock to check.- Returns:
- acquired or not.
-
deleteExpired
public void deleteExpired()Description copied from interface:LockRepository
Remove all the expired locks.- Specified by:
deleteExpired
in interfaceLockRepository
-
renew
Description copied from interface:LockRepository
Renew the lease for a lock.- Specified by:
renew
in interfaceLockRepository
- Parameters:
lock
- the lock to renew.- Returns:
- renewed or not.
-