    All Packages  Class Hierarchy  This Package  Previous  Next  Index

# Class org.w3c.util.ObservableProperties

    java.lang.Object
       |
       +----java.util.Dictionary
               |
               +----java.util.Hashtable
                       |
                       +----java.util.Properties
                               |
                               +----org.w3c.util.ObservableProperties

public class ObservableProperties
extends Properties

An enhanced property class that provides support to monitor changes. This class extends the basic properties class of Java, by providing monitoring support. It also provides more type conversion.

See Also:
  PropertyMonitoring

##

ObservableProperties(Properties)
  Build an httpdProperties instance from a Properties instance.

##

getBoolean(String, boolean)
  Get this property value, as a boolean.
getDouble(String, double)
  Get this property value, as a double.
getFile(String, File)
  Get this property value, as a File.
getInteger(String, int)
  Get this property value, as an integer.
getLong(String, long)
getString(String, String)
  Get this property value, as a String.
getStringArray(String, String[])
  Get this property as a String array.
putValue(String, String)
  Update a property value.
registerObserver(PropertyMonitoring)
  Subscribe for property monitoring.
unregisterObserver(PropertyMonitoring)
  Unsubscribe this object from the observers list.

##

ObservableProperties

     public ObservableProperties(Properties props)

  Build an httpdProperties instance from a Properties instance.

  Parameters:
    props - The Properties instance.

##

registerObserver

     public synchronized void registerObserver(PropertyMonitoring o)

  Subscribe for property monitoring.

  Parameters:
    observer - The object that handles the PropertyMonitoring interface.

unregisterObserver

     public synchronized boolean unregisterObserver(PropertyMonitoring o)

  Unsubscribe this object from the observers list.

  Parameters:
    observer - The observer to unsubscribe.
  Returns:
    A boolean true if object was succesfully unsubscribed, false otherwise.

putValue

     public synchronized boolean putValue(String name,
                                          String value)

  Update a property value. Assign a value to a property. If the property value has really changed notify our observers of the change.

  Parameters:
    name - The name of the property to assign.
    value - The new value for this property, or null if the property setting is to be cancelled.
  Returns:
    A boolean true if change was accepted by our observers, false otherwise.

getBoolean

     public boolean getBoolean(String name,
                               boolean def)

  Get this property value, as a boolean.

  Parameters:
    name - The name of the property to be fetched.
    def - The default value, if the property isn't defined.
  Returns:
    A Boolean instance.

getString

     public String getString(String name,
                             String def)

  Get this property value, as a String.

  Parameters:
    name - The name of the property to be fetched.
    def - The default value, if the property isn't defined.
  Returns:
    An instance of String.

getStringArray

     public String[] getStringArray(String name,
                                    String def[])

  Get this property as a String array. By convention, properties that are get as string arrays should be encoded as a | separated list of Strings.

  Parameters:
    name - The property's name.
    def - The default value (if undefined).
  Returns:
    A String array, or null if the property is undefined.

getInteger

     public int getInteger(String name,
                           int def)

  Get this property value, as an integer.

  Parameters:
    name - The name of the property to be fetched.
    def - The default value, if the property isn't defined.
  Returns:
    An integer value.

getLong

     public long getLong(String name,
                         long def)

getDouble

     public double getDouble(String name,
                             double def)

  Get this property value, as a double.

  Parameters:
    name - The name of the property.
    def - The default value if undefined.
  Returns:
    A double value.

getFile

     public File getFile(String name,
                         File def)

  Get this property value, as a File.

  Parameters:
    name - The name of the property to be fetched.
    def - The default value, if the property isn't defined.
  Returns:
    An instance of File.

    All Packages  Class Hierarchy  This Package  Previous  Next  Index