79 lines
1.7 KiB
PHP
79 lines
1.7 KiB
PHP
|
<?php
|
||
|
|
/**
|
||
|
|
* @package Joomla.Platform
|
||
|
|
* @subpackage Event
|
||
|
|
*
|
||
|
|
* @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;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* JEvent Class
|
||
|
|
*
|
||
|
|
* @package Joomla.Platform
|
||
|
|
* @subpackage Event
|
||
|
|
* @since 11.1
|
||
|
|
*/
|
||
|
|
abstract class JEvent extends JObject
|
||
|
|
{
|
||
|
|
/**
|
||
|
|
* Event object to observe.
|
||
|
|
*
|
||
|
|
* @var object
|
||
|
|
* @since 11.3
|
||
|
|
*/
|
||
|
|
protected $_subject = null;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Constructor
|
||
|
|
*
|
||
|
|
* @param object &$subject The object to observe.
|
||
|
|
*
|
||
|
|
* @since 11.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 trigger events.
|
||
|
|
* The method first generates the even from the argument array. Then it unsets the argument
|
||
|
|
* since the argument has no bearing on the event handler.
|
||
|
|
* If the method exists it is called and returns its return value. If it does not exist it
|
||
|
|
* returns null.
|
||
|
|
*
|
||
|
|
* @param array &$args Arguments
|
||
|
|
*
|
||
|
|
* @return mixed Routine return value
|
||
|
|
*
|
||
|
|
* @since 11.1
|
||
|
|
*/
|
||
|
|
public function update(&$args)
|
||
|
|
{
|
||
|
|
// First let's get the event from the argument array. Next we will unset the
|
||
|
|
// event argument as it has no bearing on the method to handle the event.
|
||
|
|
$event = $args['event'];
|
||
|
|
unset($args['event']);
|
||
|
|
|
||
|
|
/*
|
||
|
|
* If the method to handle an event exists, call it and return its return
|
||
|
|
* value. If it does not exist, return null.
|
||
|
|
*/
|
||
|
|
if (method_exists($this, $event))
|
||
|
|
{
|
||
|
|
return call_user_func_array(array($this, $event), $args);
|
||
|
|
}
|
||
|
|
else
|
||
|
|
{
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|