#19: Added a new exception

- Added `ExecutionOutsideLockException` which can be thrown when the lock is released or times out before the synchronized code finished execution.
- Changed `SpinlockMutex` to use the new `ExecutionOutsideLockException` when the synchronized code executes longer than the set timeout.

Author: TheLevti

classes/exception/ExecutionOutsideLockException.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace malkusch\lock\exception;
+
+/**
+ * This exception should be thrown when for example the lock is released or
+ * times out before the synchronized code finished execution.
+ *
+ * @see \malkusch\lock\mutex\SpinlockMutex::unlock()
+ *
+ * @author Petr Levtonov <[email protected]>
+ * @license WTFPL
+ */
+class ExecutionOutsideLockException extends LockReleaseException
+{
+}

classes/mutex/SpinlockMutex.php

@@ -2,9 +2,10 @@
 
 namespace malkusch\lock\mutex;
 
-use malkusch\lock\util\Loop;
-use malkusch\lock\exception\LockReleaseException;
+use malkusch\lock\exception\ExecutionOutsideLockException;
 use malkusch\lock\exception\LockAcquireException;
+use malkusch\lock\exception\LockReleaseException;
+use malkusch\lock\util\Loop;
 
 /**
  * Spinlock implementation.
@@ -79,11 +80,13 @@ protected function unlock()
         $elapsed = microtime(true) - $this->acquired;
         if ($elapsed >= $this->timeout) {
             $message = sprintf(
-                "The code executed for %d seconds. But the timeout is %d seconds.",
+                "The code executed for %.2f seconds. But the timeout is %d " .
+                "seconds. The last %.2f seconds were executed outside the lock.",
                 $elapsed,
-                $this->timeout
+                $this->timeout,
+                $elapsed - $this->timeout
             );
-            throw new LockReleaseException($message);
+            throw new ExecutionOutsideLockException($message);
         }
 
         /*