-
Language:
English
-
Language:
English
9.3. Configure Locking (Library Mode)
For Library mode, the
locking
element and its parameters are set within the optional configuration
element on a per cache basis. For example, for the default cache, the configuration
element occurs within the default
element and for each named cache, it occurs within the namedCache
element. The following is an example of this configuration:
<infinispan> ... <default> <configuration> <locking concurrencyLevel="${VALUE}" isolationLevel="${LEVEL}" lockAcquisitionTimeout="${TIME}" useLockStriping="${TRUE/FALSE}" writeSkewCheck="${TRUE/FALSE}" supportsConcurrentUpdates="${TRUE/FALSE}" /> ... </configuration> </default> </infinispan>
- The
concurrencyLevel
parameter specifies the concurrency level for the lock container. Set this value according to the number of concurrent threads interacting with the data grid. - The
isolationLevel
parameter specifies the cache's isolation level. Valid isolation levels areREAD_COMMITTED
andREPEATABLE_READ
. For details about isolation levels, refer to Chapter 11, Isolation Levels - The
lockAcquisitionTimeout
parameter specifies time (in milliseconds) after which a lock acquisition attempt times out. - The
useLockStriping
parameter specifies whether a pool of shared locks are maintained for all entries that require locks. If set toFALSE
, locks are created for each entry in the cache. For details, refer to Chapter 10, Lock Striping - The
writeSkewCheck
parameter is only valid if theisolationLevel
is set toREPEATABLE_READ
. If this parameter is set toFALSE
, a disparity between a working entry and the underlying entry at write time results in the working entry overwriting the underlying entry. If the parameter is set toTRUE
, such conflicts (namely write skews) throw an exception. - The
supportsConcurrentUpdates
parameter is only valid for non-transactional caches. If this parameter is set toTRUE
(default value), the cache ensures that the data remains consistent despite concurrent updates. If the application is not expected to perform concurrent writes, it is recommended that this parameter is set toFALSE
to improve performance.