2015-08-19 22:56:00 +02:00
|
|
|
<?php
|
2015-08-29 08:40:10 +02:00
|
|
|
|
2016-08-18 18:04:48 +02:00
|
|
|
namespace Amp\Concurrent\Threading;
|
|
|
|
|
|
|
|
use Amp\Concurrent\Sync\Parcel as SyncParcel;
|
|
|
|
use Amp\Coroutine;
|
|
|
|
use Interop\Async\Awaitable;
|
2015-08-19 22:56:00 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* A thread-safe container that shares a value between multiple threads.
|
|
|
|
*/
|
2016-08-18 18:04:48 +02:00
|
|
|
class Parcel implements SyncParcel {
|
2015-09-03 00:23:22 +02:00
|
|
|
/**
|
2016-08-18 18:04:48 +02:00
|
|
|
* @var \Amp\Concurrent\Threading\Mutex
|
2015-09-03 00:23:22 +02:00
|
|
|
*/
|
2015-08-19 22:56:00 +02:00
|
|
|
private $mutex;
|
2015-09-03 00:23:22 +02:00
|
|
|
|
|
|
|
/**
|
2016-08-18 18:04:48 +02:00
|
|
|
* @var \Amp\Concurrent\Threading\Internal\Storage
|
2015-09-03 00:23:22 +02:00
|
|
|
*/
|
2015-08-29 08:40:10 +02:00
|
|
|
private $storage;
|
2015-08-19 22:56:00 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates a new shared object container.
|
|
|
|
*
|
|
|
|
* @param mixed $value The value to store in the container.
|
|
|
|
*/
|
2016-08-19 00:36:58 +02:00
|
|
|
public function __construct($value) {
|
2015-09-04 01:11:58 +02:00
|
|
|
$this->init($value);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param mixed $value
|
|
|
|
*/
|
2016-08-19 00:36:58 +02:00
|
|
|
private function init($value) {
|
2015-08-29 08:40:10 +02:00
|
|
|
$this->mutex = new Mutex();
|
2015-09-04 01:11:58 +02:00
|
|
|
$this->storage = new Internal\Storage($value);
|
2015-08-19 22:56:00 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2015-08-20 21:13:01 +02:00
|
|
|
* {@inheritdoc}
|
2015-08-19 22:56:00 +02:00
|
|
|
*/
|
2016-08-18 18:04:48 +02:00
|
|
|
public function unwrap() {
|
2015-08-29 08:40:10 +02:00
|
|
|
return $this->storage->get();
|
2015-08-19 22:56:00 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2015-08-20 21:13:01 +02:00
|
|
|
* {@inheritdoc}
|
2015-08-19 22:56:00 +02:00
|
|
|
*/
|
2016-08-18 18:04:48 +02:00
|
|
|
protected function wrap($value) {
|
2015-08-29 08:40:10 +02:00
|
|
|
$this->storage->set($value);
|
2015-08-19 22:56:00 +02:00
|
|
|
}
|
|
|
|
|
2016-08-18 18:04:48 +02:00
|
|
|
/**
|
|
|
|
* @return \Interop\Async\Awaitable
|
|
|
|
*/
|
|
|
|
public function synchronized(callable $callback): Awaitable {
|
|
|
|
return new Coroutine($this->doSynchronized($callback));
|
|
|
|
}
|
|
|
|
|
2015-08-19 22:56:00 +02:00
|
|
|
/**
|
2015-08-29 08:40:10 +02:00
|
|
|
* @coroutine
|
|
|
|
*
|
2015-09-04 01:11:58 +02:00
|
|
|
* Asynchronously invokes a callable while maintaining an exclusive lock on the container.
|
2015-08-19 22:56:00 +02:00
|
|
|
*
|
2015-09-04 01:11:58 +02:00
|
|
|
* @param callable<mixed> $callback The function to invoke. The value in the container will be passed as the first
|
|
|
|
* argument.
|
2015-08-19 22:56:00 +02:00
|
|
|
*
|
|
|
|
* @return \Generator
|
|
|
|
*/
|
2016-08-18 18:04:48 +02:00
|
|
|
private function doSynchronized(callable $callback): \Generator {
|
|
|
|
/** @var \Amp\Concurrent\Sync\Lock $lock */
|
|
|
|
$lock = yield $this->mutex->acquire();
|
2015-08-19 22:56:00 +02:00
|
|
|
|
|
|
|
try {
|
2015-10-18 09:12:46 +02:00
|
|
|
$value = $this->unwrap();
|
2016-08-18 18:04:48 +02:00
|
|
|
$result = $callback($value);
|
|
|
|
|
|
|
|
if ($result instanceof \Generator) {
|
|
|
|
$result = new Coroutine($result);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($result instanceof Awaitable) {
|
|
|
|
yield $result;
|
|
|
|
}
|
|
|
|
|
2015-10-18 09:12:46 +02:00
|
|
|
$this->wrap(null === $result ? $value : $result);
|
2015-08-19 22:56:00 +02:00
|
|
|
} finally {
|
|
|
|
$lock->release();
|
|
|
|
}
|
2016-01-23 07:00:56 +01:00
|
|
|
|
|
|
|
return $result;
|
2015-08-19 22:56:00 +02:00
|
|
|
}
|
2015-08-20 21:13:01 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* {@inheritdoc}
|
|
|
|
*/
|
2016-08-18 18:04:48 +02:00
|
|
|
public function __clone() {
|
2015-09-04 01:11:58 +02:00
|
|
|
$this->init($this->unwrap());
|
2015-08-20 21:13:01 +02:00
|
|
|
}
|
2015-08-19 22:56:00 +02:00
|
|
|
}
|