Dali Provisional API
Release 3.2

org.eclipse.jpt.common.utility.model.event
Class PropertyChangeEvent

java.lang.Object
  extended by java.util.EventObject
      extended by org.eclipse.jpt.common.utility.model.event.ChangeEvent
          extended by org.eclipse.jpt.common.utility.model.event.PropertyChangeEvent
All Implemented Interfaces:
Serializable

public final class PropertyChangeEvent
extends ChangeEvent

A "property change" event gets delivered whenever a model changes a "bound" or "constrained" property. A PropertyChangeEvent is sent as an argument to the PropertyChangeListener. A PropertyChangeEvent is accompanied by the old and new values of the property.

Provisional API: This class is part of an interim API that is still under development and expected to change significantly before reaching stability. It is available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
PropertyChangeEvent(Model source, String propertyName, Object oldValue, Object newValue)
          Construct a new property change event.
 
Method Summary
 PropertyChangeEvent clone(Model newSource)
           
 PropertyChangeEvent clone(Model newSource, String newPropertyName)
          Return a copy of the event with the specified source and property name replacing the current source and property name.
 Object getNewValue()
          Return the new value of the property.
 Object getOldValue()
          Return the old value of the property.
 String getPropertyName()
          Return the programmatic name of the property that was changed.
protected  void toString(StringBuilder sb)
           
 
Methods inherited from class org.eclipse.jpt.common.utility.model.event.ChangeEvent
getSource, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

PropertyChangeEvent

public PropertyChangeEvent(Model source,
                           String propertyName,
                           Object oldValue,
                           Object newValue)
Construct a new property change event.

Parameters:
source - The object on which the event initially occurred.
propertyName - The programmatic name of the property that was changed.
oldValue - The old value of the property.
newValue - The new value of the property.
Method Detail

getPropertyName

public String getPropertyName()
Return the programmatic name of the property that was changed.


getOldValue

public Object getOldValue()
Return the old value of the property.


getNewValue

public Object getNewValue()
Return the new value of the property.


toString

protected void toString(StringBuilder sb)
Overrides:
toString in class ChangeEvent

clone

public PropertyChangeEvent clone(Model newSource)

clone

public PropertyChangeEvent clone(Model newSource,
                                 String newPropertyName)
Return a copy of the event with the specified source and property name replacing the current source and property name.


Dali Provisional API
Release 3.2

Copyright (c) 2012 Oracle. All rights reserved.