* * @author Arthur Schiwon * @author Christoph Wurst * @author Roeland Jago Douma * * @license GNU AGPL version 3 or any later version * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . * */ namespace OC\EventDispatcher; use function is_callable; use OCP\EventDispatcher\Event; use OCP\ILogger; use Symfony\Component\EventDispatcher\EventDispatcherInterface; use Symfony\Component\EventDispatcher\EventSubscriberInterface; class SymfonyAdapter implements EventDispatcherInterface { /** @var EventDispatcher */ private $eventDispatcher; /** @var ILogger */ private $logger; public function __construct(EventDispatcher $eventDispatcher, ILogger $logger) { $this->eventDispatcher = $eventDispatcher; $this->logger = $logger; } /** * Dispatches an event to all registered listeners. * * @param string $eventName The name of the event to dispatch. The name of * the event is the name of the method that is * invoked on listeners. * @param Event|null $event The event to pass to the event handlers/listeners * If not supplied, an empty Event instance is created * * @return void */ public function dispatch($eventName, $event = null) { // type hinting is not possible, due to usage of GenericEvent if ($event instanceof Event) { $this->eventDispatcher->dispatch($eventName, $event); } else { // Legacy event $this->logger->info( 'Deprecated event type for {name}: {class}', [ 'name' => $eventName, 'class' => is_object($event) ? get_class($event) : 'null' ] ); $this->eventDispatcher->getSymfonyDispatcher()->dispatch($eventName, $event); } } /** * Adds an event listener that listens on the specified events. * * @param string $eventName The event to listen on * @param callable $listener The listener * @param int $priority The higher this value, the earlier an event * listener will be triggered in the chain (defaults to 0) */ public function addListener($eventName, $listener, $priority = 0) { if (is_callable($listener)) { $this->eventDispatcher->addListener($eventName, $listener, $priority); } else { // Legacy listener $this->eventDispatcher->getSymfonyDispatcher()->addListener($eventName, $listener, $priority); } } /** * Adds an event subscriber. * * The subscriber is asked for all the events it is * interested in and added as a listener for these events. */ public function addSubscriber(EventSubscriberInterface $subscriber) { $this->eventDispatcher->getSymfonyDispatcher()->addSubscriber($subscriber); } /** * Removes an event listener from the specified events. * * @param string $eventName The event to remove a listener from * @param callable $listener The listener to remove */ public function removeListener($eventName, $listener) { $this->eventDispatcher->getSymfonyDispatcher()->removeListener($eventName, $listener); } public function removeSubscriber(EventSubscriberInterface $subscriber) { $this->eventDispatcher->getSymfonyDispatcher()->removeSubscriber($subscriber); } /** * Gets the listeners of a specific event or all listeners sorted by descending priority. * * @param string|null $eventName The name of the event * * @return array The event listeners for the specified event, or all event listeners by event name */ public function getListeners($eventName = null) { return $this->eventDispatcher->getSymfonyDispatcher()->getListeners($eventName); } /** * Gets the listener priority for a specific event. * * Returns null if the event or the listener does not exist. * * @param string $eventName The name of the event * @param callable $listener The listener * * @return int|null The event listener priority */ public function getListenerPriority($eventName, $listener) { return $this->eventDispatcher->getSymfonyDispatcher()->getListenerPriority($eventName, $listener); } /** * Checks whether an event has any registered listeners. * * @param string|null $eventName The name of the event * * @return bool true if the specified event has any listeners, false otherwise */ public function hasListeners($eventName = null) { return $this->eventDispatcher->getSymfonyDispatcher()->hasListeners($eventName); } }