org.stringer.util
Class AbstractPreferences

java.lang.Object
  |
  +--org.stringer.util.AbstractPreferences

Direct Known Subclasses:

Preferences

public abstract class AbstractPreferences

extends java.lang.Object

This class provides a default implementation for a preferences framework. Methods are provided that can read and write native types, arrays and a few custom types.

Author:

R. Kevin Cole kcole@users.sourceforge.net

Field Summary

static java.lang.String	ARRAY_SEPARATOR
protected boolean	isDirtyFlag Determines if preferences need to be saved.
protected static org.apache.log4j.Logger	logger
protected java.lang.String	namespace The namespace is prefixed to each key.
protected int	oldVersion Version of database when read.
protected java.io.File	prefsFile Preferences database.
protected java.beans.PropertyChangeSupport	propertyChange
protected java.util.Properties	props Preferences.
protected int	version Version of database format.

Constructor Summary

AbstractPreferences(java.lang.String filename, int version, java.lang.String namespace)
Constructs a PreferencesSupport object.

Method Summary

void	addPropertyChangeListener(java.beans.PropertyChangeListener l) Adds a preferences listener.
void	addPropertyChangeListener(java.lang.String key, java.beans.PropertyChangeListener l) Adds a preferences listener for a specific key.
static boolean	areObjectsEqual(java.lang.Object[] obj1, java.lang.Object[] obj2) Determine if 2 arrays are equal, or both point to null.
static boolean	areObjectsEqual(java.lang.Object obj1, java.lang.Object obj2) Determine if 2 objects are equal, or both point to null.
void	firePropertyChange(java.lang.String key, java.lang.Object oldValue, java.lang.Object newValue) Fires PropertyChangeEvent without namespace.
java.lang.String	get(java.lang.String key)
boolean	getBoolean(java.lang.String key)
java.awt.Color	getColor(java.lang.String key)
java.lang.String	getFilename() Returns the absolute path of the preferences file.
java.awt.Font	getFont(java.lang.String key) Always returns a valid font.
int	getInt(java.lang.String key) Reads an integer from the properties.
int[]	getIntArray(java.lang.String key)
java.util.List	getList(java.lang.String key)
long	getLong(java.lang.String key)
int	getOldVersion() Returns the version of the preferences in the file at the point of the last read operation.
protected java.lang.String	getProperty(java.lang.String key, java.lang.String defaultValue) Returns a property.
java.lang.String[]	getStringArray(java.lang.String key)
int	getVersion() Returns the current version of the preferences.
void	read() Reads preferences from default preferences file.
void	read(java.io.File f) Reads preferences from f.
void	removeProperty(java.lang.String key) Ignores namespace.
void	removePropertyChangeListener(java.beans.PropertyChangeListener l) Remove a preferences listener.
void	renameProperty(java.lang.String oldKey, java.lang.String newKey) Renames a property, used for conversion of property file formats.
void	set(java.lang.String key, boolean newValue)
void	set(java.lang.String key, java.awt.Color newValue)
void	set(java.lang.String key, java.awt.Font newValue) Saves a font.
void	set(java.lang.String key, int newValue)
void	set(java.lang.String key, int[] newValue)
void	set(java.lang.String key, long newValue)
void	set(java.lang.String key, java.lang.String newValue)
void	set(java.lang.String key, java.lang.String[] newValue)
void	setDefault(java.lang.String key, java.lang.String value) Sets a default property.
void	setList(java.lang.String key, java.util.List list)
protected void	setProperty(java.lang.String key, java.lang.String newValue) Sets a property.
boolean	write() Writes preferences to default preferences file.

Methods inherited from class java.lang.Object

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

Field Detail

ARRAY_SEPARATOR

public static final java.lang.String ARRAY_SEPARATOR

See Also:

Constant Field Values

logger

protected static org.apache.log4j.Logger logger

propertyChange

protected transient java.beans.PropertyChangeSupport propertyChange

isDirtyFlag

protected boolean isDirtyFlag

Determines if preferences need to be saved.

prefsFile

protected java.io.File prefsFile

Preferences database.

version

protected int version

Version of database format.

oldVersion

