first commit

libraries/legacy/base/observer.php

@@ -0,0 +1,60 @@
+<?php
+/**
+ * @package     Joomla.Legacy
+ * @subpackage  Base
+ *
+ * @copyright   Copyright (C) 2005 - 2013 Open Source Matters, Inc. All rights reserved.
+ * @license     GNU General Public License version 2 or later; see LICENSE
+ */
+
+defined('JPATH_PLATFORM') or die;
+
+/**
+ * Abstract observer class to implement the observer design pattern
+ *
+ * @package     Joomla.Legacy
+ * @subpackage  Base
+ * @since       11.1
+ * @deprecated  12.3 (Platform) & 4.0 (CMS)
+ * @codeCoverageIgnore
+ */
+abstract class JObserver extends JObject
+{
+	/**
+	 * Event object to observe.
+	 *
+	 * @var    object
+	 * @since  11.1
+	 * @deprecated  12.3
+	 */
+	protected $_subject = null;
+
+	/**
+	 * Constructor
+	 *
+	 * @param   object  &$subject  The object to observe.
+	 *
+	 * @since   11.1
+	 * @deprecated  12.3
+	 */
+	public function __construct(&$subject)
+	{
+		// Register the observer ($this) so we can be notified
+		$subject->attach($this);
+
+		// Set the subject to observe
+		$this->_subject = &$subject;
+	}
+
+	/**
+	 * Method to update the state of observable objects
+	 *
+	 * @param   array  &$args  An array of arguments to pass to the listener.
+	 *
+	 * @return  mixed
+	 *
+	 * @since   11.1
+	 * @deprecated  12.3
+	 */
+	public abstract function update(&$args);
+}