Version 1
[yaffs-website] / vendor / gabordemooij / redbean / RedBeanPHP / Observable.php
diff --git a/vendor/gabordemooij/redbean/RedBeanPHP/Observable.php b/vendor/gabordemooij/redbean/RedBeanPHP/Observable.php
new file mode 100755 (executable)
index 0000000..8e3e6c7
--- /dev/null
@@ -0,0 +1,75 @@
+<?php
+
+namespace RedBeanPHP;
+
+use RedBeanPHP\Observer as Observer;
+
+/**
+ * Observable
+ * Base class for Observables
+ *
+ * @file            RedBeanPHP/Observable.php
+ * @author          Gabor de Mooij and the RedBeanPHP community
+ * @license         BSD/GPLv2
+ *
+ * @copyright
+ * copyright (c) G.J.G.T. (Gabor) de Mooij and the RedBeanPHP Community.
+ * This source file is subject to the BSD/GPLv2 License that is bundled
+ * with this source code in the file license.txt.
+ */
+abstract class Observable { //bracket must be here - otherwise coverage software does not understand.
+
+       /**
+        * @var array
+        */
+       private $observers = array();
+
+       /**
+        * Implementation of the Observer Pattern.
+        * Adds an event listener to the observable object.
+        * First argument should be the name of the event you wish to listen for.
+        * Second argument should be the object that wants to be notified in case
+        * the event occurs.
+        *
+        * @param string   $eventname event identifier
+        * @param Observer $observer  observer instance
+        *
+        * @return void
+        */
+       public function addEventListener( $eventname, Observer $observer )
+       {
+               if ( !isset( $this->observers[$eventname] ) ) {
+                       $this->observers[$eventname] = array();
+               }
+
+               foreach ( $this->observers[$eventname] as $o ) {
+                       if ( $o == $observer ) {
+                               return;
+                       }
+               }
+
+               $this->observers[$eventname][] = $observer;
+       }
+
+       /**
+        * Notifies listeners.
+        * Sends the signal $eventname, the event identifier and a message object
+        * to all observers that have been registered to receive notification for
+        * this event. Part of the observer pattern implementation in RedBeanPHP.
+        *
+        * @param string $eventname event you want signal
+        * @param mixed  $info      message object to send along
+        *
+        * @return void
+        */
+       public function signal( $eventname, $info )
+       {
+               if ( !isset( $this->observers[$eventname] ) ) {
+                       $this->observers[$eventname] = array();
+               }
+
+               foreach ( $this->observers[$eventname] as $observer ) {
+                       $observer->onEvent( $eventname, $info );
+               }
+       }
+}