Class BeanMonitor

java.lang.Object
org.nuiton.util.beans.BeanMonitor
public class BeanMonitor extends Object
A monitor of beans. You indicates which properties to monitor (via the constructor). Then attach a bean to monitor via the method setBean(Object). The method clearModified() reset the states about modified properties. The method wasModified() tells if there was any modification on monitored properties for the attached bean since the last call to clearModified() (or setBean(Object). the method getModifiedProperties() gives you the names of monitored properties for the attached bean since the last call to clearModified() (or setBean(Object).
Since:
1.4.1
Author:
Tony Chemit - chemit@codelutin.com

  • Field Details

    • propertyNames

      protected final List<String> propertyNames
      Names of properties to watch or not on attached bean.

    • excludeMode

      protected boolean excludeMode
      If true, then listen to the properties which are not in the propertyNames

    • propertyDiffs

      protected final Map<String, PropertyDiff> propertyDiffs
      Names of monitored and modified properties for the attached bean.

    • listener

      protected final PropertyChangeListener listener
      The PropertyChangeListener which listen modification on bean only on monitored properties.

    • bean

      protected Object bean
      The bean to monitor.

  • Constructor Details

    • BeanMonitor

      public BeanMonitor(String... propertyNames)
      Constructor of monitor with property names to monitor.
      Parameters:
      propertyNames - the names of properties to monitor

    • BeanMonitor

      public BeanMonitor(boolean exclude, String... propertyNames)

  • Method Details

    • getBean

      public Object getBean()
      Obtains the monitored bean.
      Returns:
      the attached bean, or null if none attached.

    • wasModified

      public boolean wasModified()
      Tells if any of the monitored properties were modified on the attached bean since last call to clearModified() or setBean(Object).
      Returns:
      true if there were a modified monitored property on the attached bean, false otherwise.

    • getModifiedProperties

      public String[] getModifiedProperties()
      Obtains the names of monitored properties which has been touched for the attached bean since last call to clearModified() or setBean(Object).
      Returns:
      the array of property names to monitor.

    • getOriginalValues

      public Map<String,Object> getOriginalValues()
      Obtains the original values for all modified properties.
      Returns:
      the dictionnary of original values for modified properties

    • getPropertyDiffs

      public PropertyDiff[] getPropertyDiffs()
      Obtains the property diffs since the bean is monitoried.
      Returns:
      the property diffs since the bean is monitoried.
      Since:
      2.4

    • setBean

      public void setBean(Object bean)
      Sets the bean to monitor. As a side effect, it will attach the listener to new bean (if not null) and remove it from the previous bean attached (if not null). As a second side effect, it will always clean the modified states, using the method clearModified().
      Parameters:
      bean - the new bean to monitor

    • clearModified

      public void clearModified()
      To clear the modified states.

    • setProperties

      public void setProperties(String... properties)
      To change the list of properties to watch. Note: As a side-effect, we call a clearModified() method after having changed the list of properties to watch.
      Parameters:
      properties - the list of properties to watch on the bean.
      Since:
      3.0

    • isExcludeMode

      public boolean isExcludeMode()

    • setExcludeMode

      public void setExcludeMode(boolean excludeMode)