. */ #namespace Doctrine::Common::Event; /** * The EventManager is the central point of Doctrine's event listener system. * Listeners are registered on the manager and events are dispatched through the * manager. * * @author Roman Borschel * @author Guilherme Blanco * @since 2.0 */ class Doctrine_EventManager { /** * Map of registered listeners. * => * * @var array */ private $_listeners = array(); /** * Dispatches an event to all registered listeners. * * @param string|Event $event The name of the event or the event object. * @return boolean */ public function dispatchEvent($event) { $argIsCallback = is_string($event); $callback = $argIsCallback ? $event : $event->getType(); if (isset($this->_listeners[$callback])) { $event = $argIsCallback ? new Doctrine_Event($event) : $event; foreach ($this->_listeners[$callback] as $listener) { $listener->$callback($event); } return ! $event->getDefaultPrevented(); } return true; } /** * Gets the listeners of a specific event or all listeners. * * @param string $event The name of the event. * @return */ public function getListeners($event = null) { return $event ? $this->_listeners[$event] : $this->_listeners; } /** * Checks whether an event has any registered listeners. * * @param string $event * @return boolean */ public function hasListeners($event) { return isset($this->_listeners[$event]); } /** * Adds an event listener that listens on the specified events. * * @param string|array $events The event(s) to listen on. * @param object $listener The listener object. */ public function addEventListener($events, $listener) { // TODO: maybe check for duplicate registrations? if ( ! is_array($events)) { $events = array($events); } foreach ($events as $event) { $this->_listeners[$event] = $listener; } } /** * Adds an EventSubscriber. The subscriber is asked for all the events he is * interested in and added as a listener for these events. * * @param Doctrine::Common::Event::EventSubscriber $subscriber The subscriber. */ public function addEventSubscriber(Doctrine_EventSubscriber $subscriber) { $this->addEventListener($subscriber->getSubscribedEvents(), $subscriber); } } ?>