Listeners

Since: 2.1.0

Description: This extension-point is used to include one or more notification listeners in the host plugin's list of listeners to be notified of host menu events.

Configuration Markup:

   <!ELEMENT extension (listener*)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

• point - The fully-qualified name of the extension point. That is com.bolour.sample.eclipse.listener.subject.listeners.
• id - An optional id.
• name - An optional name.

   <!ELEMENT listener EMPTY>

   <!ATTLIST listener
     class CDATA #REQUIRED
   >

• class - The fully-qualified name of this listener's callback class. The class is instantiated by the host plugin, and the instance is added to the host plugin's notification list.

   <!-- Extend the listeners of the subject ... -->
   <extension
         id="listener.firstlistener"
         name="FirstListener"
         point="com.bolour.sample.eclipse.listener.subject.listeners">
      <!-- ... by a listener of type X ... -->
      <listener
            class="com.bolour.sample.eclipse.listener.firstlistener.ListenerX"/>
      <!-- and by a listener of type Y. -->
      <listener
            class="com.bolour.sample.eclipse.listener.firstlistener.ListenerY"/>
   </extension>         

API Information: Each listener callback must implement the interface com.bolour.sample.eclipse.listener.subject.IListener.

Supplied Implementation: An update of the subject plug-in causes a notification to be broadcast to all listeners.