From 3b35e8b91ce94c292b46a296d034542ac5f0f6da Mon Sep 17 00:00:00 2001
From: Bharat Mediratta <bharat@menalto.com>
Date: Mon, 15 Dec 2008 08:56:18 +0000
Subject: Refresh kohana from upstream svn trunk r3771.

During this process, remove a considerable number of files from kohana
that we will not be needing in Gallery3, including the following files
and directories:
    kohana/application
    kohana/example.htaccess
    kohana/index.php
    kohana/install.php
    kohana/kohana.png
    kohana/modules/archive
    kohana/modules/auth
    kohana/modules/flot
    kohana/modules/gmaps
    kohana/modules/kodoc
    kohana/modules/payment
    kohana/modules/smarty
    kohana/modules/unit_test/i18n
    kohana/modules/unit_test/tests/Example_Test.php
    kohana/modules/unit_test/tests/Valid_Test.php
    kohana/system/config/captcha.php
    kohana/system/controllers/captcha.php
    kohana/system/fonts
    kohana/system/i18n
    kohana/system/libraries/Calendar.php
    kohana/system/libraries/Calendar_Event.php
    kohana/system/libraries/Captcha.php
    kohana/system/libraries/Tagcloud.php
    kohana/system/vendor
    kohana/system/views/pagination
    kohana/system/views/kohana_calendar.php
---
 kohana/libraries/Event_Observer.php | 70 +++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 kohana/libraries/Event_Observer.php

(limited to 'kohana/libraries/Event_Observer.php')

diff --git a/kohana/libraries/Event_Observer.php b/kohana/libraries/Event_Observer.php
new file mode 100644
index 00000000..a720d1aa
--- /dev/null
+++ b/kohana/libraries/Event_Observer.php
@@ -0,0 +1,70 @@
+<?php defined('SYSPATH') OR die('No direct access allowed.');
+/**
+ * Kohana event observer. Uses the SPL observer pattern.
+ *
+ * $Id$
+ *
+ * @package    Core
+ * @author     Kohana Team
+ * @copyright  (c) 2007-2008 Kohana Team
+ * @license    http://kohanaphp.com/license.html
+ */
+abstract class Event_Observer implements SplObserver {
+
+	// Calling object
+	protected $caller;
+
+	/**
+	 * Initializes a new observer and attaches the subject as the caller.
+	 *
+	 * @param   object  Event_Subject
+	 * @return  void
+	 */
+	public function __construct(SplSubject $caller)
+	{
+		// Update the caller
+		$this->update($caller);
+	}
+
+	/**
+	 * Updates the observer subject with a new caller.
+	 *
+	 * @chainable
+	 * @param   object  Event_Subject
+	 * @return  object
+	 */
+	public function update(SplSubject $caller)
+	{
+		if ( ! ($caller instanceof Event_Subject))
+			throw new Kohana_Exception('event.invalid_subject', get_class($caller), get_class($this));
+
+		// Update the caller
+		$this->caller = $caller;
+
+		return $this;
+	}
+
+	/**
+	 * Detaches this observer from the subject.
+	 *
+	 * @chainable
+	 * @return  object
+	 */
+	public function remove()
+	{
+		// Detach this observer from the caller
+		$this->caller->detach($this);
+
+		return $this;
+	}
+
+	/**
+	 * Notify the observer of a new message. This function must be defined in
+	 * all observers and must take exactly one parameter of any type.
+	 *
+	 * @param   mixed   message string, object, or array
+	 * @return  void
+	 */
+	abstract public function notify($message);
+
+} // End Event Observer
\ No newline at end of file
-- 
cgit v1.2.3