org.eigenbase.util.property

Class TriggerableProperties

java.lang.Object

java.util.Dictionary<K,V>

java.util.Hashtable<Object,Object>

java.util.Properties

org.eigenbase.util.property.TriggerableProperties

All Implemented Interfaces:

Serializable, Cloneable, Map<Object,Object>

public class TriggerableProperties
extends Properties

Base class for properties which can respond to triggers.

If you wish to be notified of changes to properties, use the Property.addTrigger(Trigger) method to register a callback.

Since:

5 July 2005

Version:

$Id$

Author:

Julian Hyde

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Map	properties
protected Map	triggers

Fields inherited from class java.util.Properties

defaults

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TriggerableProperties()

Method Summary

Methods

Modifier and Type	Method and Description
Collection	getProperties() Returns a collection of registered properties.
Property	getPropertyDefinition(String path) Returns the definition of a named property, or null if there is no such property.
List	getPropertyList() Returns a list of every Property.
void	register(Property property) Registers a property with this properties object to make it available for callbacks.
Object	setProperty(String key, String value) Sets the value of a property.
boolean	triggersAreEnabled() Whether triggers are enabled.

Methods inherited from class java.util.Properties

getProperty, getProperty, list, list, load, load, loadFromXML, propertyNames, save, store, store, storeToXML, storeToXML, stringPropertyNames

Methods inherited from class java.util.Hashtable

clear, clone, contains, containsKey, containsValue, elements, entrySet, equals, get, hashCode, isEmpty, keys, keySet, put, putAll, rehash, remove, size, toString, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

triggers

protected final Map triggers

properties

protected final Map properties

Constructor Detail

TriggerableProperties

protected TriggerableProperties()

Method Detail

setProperty

public Object setProperty(String key,
                 String value)

Sets the value of a property.

If the previous value does not equal the new value, executes any Triggers associated with the property, in order of their phase.

Overrides:

setProperty in class Properties

Parameters:

key - Name of property

value - Value

Returns:

the old value

triggersAreEnabled

public boolean triggersAreEnabled()

Whether triggers are enabled. Derived class can override.

getPropertyDefinition

public Property getPropertyDefinition(String path)

Returns the definition of a named property, or null if there is no such property.

Parameters:

path - Name of the property

Returns:

Definition of property, or null if there is no property with this name

register

public void register(Property property)

Registers a property with this properties object to make it available for callbacks.

getProperties

public Collection getProperties()

Returns a collection of registered properties.

Returns:

registered properties

getPropertyList

public List getPropertyList()

Returns a list of every Property.

Returns:

List of properties