2016-12-29 21:09:49 +01:00
|
|
|
<?php
|
2016-08-16 06:46:26 +02:00
|
|
|
|
2016-05-24 05:48:28 +02:00
|
|
|
namespace Amp\Internal;
|
2016-05-21 16:44:52 +02:00
|
|
|
|
2017-03-28 01:37:55 +02:00
|
|
|
use Amp\Coroutine;
|
2016-05-24 05:48:28 +02:00
|
|
|
use Amp\Failure;
|
2017-03-10 22:32:58 +01:00
|
|
|
use Amp\Loop;
|
2017-03-10 21:58:46 +01:00
|
|
|
use Amp\Promise;
|
2017-02-20 21:53:58 +01:00
|
|
|
use React\Promise\PromiseInterface as ReactPromise;
|
2016-05-21 16:44:52 +02:00
|
|
|
|
2016-06-01 19:18:11 +02:00
|
|
|
/**
|
2016-11-14 20:59:21 +01:00
|
|
|
* Trait used by Promise implementations. Do not use this trait in your code, instead compose your class from one of
|
2017-03-10 21:58:46 +01:00
|
|
|
* the available classes implementing \Amp\Promise.
|
2016-06-01 19:18:11 +02:00
|
|
|
*
|
|
|
|
* @internal
|
|
|
|
*/
|
2016-05-21 16:44:52 +02:00
|
|
|
trait Placeholder {
|
2016-08-18 05:25:54 +02:00
|
|
|
/** @var bool */
|
2016-05-21 16:44:52 +02:00
|
|
|
private $resolved = false;
|
|
|
|
|
2016-08-18 05:25:54 +02:00
|
|
|
/** @var mixed */
|
2016-05-21 16:44:52 +02:00
|
|
|
private $result;
|
2016-12-23 23:48:24 +01:00
|
|
|
|
2017-03-21 17:23:37 +01:00
|
|
|
/** @var callable|\Amp\Internal\ResolutionQueue|null */
|
2016-05-21 16:44:52 +02:00
|
|
|
private $onResolved;
|
2016-12-23 23:48:24 +01:00
|
|
|
|
2017-03-29 17:25:44 +02:00
|
|
|
/** @var null|array */
|
|
|
|
private $resolutionTrace;
|
|
|
|
|
2016-05-21 16:44:52 +02:00
|
|
|
/**
|
2016-12-23 23:48:24 +01:00
|
|
|
* @inheritdoc
|
2016-05-21 16:44:52 +02:00
|
|
|
*/
|
2017-03-21 17:23:37 +01:00
|
|
|
public function onResolve(callable $onResolved) {
|
2016-05-21 16:44:52 +02:00
|
|
|
if ($this->resolved) {
|
2016-11-14 20:59:21 +01:00
|
|
|
if ($this->result instanceof Promise) {
|
2017-03-21 17:23:37 +01:00
|
|
|
$this->result->onResolve($onResolved);
|
2016-05-24 04:32:41 +02:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
try {
|
2017-03-28 01:37:55 +02:00
|
|
|
$result = $onResolved(null, $this->result);
|
|
|
|
|
|
|
|
if ($result === null) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($result instanceof \Generator) {
|
|
|
|
$result = new Coroutine($result);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($result instanceof Promise || $result instanceof ReactPromise) {
|
|
|
|
Promise\rethrow($result);
|
|
|
|
}
|
2016-05-24 04:32:41 +02:00
|
|
|
} catch (\Throwable $exception) {
|
2017-03-10 22:32:58 +01:00
|
|
|
Loop::defer(function () use ($exception) {
|
|
|
|
throw $exception;
|
|
|
|
});
|
2016-05-21 16:44:52 +02:00
|
|
|
}
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (null === $this->onResolved) {
|
|
|
|
$this->onResolved = $onResolved;
|
2016-06-17 06:27:14 +02:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2017-03-21 17:23:37 +01:00
|
|
|
if (!$this->onResolved instanceof ResolutionQueue) {
|
|
|
|
$this->onResolved = new ResolutionQueue($this->onResolved);
|
2016-05-21 16:44:52 +02:00
|
|
|
}
|
2016-06-17 06:27:14 +02:00
|
|
|
|
|
|
|
$this->onResolved->push($onResolved);
|
2016-05-21 16:44:52 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param mixed $value
|
2016-08-11 21:35:58 +02:00
|
|
|
*
|
2016-11-14 20:59:21 +01:00
|
|
|
* @throws \Error Thrown if the promise has already been resolved.
|
2016-05-21 16:44:52 +02:00
|
|
|
*/
|
2016-07-19 19:32:43 +02:00
|
|
|
private function resolve($value = null) {
|
2016-05-21 16:44:52 +02:00
|
|
|
if ($this->resolved) {
|
2017-03-29 17:25:44 +02:00
|
|
|
$message = "Promise has already been resolved";
|
|
|
|
|
|
|
|
if (isset($this->resolutionTrace)) {
|
|
|
|
$trace = formatStacktrace($this->resolutionTrace);
|
|
|
|
$message .= ". Previous resolution trace:\n\n{$trace}\n\n";
|
|
|
|
} else {
|
|
|
|
$message .= ", define const AMP_DEBUG_PLACEHOLDER_DOUBLE_RESOLUTION = true and enable assertions for a stacktrace of the previous resolution.";
|
|
|
|
}
|
|
|
|
|
|
|
|
throw new \Error($message);
|
2016-05-21 16:44:52 +02:00
|
|
|
}
|
|
|
|
|
2017-03-29 17:25:44 +02:00
|
|
|
assert((function () {
|
|
|
|
if (\defined("AMP_DEBUG_PLACEHOLDER_DOUBLE_RESOLUTION") && AMP_DEBUG_PLACEHOLDER_DOUBLE_RESOLUTION) {
|
|
|
|
$trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
|
|
|
|
array_shift($trace); // remove current closure
|
|
|
|
$this->resolutionTrace = $trace;
|
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
})());
|
|
|
|
|
2017-02-20 21:53:58 +01:00
|
|
|
if ($value instanceof ReactPromise) {
|
2017-03-28 01:37:55 +02:00
|
|
|
$value = Promise\adapt($value);
|
2017-02-20 21:53:58 +01:00
|
|
|
}
|
|
|
|
|
2016-05-21 16:44:52 +02:00
|
|
|
$this->resolved = true;
|
2016-06-15 04:53:50 +02:00
|
|
|
$this->result = $value;
|
2016-05-21 16:44:52 +02:00
|
|
|
|
2016-06-17 06:27:14 +02:00
|
|
|
if ($this->onResolved === null) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
$onResolved = $this->onResolved;
|
|
|
|
$this->onResolved = null;
|
2016-05-21 16:44:52 +02:00
|
|
|
|
2016-11-14 20:59:21 +01:00
|
|
|
if ($this->result instanceof Promise) {
|
2017-03-21 17:23:37 +01:00
|
|
|
$this->result->onResolve($onResolved);
|
2016-06-17 06:27:14 +02:00
|
|
|
return;
|
|
|
|
}
|
2016-12-23 23:48:24 +01:00
|
|
|
|
2016-06-17 06:27:14 +02:00
|
|
|
try {
|
2017-03-28 01:37:55 +02:00
|
|
|
$result = $onResolved(null, $this->result);
|
|
|
|
|
|
|
|
if ($result === null) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($result instanceof \Generator) {
|
|
|
|
$result = new Coroutine($result);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ($result instanceof Promise || $result instanceof ReactPromise) {
|
|
|
|
Promise\rethrow($result);
|
|
|
|
}
|
2016-06-17 06:27:14 +02:00
|
|
|
} catch (\Throwable $exception) {
|
2017-03-10 22:32:58 +01:00
|
|
|
Loop::defer(function () use ($exception) {
|
|
|
|
throw $exception;
|
|
|
|
});
|
2016-06-15 04:53:50 +02:00
|
|
|
}
|
2016-05-21 16:44:52 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-08-11 21:35:58 +02:00
|
|
|
* @param \Throwable $reason Failure reason.
|
2016-05-21 16:44:52 +02:00
|
|
|
*/
|
2016-08-11 21:35:58 +02:00
|
|
|
private function fail(\Throwable $reason) {
|
2016-05-21 16:44:52 +02:00
|
|
|
$this->resolve(new Failure($reason));
|
|
|
|
}
|
|
|
|
}
|