Responding to Changes in Configuration
It is sometimes desirable to have a Processor eagerly react when its properties are
changed. The onPropertyModified
method allows a Processor to do just
that. When a user changes the property values for a Processor, the
onPropertyModified
method will be called for each modified property.
The method takes three arguments: the PropertyDescriptor that indicates which property was
modified, the old value, and the new value. If the property had no previous value, the
second argument will be null
. If the property was removed, the third
argument will be null
. It is important to note that this method will be
called regardless of whether or not the values are valid. This method will be called only
when a value is actually modified, rather than being called when a user updates a
Processor without changing its value. At the point that this method is invoked, it is
guaranteed that the thread invoking this method is the only thread currently executing
code in the Processor, unless the Processor itself creates its own threads.