protected int oldVersion

Version of database when read.

namespace

protected java.lang.String namespace

The namespace is prefixed to each key.

props

protected java.util.Properties props

Preferences.

Constructor Detail

AbstractPreferences

public AbstractPreferences(java.lang.String filename,
                           int version,
                           java.lang.String namespace)

Constructs a PreferencesSupport object.

Parameters:

filename - the filename of the preferences file

version - the current version of the preferences, this version can be more recent than the version of the file

namespace - the namespace, used as a prefix for all keys

Method Detail

getFilename

public java.lang.String getFilename()

Returns the absolute path of the preferences file.

read

public void read(java.io.File f)

Reads preferences from f.

read

public void read()

Reads preferences from default preferences file.

write

public boolean write()

Writes preferences to default preferences file. If preferences have not changed since the last read or write operation, no action is taken.

Returns:

true, if file is written successfully or preferences were not changed; false, if an IOException has occured

getOldVersion

public int getOldVersion()

Returns the version of the preferences in the file at the point of the last read operation.

getVersion

public int getVersion()

Returns the current version of the preferences.

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener l)

Adds a preferences listener.

addPropertyChangeListener

public void addPropertyChangeListener(java.lang.String key,
                                      java.beans.PropertyChangeListener l)

Adds a preferences listener for a specific key.

firePropertyChange

public void firePropertyChange(java.lang.String key,
                               java.lang.Object oldValue,
                               java.lang.Object newValue)

Fires PropertyChangeEvent without namespace.

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener l)

Remove a preferences listener.

get

public java.lang.String get(java.lang.String key)

setList

public void setList(java.lang.String key,
                    java.util.List list)

getList

public java.util.List getList(java.lang.String key)

Parameters:

key - A preferences key.

Returns:

a list of preferences associated with the key or an empty list if no associated preferences were found.

getBoolean

public boolean getBoolean(java.lang.String key)

getColor

public java.awt.Color getColor(java.lang.String key)

getFont

public java.awt.Font getFont(java.lang.String key)

Always returns a valid font.

getInt

public int getInt(java.lang.String key)

Reads an integer from the properties.

Returns:

0, if conversion fails; the value, otherwise

getIntArray

public int[] getIntArray(java.lang.String key)

getLong

public long getLong(java.lang.String key)

set

public void set(java.lang.String key,
                java.lang.String newValue)

set

public void set(java.lang.String key,
                java.lang.String[] newValue)

set

public void set(java.lang.String key,
                boolean newValue)

set

public void set(java.lang.String key,
                java.awt.Color newValue)

set

public void set(java.lang.String key,
                java.awt.Font newValue)

Saves a font.

set

public void set(java.lang.String key,
                int newValue)

set

public void set(java.lang.String key,
                int[] newValue)

set

public void set(java.lang.String key,
                long newValue)

setDefault

public void setDefault(java.lang.String key,
                       java.lang.String value)

Sets a default property. If key already exists the value is not overwritten.

If a key already exists, the corresponding value is validated by validator and will replaced by value if the validation fails.

Parameters:

key - the key

value - the default value

getStringArray

public java.lang.String[] getStringArray(java.lang.String key)

removeProperty

public void removeProperty(java.lang.String key)

Ignores namespace.

renameProperty

public void renameProperty(java.lang.String oldKey,
                           java.lang.String newKey)

Renames a property, used for conversion of property file formats. Ignores namespace. Does not fire change event.

getProperty

protected java.lang.String getProperty(java.lang.String key,
                                       java.lang.String defaultValue)

Returns a property.

setProperty

protected void setProperty(java.lang.String key,
                           java.lang.String newValue)

Sets a property. newValue is validated if validate is set to true and a validator has been provided.

Parameters:

key - the key to set

newValue - the value to set

areObjectsEqual

public static boolean areObjectsEqual(java.lang.Object obj1,
                                      java.lang.Object obj2)

Determine if 2 objects are equal, or both point to null.

areObjectsEqual

public static boolean areObjectsEqual(java.lang.Object[] obj1,
                                      java.lang.Object[] obj2)

Determine if 2 arrays are equal, or both point to null.