initial checkin

[m6w6/seekat] / lib / API / Deferred.php

diff --git a/lib/API/Deferred.php b/lib/API/Deferred.php
new file mode 100644 (file)
index 0000000..b55cb9d
--- /dev/null
+++ b/lib/API/Deferred.php
@@ -0,0 +1,117 @@
+<?php
+
+namespace seekat\API;
+
+use seekat\API;
+use http\Client;
+use http\Client\Request;
+use http\Client\Response;
+
+class Deferred extends \React\Promise\Deferred implements \SplObserver {
+
+       /**
+        * The endpoint
+        * @var \seekat\API
+        */
+       private $api;
+
+       /**
+        * The HTTP client
+        * @var \http\Client
+        */
+       private $client;
+
+       /**
+        * The executed request
+        * @var \http\Client\Request
+        */
+       private $request;
+
+       /**
+        * The promised response
+        * @var \http\Client\Response
+        */
+       private $response;
+
+       /**
+        * Create a deferred promise for the response of $request
+        *
+        * @var \seekat\API $api The endpoint of the request
+        * @var \http\Client $client The HTTP client to send the request
+        * @var \http\Client\Request The request to execute
+        */
+       function __construct(API $api, Client $client, Request $request) {
+               $this->api = $api;
+               $this->client = $client;
+               $this->request = $request;
+
+               $client->attach($this);
+               $client->enqueue($request);
+
+               parent::__construct(function($resolve, $reject) {
+                       return $this->cancel($resolve, $reject);
+               });
+       }
+
+       /**
+        * Progress observer
+        *
+        * Import the response's data on success and resolve the promise.
+        *
+        * @var \SplSubject $client The observed HTTP client
+        * @var \http\Client\Request The request which generated the update
+        * @var object $progress The progress information
+        */
+       function update(\SplSubject $client, Request $request = null, $progress = null) {
+               if ($request !== $this->request) {
+                       return;
+               }
+
+               $this->notify((object) compact("client", "request", "progress"));
+
+               if ($progress->info === "finished") {
+                       $this->response = $this->client->getResponse();
+                       $this->complete(
+                               [$this, "resolve"],
+                               [$this, "reject"]
+                       );
+               }
+       }
+
+       /**
+        * Completion callback
+        * @param callable $resolve
+        * @param callable $reject
+        */
+       private function complete(callable $resolve, callable $reject) {
+               $this->client->detach($this);
+
+               if ($this->response) {
+                       try {
+                               $resolve($this->api->import($this->response));
+                       } catch (\Exception $e) {
+                               $reject($e);
+                       }
+               } else {
+                       $reject($this->client->getTransferInfo($this->request)["error"]);
+               }
+
+               $this->client->dequeue($this->request);
+       }
+
+       /**
+        * Cancellation callback
+        * @param callable $resolve
+        * @param callable $reject
+        */
+       private function cancel(callable $resolve, callable $reject) {
+               /* did we finish in the meantime? */
+               if ($this->response) {
+                       $this->complete($resolve, $reject);
+               } else {
+                       $this->client->detach($this);
+                       $this->client->dequeue($this->request);
+                       $reject("Cancelled");
+               }
+       }
+}