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.