[EventLoop] Add a timer interface and class.

nrk · nrk · commit 431f6f57cccc · 2013-01-12T18:01:29.000+01:00
They will be used to provide a much nicer abstraction for timers shared
among the various event loop implementations.
diff --git a/Timer/Timer.php b/Timer/Timer.php
@@ -0,0 +1,63 @@
+<?php
+
+namespace React\EventLoop\Timer;
+
+use InvalidArgumentException;
+use React\EventLoop\LoopInterface;
+
+class Timer implements TimerInterface
+{
+    protected $loop;
+    protected $interval;
+    protected $callback;
+    protected $periodic;
+    protected $data;
+
+    public function __construct(LoopInterface $loop, $interval, $callback, $periodic = false, $data = null)
+    {
+        if (false === is_callable($callback)) {
+            throw new InvalidArgumentException('The callback argument must be a valid callable object');
+        }
+
+        $this->loop = $loop;
+        $this->interval = (float) $interval;
+        $this->callback = $callback;
+        $this->periodic = (bool) $periodic;
+        $this->data = null;
+    }
+
+    public function getLoop()
+    {
+        return $this->loop;
+    }
+
+    public function getInterval()
+    {
+        return $this->interval;
+    }
+
+    public function getCallback()
+    {
+        return $this->callback;
+    }
+
+    public function setData($data)
+    {
+        $this->data = $data;
+    }
+
+    public function getData()
+    {
+        return $this->data;
+    }
+
+    public function isPeriodic()
+    {
+        return $this->periodic;
+    }
+
+    public function cancel()
+    {
+        $this->loop->cancelTimer($this);
+    }
+}
diff --git a/Timer/TimerInterface.php b/Timer/TimerInterface.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace React\EventLoop\Timer;
+
+interface TimerInterface
+{
+    public function getLoop();
+    public function getInterval();
+    public function getCallback();
+    public function setData($data);
+    public function getData();
+    public function isPeriodic();
+    public function cancel();
+}
