add method getListenerPriority() to interface

symfony · Tobion · Oct 23, 2015 · Oct 20, 2015 · Oct 20, 2015 · f8019c80b4bab8dccd198a0bb7c954dfb5153cc3
commit f8019c80b4bab8dccd198a0bb7c954dfb5153cc3
diff --git a/UPGRADE-3.0.md b/UPGRADE-3.0.md
@@ -107,6 +107,8 @@ UPGRADE FROM 2.x to 3.0

 ### EventDispatcher

+ * The method `getListenerPriority($eventName, $listener)` has been added to the
+   `EventDispatcherInterface`.
 * The interface `Symfony\Component\EventDispatcher\Debug\TraceableEventDispatcherInterface`
   extends `Symfony\Component\EventDispatcher\EventDispatcherInterface`.


diff --git a/src/Symfony/Component/EventDispatcher/CHANGELOG.md b/src/Symfony/Component/EventDispatcher/CHANGELOG.md
@@ -4,6 +4,8 @@ CHANGELOG
 3.0.0
 -----

+  * The method `getListenerPriority($eventName, $listener)` has been added to the
+    `EventDispatcherInterface`.
  * The methods `Event::setDispatcher()`, `Event::getDispatcher()`, `Event::setName()`
    and `Event::getName()` have been removed.
    The event dispatcher and the event name are passed to the listener call.

diff --git a/src/Symfony/Component/EventDispatcher/EventDispatcher.php b/src/Symfony/Component/EventDispatcher/EventDispatcher.php
@@ -73,14 +73,7 @@ public function getListeners($eventName = null)
    }

    /**
-     * 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 to remove
-     *
-     * @return int|null The event listener priority
+     * {@inheritdoc}
     */
    public function getListenerPriority($eventName, $listener)
    {

diff --git a/src/Symfony/Component/EventDispatcher/EventDispatcherInterface.php b/src/Symfony/Component/EventDispatcher/EventDispatcherInterface.php
@@ -77,6 +77,18 @@ public function removeSubscriber(EventSubscriberInterface $subscriber);
     */
    public function getListeners($eventName = null);

+    /**
+     * 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);
+
    /**
     * Checks whether an event has any registered listeners.
     *