@GroovyASTTransformation(phase = CompilePhase.CANONICALIZATION) public class BindableASTTransformation extends Object implements ASTTransformation, org.objectweb.asm.Opcodes
Handles generation of code for the @Bindable
annotation when @Vetoable
is not present.
Generally, it adds (if needed) a PropertyChangeSupport field and the needed add/removePropertyChangeListener methods to support the listeners.
It also generates the setter and wires the setter through the PropertyChangeSupport.
If a Vetoable annotation is detected it does nothing and lets the VetoableASTTransformation handle all the changes.
Modifiers | Name | Description |
---|---|---|
protected static ClassNode |
boundClassNode |
Type Params | Return Type | Name and description |
---|---|---|
|
protected void |
addPropertyChangeSupport(ClassNode declaringClass) Adds the necessary field and methods to support property change support. |
|
protected Statement |
createBindableStatement(PropertyNode propertyNode, Expression fieldExpression) Creates a statement body similar to: this.firePropertyChange("field", field, field = value) |
|
protected void |
createSetterMethod(ClassNode declaringClass, PropertyNode propertyNode, String setterName, Statement setterBlock) Creates a setter method with the given body. |
|
public static boolean |
hasBindableAnnotation(AnnotatedNode node) Convenience method to see if an annotated node is @Bindable . |
|
protected boolean |
needsPropertyChangeSupport(ClassNode declaringClass, SourceUnit sourceUnit) Snoops through the declaring class and all parents looking for methods void addPropertyChangeListener(PropertyChangeListener) ,
void removePropertyChangeListener(PropertyChangeListener) , and
void firePropertyChange(String, Object, Object) . |
|
public void |
visit(ASTNode[] nodes, SourceUnit source) Handles the bulk of the processing, mostly delegating to other methods. |
Adds the necessary field and methods to support property change support.
Adds a new field:
protected final java.beans.PropertyChangeSupport this$PropertyChangeSupport = new java.beans.PropertyChangeSupport(this)
"
Also adds support methods:
public void addPropertyChangeListener(java.beans.PropertyChangeListener)
public void addPropertyChangeListener(String, java.beans.PropertyChangeListener)
public void removePropertyChangeListener(java.beans.PropertyChangeListener)
public void removePropertyChangeListener(String, java.beans.PropertyChangeListener)
public java.beans.PropertyChangeListener[] getPropertyChangeListeners()
declaringClass
- the class to which we add the support field and methods Creates a statement body similar to:
this.firePropertyChange("field", field, field = value)
propertyNode
- the field node for the propertyfieldExpression
- a field expression for setting the property valueCreates a setter method with the given body.
declaringClass
- the class to which we will add the setterpropertyNode
- the field to back the settersetterName
- the name of the settersetterBlock
- the statement representing the setter block Convenience method to see if an annotated node is @Bindable
.
node
- the node to check Snoops through the declaring class and all parents looking for methods
void addPropertyChangeListener(PropertyChangeListener)
,
void removePropertyChangeListener(PropertyChangeListener)
, and
void firePropertyChange(String, Object, Object)
. If any are defined all
must be defined or a compilation error results.
declaringClass
- the class to searchsourceUnit
- the source unit, for error reporting. @NotNull
.Handles the bulk of the processing, mostly delegating to other methods.
nodes
- the ast nodessource
- the source unit for the nodes