- md5
- 2150dfa17479c7597e50e1c0ba9d6aa8
- sha1
- b5389708f7155c1d4391017475dbdb3894e13322
- sha256
- 39371edff0380e99c47b24f37b4d860b879a7d37310e73c0af68b0b712a45e65
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116
<?php
/**
* Joomla! Content Management System
*
* @copyright Copyright (C) 2005 - 2016 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE
*/
namespace Joomla\CMS\Application;
defined('JPATH_PLATFORM') or die;
use Joomla\Event\DispatcherInterface;
use Joomla\Event\Event;
use Psr\Log\LoggerInterface;
/**
* Trait for application classes which dispatch events
*
* @since __DEPLOY_VERSION__
*/
trait EventAware
{
/**
* Get the event dispatcher.
*
* @return DispatcherInterface
*
* @since __DEPLOY_VERSION__
* @throws \UnexpectedValueException May be thrown if the dispatcher has not been set.
*/
abstract public function getDispatcher();
/**
* Get the logger.
*
* @return LoggerInterface
*
* @since __DEPLOY_VERSION__
*/
abstract public function getLogger();
/**
* Registers a handler to a particular event group.
*
* @param string $event The event name.
* @param callable $handler The handler, a function or an instance of an event object.
*
* @return $this
*
* @since __DEPLOY_VERSION__
*/
public function registerEvent($event, callable $handler)
{
try
{
$this->getDispatcher()->addListener($event, $handler);
}
catch (\UnexpectedValueException $e)
{
// No dispatcher is registered, don't throw an error (mimics old behavior)
}
return $this;
}
/**
* Calls all handlers associated with an event group.
*
* This is a legacy method, implementing old-style (Joomla! 3.x) plugin calls. It's best to go directly through the
* Dispatcher and handle the returned EventInterface object instead of going through this method. This method is
* deprecated and will be removed in Joomla! 5.x.
*
* This method will only return the 'result' argument of the event
*
* @param string $eventName The event name.
* @param array|Event $args An array of arguments or an Event object (optional).
*
* @return array An array of results from each function call. Note this will be an empty array if no dispatcher is set.
*
* @since __DEPLOY_VERSION__
* @throws \InvalidArgumentException
* @deprecated 5.0
*/
public function triggerEvent($eventName, $args = [])
{
try
{
$dispatcher = $this->getDispatcher();
}
catch (\UnexpectedValueException $exception)
{
$this->getLogger()->error(sprintf('Dispatcher not set in %s, cannot trigger events.', get_class($this)));
return [];
}
if ($args instanceof Event)
{
$event = $args;
}
elseif (is_array($args))
{
$event = new Event($eventName, $args);
}
else
{
throw new \InvalidArgumentException('The arguments must either be an event or an array');
}
$result = $dispatcher->dispatch($eventName, $event);
// TODO - There are still test cases where the result isn't defined, temporarily leave the isset check in place
return !isset($result['result']) || is_null($result['result']) ? [] : $result['result'];
}
}
No other release has this exact content. See every version of this file.