Improve abstract mutex classes naming (#68)

Author: mvorisek

README.md

@@ -48,8 +48,7 @@ This library uses the namespace `Malkusch\Lock`.
 
 ### Mutex
 
-The [`Malkusch\Lock\Mutex\Mutex`][5] class is an abstract class and provides the
-base API for this library.
+The [`Malkusch\Lock\Mutex\Mutex`][5] interface provides the base API for this library.
 
 #### Mutex::synchronized()
 
@@ -125,9 +124,9 @@ if ($newBalance === false) {
 }
 ```
 
-### Extracting code result after lock release exception
+#### Extracting code result after lock release exception
 
-Mutex implementations based on [`Malkush\Lock\Mutex\LockMutex`][10] will throw
+Mutex implementations based on [`Malkush\Lock\Mutex\AbstractLockMutex`][10] will throw
 [`Malkusch\Lock\Exception\LockReleaseException`][11] in case of lock release
 problem, but the synchronized code block will be already executed at this point.
 In order to read the code result (or an exception thrown there),
@@ -160,9 +159,8 @@ try {
 
 ### Implementations
 
-Because the [`Malkusch\Lock\Mutex\Mutex`](#mutex) class is an abstract class,
-you can choose from one of the provided implementations or create/extend your
-own implementation.
+You can choose from one of the provided [`Malkusch\Lock\Mutex\Mutex`](#mutex) interface
+implementations or create/extend your own implementation.
 
 - [`FlockMutex`](#flockmutex)
 - [`MemcachedMutex`](#memcachedmutex)
@@ -171,7 +169,7 @@ own implementation.
 - [`SemaphoreMutex`](#semaphoremutex)
 - [`TransactionalMutex`](#transactionalmutex)
 - [`MySQLMutex`](#mysqlmutex)
-- [`PgAdvisoryLockMutex`](#pgadvisorylockmutex)
+- [`PostgreSQLMutex`](#PostgreSQLMutex)
 
 #### FlockMutex
 
@@ -342,9 +340,9 @@ $mutex->synchronized(function () use ($bankAccount, $amount) {
 });
 ```
 
-#### PgAdvisoryLockMutex
+#### PostgreSQLMutex
 
-The **PgAdvisoryLockMutex** uses PostgreSQL's
+The **PostgreSQLMutex** uses PostgreSQL's
 [advisory locking](https://www.postgresql.org/docs/9.4/static/functions-admin.html#FUNCTIONS-ADVISORY-LOCKS)
 functions.
 
@@ -357,7 +355,7 @@ interrupted, the lock is automatically released.
 ```php
 $pdo = new \PDO('pgsql:host=localhost;dbname=test', 'username');
 
-$mutex = new PgAdvisoryLockMutex($pdo, 'balance');
+$mutex = new PostgreSQLMutex($pdo, 'balance');
 $mutex->synchronized(function () use ($bankAccount, $amount) {
     $balance = $bankAccount->getBalance();
     $balance -= $amount;

src/Exception/ExecutionOutsideLockException.php

@@ -14,7 +14,7 @@
  *
  * Should only be used in contexts where the is being released.
  *
- * @see \Malkusch\Lock\Mutex\SpinlockMutex::unlock()
+ * @see \Malkusch\Lock\Mutex\AbstractSpinlockMutex::unlock()
  */
 class ExecutionOutsideLockException extends LockReleaseException
 {

src/Mutex/LockMutex.php renamed to src/Mutex/AbstractLockMutex.php

@@ -12,7 +12,7 @@
  *
  * @internal
  */
-abstract class LockMutex extends Mutex
+abstract class AbstractLockMutex extends AbstractMutex
 {
     /**
      * Acquires the lock.

src/Mutex/AbstractMutex.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Malkusch\Lock\Mutex;
+
+use Malkusch\Lock\Util\DoubleCheckedLocking;
+
+abstract class AbstractMutex implements Mutex
+{
+    #[\Override]
+    public function check(callable $check): DoubleCheckedLocking
+    {
+        return new DoubleCheckedLocking($this, $check);
+    }
+}

src/Mutex/SpinlockMutex.php renamed to src/Mutex/AbstractSpinlockMutex.php

@@ -15,7 +15,7 @@
  *
  * @internal
  */
-abstract class SpinlockMutex extends LockMutex
+abstract class AbstractSpinlockMutex extends AbstractLockMutex
 {
     /** @var float The timeout in seconds a lock may live */
     private $timeout;

src/Mutex/FlockMutex.php

@@ -14,7 +14,7 @@
 /**
  * Flock() based mutex implementation.
  */
-class FlockMutex extends LockMutex
+class FlockMutex extends AbstractLockMutex
 {
     public const INFINITE_TIMEOUT = -1.0;
 

src/Mutex/MemcachedMutex.php

@@ -7,7 +7,7 @@
 /**
  * Memcached based spinlock implementation.
  */
-class MemcachedMutex extends SpinlockMutex
+class MemcachedMutex extends AbstractSpinlockMutex
 {
     /** @var \Memcached */
     private $memcache;

src/Mutex/Mutex.php

@@ -10,9 +10,9 @@
 use Malkusch\Lock\Util\DoubleCheckedLocking;
 
 /**
- * The mutex provides methods for exclusive execution.
+ * Mutex interface for exclusive execution.
  */
-abstract class Mutex
+interface Mutex
 {
     /**
      * Executes a block of code exclusively.
@@ -35,7 +35,7 @@ abstract class Mutex
      * @throws LockReleaseException          The mutex could not be released, the code was already executed
      * @throws ExecutionOutsideLockException Some code has been executed outside of the lock
      */
-    abstract public function synchronized(callable $code);
+    public function synchronized(callable $code);
 
     /**
      * Performs a double-checked locking pattern.
@@ -57,8 +57,5 @@ abstract public function synchronized(callable $code);
      *
      * @return DoubleCheckedLocking The double-checked locking pattern
      */
-    public function check(callable $check): DoubleCheckedLocking
-    {
-        return new DoubleCheckedLocking($this, $check);
-    }
+    public function check(callable $check): DoubleCheckedLocking;
 }

src/Mutex/MySQLMutex.php

@@ -8,7 +8,7 @@
 use Malkusch\Lock\Exception\TimeoutException;
 use Malkusch\Lock\Util\LockUtil;
 
-class MySQLMutex extends LockMutex
+class MySQLMutex extends AbstractLockMutex
 {
     /** @var \PDO */
     private $pdo;

src/Mutex/NoMutex.php

@@ -10,7 +10,7 @@
  * Synchronization is not provided! This mutex is just implementing the
  * interface without locking.
  */
-class NoMutex extends Mutex
+class NoMutex extends AbstractMutex
 {
     #[\Override]
     public function synchronized(callable $code)