4 * This file is part of the Symfony package.
6 * (c) Fabien Potencier <fabien@symfony.com>
8 * For the full copyright and license information, please view the LICENSE
9 * file that was distributed with this source code.
12 namespace Symfony\Component\EventDispatcher;
14 use Symfony\Component\DependencyInjection\ContainerInterface;
17 * Lazily loads listeners and subscribers from the dependency injection
20 * @author Fabien Potencier <fabien@symfony.com>
21 * @author Bernhard Schussek <bschussek@gmail.com>
22 * @author Jordan Alliot <jordan.alliot@gmail.com>
24 class ContainerAwareEventDispatcher extends EventDispatcher
27 * The container from where services are loaded.
29 * @var ContainerInterface
34 * The service IDs of the event listeners and subscribers.
38 private $listenerIds = array();
41 * The services registered as listeners.
45 private $listeners = array();
50 * @param ContainerInterface $container A ContainerInterface instance
52 public function __construct(ContainerInterface $container)
54 $this->container = $container;
58 * Adds a service as event listener.
60 * @param string $eventName Event for which the listener is added
61 * @param array $callback The service ID of the listener service & the method
62 * name that has to be called
63 * @param int $priority The higher this value, the earlier an event listener
64 * will be triggered in the chain.
67 * @throws \InvalidArgumentException
69 public function addListenerService($eventName, $callback, $priority = 0)
71 if (!is_array($callback) || 2 !== count($callback)) {
72 throw new \InvalidArgumentException('Expected an array("service", "method") argument');
75 $this->listenerIds[$eventName][] = array($callback[0], $callback[1], $priority);
78 public function removeListener($eventName, $listener)
80 $this->lazyLoad($eventName);
82 if (isset($this->listenerIds[$eventName])) {
83 foreach ($this->listenerIds[$eventName] as $i => list($serviceId, $method, $priority)) {
84 $key = $serviceId.'.'.$method;
85 if (isset($this->listeners[$eventName][$key]) && $listener === array($this->listeners[$eventName][$key], $method)) {
86 unset($this->listeners[$eventName][$key]);
87 if (empty($this->listeners[$eventName])) {
88 unset($this->listeners[$eventName]);
90 unset($this->listenerIds[$eventName][$i]);
91 if (empty($this->listenerIds[$eventName])) {
92 unset($this->listenerIds[$eventName]);
98 parent::removeListener($eventName, $listener);
104 public function hasListeners($eventName = null)
106 if (null === $eventName) {
107 return $this->listenerIds || $this->listeners || parent::hasListeners();
110 if (isset($this->listenerIds[$eventName])) {
114 return parent::hasListeners($eventName);
120 public function getListeners($eventName = null)
122 if (null === $eventName) {
123 foreach ($this->listenerIds as $serviceEventName => $args) {
124 $this->lazyLoad($serviceEventName);
127 $this->lazyLoad($eventName);
130 return parent::getListeners($eventName);
136 public function getListenerPriority($eventName, $listener)
138 $this->lazyLoad($eventName);
140 return parent::getListenerPriority($eventName, $listener);
144 * Adds a service as event subscriber.
146 * @param string $serviceId The service ID of the subscriber service
147 * @param string $class The service's class name (which must implement EventSubscriberInterface)
149 public function addSubscriberService($serviceId, $class)
151 foreach ($class::getSubscribedEvents() as $eventName => $params) {
152 if (is_string($params)) {
153 $this->listenerIds[$eventName][] = array($serviceId, $params, 0);
154 } elseif (is_string($params[0])) {
155 $this->listenerIds[$eventName][] = array($serviceId, $params[0], isset($params[1]) ? $params[1] : 0);
157 foreach ($params as $listener) {
158 $this->listenerIds[$eventName][] = array($serviceId, $listener[0], isset($listener[1]) ? $listener[1] : 0);
164 public function getContainer()
166 return $this->container;
170 * Lazily loads listeners for this event from the dependency injection
173 * @param string $eventName The name of the event to dispatch. The name of
174 * the event is the name of the method that is
175 * invoked on listeners.
177 protected function lazyLoad($eventName)
179 if (isset($this->listenerIds[$eventName])) {
180 foreach ($this->listenerIds[$eventName] as list($serviceId, $method, $priority)) {
181 $listener = $this->container->get($serviceId);
183 $key = $serviceId.'.'.$method;
184 if (!isset($this->listeners[$eventName][$key])) {
185 $this->addListener($eventName, array($listener, $method), $priority);
186 } elseif ($listener !== $this->listeners[$eventName][$key]) {
187 parent::removeListener($eventName, array($this->listeners[$eventName][$key], $method));
188 $this->addListener($eventName, array($listener, $method), $priority);
191 $this->listeners[$eventName][$key] = $listener;