de.javagl.common.beans

Class PropertyChangeListeners

java.lang.Object

de.javagl.common.beans.PropertyChangeListeners

public class PropertyChangeListeners
extends Object

Utility methods related to property change listeners

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PropertyChangeListeners.ObservedObject A class representing an object and all property change listeners that have been attached to it using addDeepPropertyChangeListener(java.lang.Object, java.beans.PropertyChangeListener).

Method Summary

Modifier and Type	Method and Description
static void	addDeepConsoleLogger(Object object) Attaches a deep property change listener to the given object, that generates logging information about the property change events, and prints them to the standard output.
static void	addDeepLogger(Object object) Attaches a deep property change listener to the given object, that generates logging information about the property change events, and prints them as INFO log messages.
static void	addDeepLogger(Object object, Consumer<? super String> consumer) Attaches a deep property change listener to the given object, that generates logging information about the property change events, and passes them to the given consumer.
static void	addDeepLogger(Object object, Level level) Attaches a deep property change listener to the given object, that generates logging information about the property change events, and prints them as log messages.
static PropertyChangeListeners.ObservedObject	addDeepPropertyChangeListener(Object object, PropertyChangeListener propertyChangeListener) Add the given property change listener to the given object and all its sub-objects, and make sure that the property change listener will be attached to all sub-objects that are set, and removed from all sub-objects that are removed.
static void	removeDeepPropertyChangeListener(Object object, PropertyChangeListener propertyChangeListener) Remove the given property change listener from the given object and all its sub-objects.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

addDeepLogger

public static void addDeepLogger(Object object)

Attaches a deep property change listener to the given object, that generates logging information about the property change events, and prints them as INFO log messages.

Parameters:

object - The object

addDeepLogger

public static void addDeepLogger(Object object,
                                 Level level)

Attaches a deep property change listener to the given object, that generates logging information about the property change events, and prints them as log messages.

Parameters:

object - The object

level - The log level

addDeepConsoleLogger

public static void addDeepConsoleLogger(Object object)

Attaches a deep property change listener to the given object, that generates logging information about the property change events, and prints them to the standard output.

Parameters:

object - The object

addDeepLogger

public static void addDeepLogger(Object object,
                                 Consumer<? super String> consumer)

Attaches a deep property change listener to the given object, that generates logging information about the property change events, and passes them to the given consumer.

Parameters:

object - The object

consumer - The log message consumer. May not be null.

addDeepPropertyChangeListener

public static PropertyChangeListeners.ObservedObject addDeepPropertyChangeListener(Object object,
                                                                                   PropertyChangeListener propertyChangeListener)

Add the given property change listener to the given object and all its sub-objects, and make sure that the property change listener will be attached to all sub-objects that are set, and removed from all sub-objects that are removed.

The returned PropertyChangeListeners.ObservedObject instance may be used to detach all property change listeners that have been attached with this call:

 ObservedObject observedObject =
     PropertyChangeListeners.addDeepPropertyChangeListener(someObject, p);
     
 // Set some properties, informing the PropertyChangeListeners
 someObject.setFoo("foo");
 someObject.getInnerObject().setBar("bar");
 
 // Detach the deep property change listener:
 observedObject.detach(); 
 

Parameters:

object - The object

propertyChangeListener - The property change listener

Returns:

The PropertyChangeListeners.ObservedObject

removeDeepPropertyChangeListener

public static void removeDeepPropertyChangeListener(Object object,
                                                    PropertyChangeListener propertyChangeListener)

Remove the given property change listener from the given object and all its sub-objects.

Parameters:

object - The object

propertyChangeListener - The property change listener