Groovy 2.2.0

groovy.beans
[Groovy] Annotation Type ListenerList

java.lang.Object
  groovy.beans.ListenerList

@Documented
@Retention(RetentionPolicy.SOURCE)
@Target(ElementType.FIELD)
@GroovyASTTransformationClass('groovy.beans.ListenerListASTTransformation')
@interface ListenerList

This annotation adds Java-style listener support to a class based on an annotated Collection-property.

For any given Collection property, several methods will be written into the enclosing class during the compile phase. These changes are visible from Java or other languages. The List is intended to hold listeners of some sort, and the methods addListener, removeListener, and getListeners are all added to the class. The actual methods names depend on the generic type of the collection.

Given the following example:

 class MyClass {
     @groovy.beans.ListenerList
     List<java.awt.event.ActionListener> listeners
 }
 
The following code is generated:
 public class MyClass extends java.lang.Object {
     @groovy.beans.ListenerList
     private java.util.List<java.awt.event.ActionListener> listeners

     public void addActionListener(java.awt.event.ActionListener listener) {
         if ( listener == null) {
             return null
         }
         if ( listeners == null) {
             listeners = []
         }
         listeners.add(listener)
     }

     public void removeActionListener(java.awt.event.ActionListener listener) {
         if ( listener == null) {
             return null
         }
         if ( listeners == null) {
             listeners = []
         }
         listeners.remove(listener)
     }

     public java.awt.event.ActionListener[] getActionListeners() {
         java.lang.Object __result = []
         if ( listeners != null) {
             __result.addAll(listeners)
         }
         return (( __result ) as java.awt.event.ActionListener[])
     }

     public void fireActionPerformed(java.awt.event.ActionEvent param0) {
         if ( listeners != null) {
             def __list = new java.util.ArrayList(listeners)
             for (java.lang.Object listener : __list ) {
                 listener.actionPerformed(param0)
             }
         }
     }
 }
 
A fire method is created for each public method in the target class. In this case, ActionListener only has one method. For a four method interface, four fire methods would be created.

The annotation can take the following parameters:

 name        = a suffix for creating the add, remove, and get methods.
               Default: Name of the listener type
               In the above example, if name is set to MyListener, then the class will have an addMyListener,
               removeMyListener, and getMyListeners methods. 

 synchronize = Whether or not the methods created should be synchronized at the method level. 
               Default: false
 

Compilation Errors - Using this annotation incorrectly results in compilation errors rather than runtime errors. A list of potential problems includes:

Authors:
Alexander Klein
Hamlet D'Arcy
See Also:
ListenerListASTTransformation


Method Summary
String name()

A suffix for creating the add, remove, and get methods defaulting to the name of the listener type, e.g. if name is set to MyListener, then the class will have addMyListener, removeMyListener, and getMyListeners methods.

boolean synchronize()

Whether or not the methods created should be synchronized at the method level.

 
Methods inherited from class Object
wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll
 

Method Detail

name

String name()
A suffix for creating the add, remove, and get methods defaulting to the name of the listener type, e.g. if name is set to MyListener, then the class will have addMyListener, removeMyListener, and getMyListeners methods.
Default:
""


synchronize

boolean synchronize()
Whether or not the methods created should be synchronized at the method level.
Default:
false


 

Copyright &copy; 2003-2013 The Codehaus. All rights reserved.