* @author Robin Appelman * * @copyright Copyright (c) 2015, ownCloud, Inc. * @license AGPL-3.0 * * This code is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License, version 3, * as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License, version 3, * along with this program. If not, see * */ namespace OC\Lock; use OCP\AppFramework\Utility\ITimeFactory; use OCP\IDBConnection; use OCP\ILogger; use OCP\Lock\LockedException; /** * Locking provider that stores the locks in the database */ class DBLockingProvider extends AbstractLockingProvider { /** * @var \OCP\IDBConnection */ private $connection; /** * @var \OCP\ILogger */ private $logger; /** * @var \OCP\AppFramework\Utility\ITimeFactory */ private $timeFactory; const TTL = 3600; // how long until we clear stray locks in seconds /** * @param \OCP\IDBConnection $connection * @param \OCP\ILogger $logger * @param \OCP\AppFramework\Utility\ITimeFactory $timeFactory */ public function __construct(IDBConnection $connection, ILogger $logger, ITimeFactory $timeFactory) { $this->connection = $connection; $this->logger = $logger; $this->timeFactory = $timeFactory; } /** * Insert a file locking row if it does not exists. * * @param string $path * @param int $lock * @return int number of inserted rows */ protected function initLockField($path, $lock = 0) { $expire = $this->getExpireTime(); return $this->connection->insertIfNotExist('*PREFIX*file_locks', ['key' => $path, 'lock' => $lock, 'ttl' => $expire], ['key']); } /** * @return int */ protected function getExpireTime() { return $this->timeFactory->getTime() + self::TTL; } /** * @param string $path * @param int $type self::LOCK_SHARED or self::LOCK_EXCLUSIVE * @return bool */ public function isLocked($path, $type) { $query = $this->connection->prepare('SELECT `lock` from `*PREFIX*file_locks` WHERE `key` = ?'); $query->execute([$path]); $lockValue = (int)$query->fetchColumn(); if ($type === self::LOCK_SHARED) { return $lockValue > 0; } else if ($type === self::LOCK_EXCLUSIVE) { return $lockValue === -1; } else { return false; } } /** * @param string $path * @param int $type self::LOCK_SHARED or self::LOCK_EXCLUSIVE * @throws \OCP\Lock\LockedException */ public function acquireLock($path, $type) { $expire = $this->getExpireTime(); if ($type === self::LOCK_SHARED) { $result = $this->initLockField($path,1); if ($result <= 0) { $result = $this->connection->executeUpdate ( 'UPDATE `*PREFIX*file_locks` SET `lock` = `lock` + 1, `ttl` = ? WHERE `key` = ? AND `lock` >= 0', [$expire, $path] ); } } else { $result = $this->initLockField($path,-1); if ($result <= 0) { $result = $this->connection->executeUpdate( 'UPDATE `*PREFIX*file_locks` SET `lock` = -1, `ttl` = ? WHERE `key` = ? AND `lock` = 0', [$expire, $path] ); } } if ($result !== 1) { throw new LockedException($path); } $this->markAcquire($path, $type); } /** * @param string $path * @param int $type self::LOCK_SHARED or self::LOCK_EXCLUSIVE */ public function releaseLock($path, $type) { if ($type === self::LOCK_SHARED) { $this->connection->executeUpdate( 'UPDATE `*PREFIX*file_locks` SET `lock` = `lock` - 1 WHERE `key` = ? AND `lock` > 0', [$path] ); } else { $this->connection->executeUpdate( 'UPDATE `*PREFIX*file_locks` SET `lock` = 0 WHERE `key` = ? AND `lock` = -1', [$path] ); } $this->markRelease($path, $type); } /** * Change the type of an existing lock * * @param string $path * @param int $targetType self::LOCK_SHARED or self::LOCK_EXCLUSIVE * @throws \OCP\Lock\LockedException */ public function changeLock($path, $targetType) { $expire = $this->getExpireTime(); if ($targetType === self::LOCK_SHARED) { $result = $this->connection->executeUpdate( 'UPDATE `*PREFIX*file_locks` SET `lock` = 1, `ttl` = ? WHERE `key` = ? AND `lock` = -1', [$expire, $path] ); } else { $result = $this->connection->executeUpdate( 'UPDATE `*PREFIX*file_locks` SET `lock` = -1, `ttl` = ? WHERE `key` = ? AND `lock` = 1', [$expire, $path] ); } if ($result !== 1) { throw new LockedException($path); } $this->markChange($path, $targetType); } /** * cleanup empty locks */ public function cleanEmptyLocks() { $expire = $this->timeFactory->getTime(); $this->connection->executeUpdate( 'DELETE FROM `*PREFIX*file_locks` WHERE `lock` = 0 AND `ttl` < ?', [$expire] ); } public function __destruct() { try { $this->cleanEmptyLocks(); } catch (\PDOException $e) { // If the table is missing, the clean up was successful if ($this->connection->tableExists('file_locks')) { throw $e; } } } }