PostgreSqlLockManager Class Reference
PostgreSQL version of DBLockManager that supports shared locks. More...
Inheritance diagram for PostgreSqlLockManager:
Collaboration diagram for PostgreSqlLockManager:
Protected Member Functions | |
| doGetLocksOnServer ( $lockSrv, array $paths, $type) | |
| releaseAllLocks () | |
 Protected Member Functions inherited from DBLockManager | |
| cacheCheckFailures ( $lockDb) | |
| Checks if the DB has not recently had connection/query errors. | |
| cacheRecordFailure ( $lockDb) | |
| Log a lock request failure to the cache. | |
| freeLocksOnServer ( $lockSrv, array $pathsByType) | |
| Get a connection to a lock server and release locks on $paths. | |
| getConnection ( $lockDb) | |
| Get (or reuse) a connection to a lock DB. | |
| getLocksOnServer ( $lockSrv, array $pathsByType) | |
| @TODO change this code to work in one batch | |
| getMissKey ( $lockDb) | |
| Get a cache key for recent query misses for a DB. | |
| initConnection ( $lockDb, IDatabase $db) | |
| Do additional initialization for new lock DB connection. | |
| isServerUp ( $lockSrv) | |
| Protected Member Functions inherited from QuorumLockManager | |
| collectPledgeQuorum ( $bucket, callable $callback) | |
| Attempt to acquire pledges with the peers for a bucket. | |
| doLock (array $paths, $type) | |
| Lock resources with the given keys and lock type. | |
| doLockByType (array $pathsByType) | |
| doLockingRequestBucket ( $bucket, array $pathsByType) | |
| Attempt to acquire locks with the peers for a bucket. | |
| doUnlock (array $paths, $type) | |
| Unlock resources with the given keys and lock type. | |
| doUnlockByType (array $pathsByType) | |
| doUnlockingRequestBucket ( $bucket, array $pathsByType) | |
| Attempt to release locks with the peers for a bucket. | |
| getBucketFromPath ( $path) | |
| Get the bucket for resource path. | |
| releasePledges ( $bucket, callable $callback) | |
| Attempt to release pledges with the peers for a bucket. | |
| Protected Member Functions inherited from LockManager | |
| normalizePathsByType (array $pathsByType) | |
| Normalize the $paths array by converting LOCK_UW locks into the appropriate type and removing any duplicated paths for each lock type. | |
| sha1Base16Absolute ( $path) | |
| Get the base 16 SHA-1 of a string, padded to 31 digits. | |
| sha1Base36Absolute ( $path) | |
| Get the base 36 SHA-1 of a string, padded to 31 digits. | |
Protected Attributes | |
| array | $lockTypeMap |
| Mapping of lock types to the type actually used. | |
| Protected Attributes inherited from DBLockManager | |
| IDatabase[] | $conns = [] |
| Map Database connections (DB name => Database) | |
| array[] IDatabase[] | $dbServers |
| Map of (DB names => server config or IDatabase) | |
| $lockExpiry | |
| $safeDelay | |
| BagOStuff | $statusCache |
| Protected Attributes inherited from QuorumLockManager | |
| array | $degradedBuckets = [] |
| Map of degraded buckets. | |
| array | $srvsByBucket = [] |
| Map of bucket indexes to peer server lists. | |
| Protected Attributes inherited from LockManager | |
| $domain | |
| array | $locksHeld = [] |
| Map of (resource path => lock type => count) | |
| $lockTTL | |
| array | $lockTypeMap |
| Mapping of lock types to the type actually used. | |
| LoggerInterface | $logger |
| string | $session |
| Random 32-char hex number. | |
Additional Inherited Members | |
| Public Member Functions inherited from DBLockManager | |
| __construct (array $config) | |
| Construct a new instance from configuration. | |
| __destruct () | |
| Make sure remaining locks get cleared for sanity. | |
| Public Member Functions inherited from LockManager | |
| lock (array $paths, $type=self::LOCK_EX, $timeout=0) | |
| Lock the resources at the given abstract paths. | |
| lockByType (array $pathsByType, $timeout=0) | |
| Lock the resources at the given abstract paths. | |
| unlock (array $paths, $type=self::LOCK_EX) | |
| Unlock the resources at the given abstract paths. | |
| unlockByType (array $pathsByType) | |
| Unlock the resources at the given abstract paths. | |
| Public Attributes inherited from LockManager | |
| const | LOCK_EX = 3 |
| const | LOCK_SH = 1 |
| Lock types; stronger locks have higher values. | |
| const | LOCK_UW = 2 |
Detailed Description
PostgreSQL version of DBLockManager that supports shared locks.
All locks are non-blocking, which avoids deadlocks.
Definition at line 11 of file PostgreSqlLockManager.php.
Member Function Documentation
◆ doGetLocksOnServer()
|
protected |
Reimplemented from DBLockManager.
Definition at line 19 of file PostgreSqlLockManager.php.
References $res, $type, DBLockManager\getConnection(), and LockManager\LOCK_SH.
◆ releaseAllLocks()
|
protected |
- Returns
- StatusValue
Reimplemented from QuorumLockManager.
Definition at line 69 of file PostgreSqlLockManager.php.
References $e.
Member Data Documentation
◆ $lockTypeMap
|
protected |
Initial value:
= [
self::LOCK_SH => self::LOCK_SH,
self::LOCK_UW => self::LOCK_SH,
self::LOCK_EX => self::LOCK_EX
]
Mapping of lock types to the type actually used.
Definition at line 13 of file PostgreSqlLockManager.php.
The documentation for this class was generated from the following file:
- includes/libs/lockmanager/PostgreSqlLockManager.php
