net.sf.sfac.setting
Class SettingsImpl

java.lang.Object
  net.sf.sfac.setting.SettingsImpl

All Implemented Interfaces:

Settings

public class SettingsImpl
extends Object
implements Settings

Default implementation of the Settings interface.
This class provides a 'Settings' service storing the settings in a java Property file.

The property are typed. The first time a property is accessed, it's type is set (the type is determined by the method called to access the property like getRectangleProperty). Subsequent access to this property must use the same type. This is done to improve efficiency because the propery can be stored with the proper type in the settings (wich avoids constant type conversions).
This class uses TypeHelper objects to manage each type of propery. Each helper knows how to convert a data type from and to string (as only string can be saved in properties). The helper class instance is also used to identify a data type.

For file properties, the base path used is the directory where the property file lies. This allow to move (or copy) the application easily without having to update all the file propeties with ne paths.

Author:

Olivier Berlanger

Field Summary

static TypeHelper<Boolean>	BOOLEAN_HELPER Helper for identifying and managing Boolean properties.
static TypeHelper<Color>	COLOR_HELPER Helper for identifying and managing Dimension properties.
static TypeHelper<Dimension>	DIMENSION_HELPER Helper for identifying and managing Dimension properties.
static TypeHelper<Double>	DOUBLE_HELPER Helper for identifying and managing Double properties.
static TypeHelper<int[]>	INT_ARRAY_HELPER Helper for identifying and managing int array properties.
static TypeHelper<Integer>	INTEGER_HELPER Helper for identifying and managing Integer properties.
static TypeHelper<String>	PASSWORD_HELPER Helper for identifying and managing String properties.
static TypeHelper<Rectangle>	RECTANGLE_HELPER Helper for identifying and managing Rectangle properties.
static TypeHelper<String[]>	STRING_ARRAY_HELPER Helper for identifying and managing String properties.
static TypeHelper<String>	STRING_HELPER Helper for identifying and managing String properties.

Constructor Summary

SettingsImpl(File propertyFile, String descr)
Construct a new settings implementation bound to a given property file.

Method Summary

void	addPropertyChangeListener(String settingKey, PropertyChangeListener listener) Add a PropertyChangeListener for a specific setting.
boolean	containsProperty(String key) Check if there is a property value defined for the given key.
boolean	getBooleanProperty(String key, boolean defaultValue) Get a boolean property value.
Boolean	getBooleanProperty(String key, Boolean defaultValue) Get a Boolean property value.
Color	getColorProperty(String key, Color defaultValue) Get a Color property value.
String	getDescription() Get the settings description (the one saved at the top of the properties file).
Dimension	getDimensionProperty(String key, Dimension defaultValue) Get a Dimension property value.
double	getDoubleProperty(String key, double defaultValue) Get a double property value.
<T extends Enum<T>> T	getEnumProperty(String key, T defaultValue) Get a enumerated property value.
FilePathUtils	getFilePathUtils() Get the FilePathUtils used to manage the file/directory settings.
String	getFileProperty(String key, String defaultValue) Get a absolute File or Directory property value.
String	getFileProperty(String key, String defaultValue, boolean absolute) Get a File or Directory property value.
int[]	getIntArrayProperty(String key, int[] defaultValue) Get a int array property value.
Integer	getIntegerProperty(String key, Integer defaultValue) Get a Integer property value.
int	getIntProperty(String key, int defaultValue) Get a int property value.
Iterator<String>	getKeys() Return an iterator for all the defined keys.
String	getPasswordProperty(String key, String defaultValue) Get a String property value to be used as a password.
<T> T	getProperty(String key, TypeHelper<T> helper, T defaultValue) Get a property of type defined by the helper.
String	getPropertyAsInternalString(String key) Get a property as stored internally by the map (as string).
String	getPropertyFilePath() Get the path to the property file used to store the settings.
Rectangle	getRectangleProperty(String key, Rectangle defaultValue) Get a Rectangle property value.
String[]	getStringArrayProperty(String key, String[] defaultValue) Get a String array property value.
String	getStringProperty(String key, String defaultValue) Get a String property value.
void	load() Load all the settings from the property file (if the file exists).
void	removeProperty(String key) Remove the property.
void	removePropertyChangeListener(String settingKey, PropertyChangeListener listener) Remove a PropertyChangeListener for a specific setting.
void	save() Save all the settings to the property file (if the file don't exists, it is created).
void	saveAs(File fil) Save all the settings to a new property file.
void	setBooleanProperty(String key, boolean value) Set a new value for a boolean property.
void	setBooleanProperty(String key, Boolean value) Set a new value for a Boolean property.
void	setColorProperty(String key, Color value) Set a new value for a Color property.
void	setDescription(String newDescr) Set the settings description (the one saved at the top of the properties file).
void	setDimensionProperty(String key, Dimension value) Set a new value for a Dimension property.
void	setDoubleProperty(String key, double value) Set a new value for a double property.
<T extends Enum<T>> void	setEnumProperty(String key, T value) Set a new value for a enumerated property.
void	setFileProperty(String key, String value) Set a new value for a File or Directory property.
void	setIntArrayProperty(String key, int[] value) Set a new value for a int array property.
void	setIntegerProperty(String key, Integer value) Set a new value for a Integer property.
void	setIntProperty(String key, int value) Set a new value for a int property.
void	setPasswordProperty(String key, String value) Set a new value for a String property.
<T> void	setProperty(String key, TypeHelper<T> helper, T value) Set a property of type defined by the helper.
void	setPropertyAsInternalString(String key, String value) Set a property value using its internal string representation.
void	setPropertyFile(File fil) Set a new property file to store the settings.
void	setRectangleProperty(String key, Rectangle value) Set a new value for a Rectangle property.
void	setStringArrayProperty(String key, String[] value) Set a new value for a String array property.
void	setStringProperty(String key, String value) Set a new value for a String property.

Methods inherited from class java.lang.Object

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

Field Detail

STRING_HELPER

public static final TypeHelper<String> STRING_HELPER

Helper for identifying and managing String properties.

PASSWORD_HELPER

public static final TypeHelper<String> PASSWORD_HELPER

Helper for identifying and managing String properties.

STRING_ARRAY_HELPER

public static final TypeHelper<String[]> STRING_ARRAY_HELPER

Helper for identifying and managing String properties.

INTEGER_HELPER

public static final TypeHelper<Integer> INTEGER_HELPER

Helper for identifying and managing Integer properties.

BOOLEAN_HELPER

public static final TypeHelper<Boolean> BOOLEAN_HELPER

Helper for identifying and managing Boolean properties.

DOUBLE_HELPER

public static final TypeHelper<Double> DOUBLE_HELPER

Helper for identifying and managing Double properties.

INT_ARRAY_HELPER

public static final TypeHelper<int[]> INT_ARRAY_HELPER

Helper for identifying and managing int array properties.

RECTANGLE_HELPER

public static final TypeHelper<Rectangle> RECTANGLE_HELPER

Helper for identifying and managing Rectangle properties.

DIMENSION_HELPER

public static final TypeHelper<Dimension> DIMENSION_HELPER

Helper for identifying and managing Dimension properties.

COLOR_HELPER

public static final TypeHelper<Color> COLOR_HELPER

Helper for identifying and managing Dimension properties.

Constructor Detail

SettingsImpl

public SettingsImpl(File propertyFile,
                    String descr)

Construct a new settings implementation bound to a given property file.

Parameters:

propertyFile - File where the properties are stored.

descr - Description of properties written as header in properties file.

Method Detail

getPropertyFilePath

public String getPropertyFilePath()

Description copied from interface: Settings

Get the path to the property file used to store the settings.
The returned path is absolute.

Specified by:

getPropertyFilePath in interface Settings

Returns:

The path to the property file used to store the settings.

getDescription

public String getDescription()

Get the settings description (the one saved at the top of the properties file).

Returns:

the settings description.

setDescription

public void setDescription(String newDescr)

Set the settings description (the one saved at the top of the properties file).

Parameters:

newDescr - the new settings description.

getFilePathUtils

public FilePathUtils getFilePathUtils()

Get the FilePathUtils used to manage the file/directory settings.
The returned FilePathUtils is set to use the same base directory as this class.

Specified by:

getFilePathUtils in interface Settings

Returns:

The FilePathUtils used to manage the file/directory settings.

load

public void load()
          throws IOException

Load all the settings from the property file (if the file exists).

Specified by:

load in interface Settings

Throws:

IOException - If something prevents the settings to be loaded.

save

public void save()
          throws IOException

Save all the settings to the property file (if the file don't exists, it is created).

Specified by:

save in interface Settings

Throws:

IOException - If something prevents the settings to be saved.

setPropertyFile

public void setPropertyFile(File fil)

Set a new property file to store the settings. The given property file will be set as new reference for paths.

Specified by:

setPropertyFile in interface Settings

Parameters:

fil - The new properties file.

saveAs

public void saveAs(File fil)
            throws IOException

Save all the settings to a new property file. If the file don't exists, it is created, if the file exists it is overriden without warning. The given property file will be set as new reference for paths.

Specified by:

saveAs in interface Settings

Parameters:

fil - The new properties file.

Throws:

IOException - If something prevents the settings to be saved.

containsProperty

public boolean containsProperty(String key)

Check if there is a property value defined for the given key.

Specified by:

containsProperty in interface Settings

Parameters:

key - Key for the value.

Returns:

True iff there is a property value defined for the given key.

getKeys

public Iterator<String> getKeys()

Description copied from interface: Settings

Return an iterator for all the defined keys.

Specified by:

getKeys in interface Settings

Returns:

an iterator for all the defined keys.

removeProperty

public void removeProperty(String key)

Description copied from interface: Settings

Remove the property.
If the property was not defined, it does nothing.

Specified by:

removeProperty in interface Settings

Parameters:

key - Key of the property to remove.

getPropertyAsInternalString

public String getPropertyAsInternalString(String key)

Description copied from interface: Settings

Get a property as stored internally by the map (as string).
This is used to act on the key/values independently actual type of the value (that can be not known yet). The actual format of the string object depends on the implementation.

Specified by:

getPropertyAsInternalString in interface Settings

Parameters:

key - Key for the property value.

Returns:

The property value associated to the given key using the internal string representation. returns null if the property is not defined.

setPropertyAsInternalString

public void setPropertyAsInternalString(String key,
                                        String value)

Description copied from interface: Settings

Set a property value using its internal string representation. Setting a null value will remove the property.

Specified by:

setPropertyAsInternalString in interface Settings

Parameters:

key - Key for the property value.

value - The new value of the property to associate to the given key.

getProperty

public <T> T getProperty(String key,
                         TypeHelper<T> helper,
                         T defaultValue)

Description copied from interface: Settings

Get a property of type defined by the helper. This method is useful when you want to extend this class to new types (by creating new TypeHelper classes). For properties using a pre-defined type you should use the type-specific method.

Note that if you create a new data type the same type helper INSTANCE should be used in all set and get for this type.

Specified by:

getProperty in interface Settings

Parameters:

key - Key for the property value.

helper - Helper identifying the value type and knowing how to convert between string and the requested type. If the helper is null, a string value is returned.

Returns:

The property value associated to the given key and of given type.

setProperty

public <T> void setProperty(String key,
                            TypeHelper<T> helper,
                            T value)

Description copied from interface: Settings

Set a property of type defined by the helper. This method is usefull when you want to extend this class to new types (by creating new TypeHelper classes). For properties using a pre-defined type you should use the type-specific method.
Giving a null value removes the property (values and keys are removed).
If the new value is different than the previous one, a property change event is fired.

Note that if you create a new data type the same type helper INSTANCE should be used in all set and get for this type.

Specified by:

setProperty in interface Settings

Parameters:

key - Key for the property value.

helper - Helper identifying the value type and knowing how to convert between string and the requested type. If the given helper is null, the property will be stored as string (with basic toString conversion in the backing properties map). When the given helper is null, no propertyChange event is generated.

value - The new value of the property to associate to the given key.

getStringProperty

public String getStringProperty(String key,
                                String defaultValue)

Description copied from interface: Settings

Get a String property value.

Specified by:

getStringProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setStringProperty

public void setStringProperty(String key,
                              String value)

Description copied from interface: Settings

Set a new value for a String property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setStringProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getPasswordProperty

public String getPasswordProperty(String key,
                                  String defaultValue)

Description copied from interface: Settings

Get a String property value to be used as a password.
The password will be obfuscated (obfuscation is much lighter that encryption, so don't store very sensitive password using this mechanism).

Specified by:

getPasswordProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setPasswordProperty

public void setPasswordProperty(String key,
                                String value)

Description copied from interface: Settings

Set a new value for a String property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value. The password will be obfuscated (obfuscation is much lighter that encryption, so don't store very sensitive password using this mechanism).

Specified by:

setPasswordProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getStringArrayProperty

public String[] getStringArrayProperty(String key,
                                       String[] defaultValue)

Description copied from interface: Settings

Get a String array property value.

Specified by:

getStringArrayProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setStringArrayProperty

public void setStringArrayProperty(String key,
                                   String[] value)

Description copied from interface: Settings

Set a new value for a String array property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setStringArrayProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getIntProperty

public int getIntProperty(String key,
                          int defaultValue)

Description copied from interface: Settings

Get a int property value.

Specified by:

getIntProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setIntProperty

public void setIntProperty(String key,
                           int value)

Description copied from interface: Settings

Set a new value for a int property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setIntProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getIntegerProperty

public Integer getIntegerProperty(String key,
                                  Integer defaultValue)

Description copied from interface: Settings

Get a Integer property value.

Specified by:

getIntegerProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setIntegerProperty

public void setIntegerProperty(String key,
                               Integer value)

Description copied from interface: Settings

Set a new value for a Integer property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setIntegerProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getDoubleProperty

public double getDoubleProperty(String key,
                                double defaultValue)

Description copied from interface: Settings

Get a double property value.

Specified by:

getDoubleProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setDoubleProperty

public void setDoubleProperty(String key,
                              double value)

Description copied from interface: Settings

Set a new value for a double property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setDoubleProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getBooleanProperty

public boolean getBooleanProperty(String key,
                                  boolean defaultValue)

Description copied from interface: Settings

Get a boolean property value.

Specified by:

getBooleanProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setBooleanProperty

public void setBooleanProperty(String key,
                               boolean value)

Description copied from interface: Settings

Set a new value for a boolean property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setBooleanProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getBooleanProperty

public Boolean getBooleanProperty(String key,
                                  Boolean defaultValue)

Description copied from interface: Settings

Get a Boolean property value.

Specified by:

getBooleanProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setBooleanProperty

public void setBooleanProperty(String key,
                               Boolean value)

Description copied from interface: Settings

Set a new value for a Boolean property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setBooleanProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getIntArrayProperty

public int[] getIntArrayProperty(String key,
                                 int[] defaultValue)

Description copied from interface: Settings

Get a int array property value.

Specified by:

getIntArrayProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setIntArrayProperty

public void setIntArrayProperty(String key,
                                int[] value)

Description copied from interface: Settings

Set a new value for a int array property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setIntArrayProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getRectangleProperty

public Rectangle getRectangleProperty(String key,
                                      Rectangle defaultValue)

Description copied from interface: Settings

Get a Rectangle property value.

Specified by:

getRectangleProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setRectangleProperty

public void setRectangleProperty(String key,
                                 Rectangle value)

Description copied from interface: Settings

Set a new value for a Rectangle property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setRectangleProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getDimensionProperty

public Dimension getDimensionProperty(String key,
                                      Dimension defaultValue)

Description copied from interface: Settings

Get a Dimension property value.

Specified by:

getDimensionProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setDimensionProperty

public void setDimensionProperty(String key,
                                 Dimension value)

Description copied from interface: Settings

Set a new value for a Dimension property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setDimensionProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getColorProperty

public Color getColorProperty(String key,
                              Color defaultValue)

Description copied from interface: Settings

Get a Color property value.

Specified by:

getColorProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.

Returns:

The value associated to the given key (or default value if no value was found).

setColorProperty

public void setColorProperty(String key,
                             Color value)

Description copied from interface: Settings

Set a new value for a Color property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setColorProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getEnumProperty

public <T extends Enum<T>> T getEnumProperty(String key,
                                             T defaultValue)

Description copied from interface: Settings

Get a enumerated property value.

Specified by:

getEnumProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key.
Note: this default value cannot be null, it must be a value of the enumeration.

Returns:

The value associated to the given key (or default value if no value was found).

setEnumProperty

public <T extends Enum<T>> void setEnumProperty(String key,
                                                T value)

Description copied from interface: Settings

Set a new value for a enumerated property.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setEnumProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

getFileProperty

public String getFileProperty(String key,
                              String defaultValue)

Description copied from interface: Settings

Get a absolute File or Directory property value.

Specified by:

getFileProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key. (if used, the default value will be processed to ensure it's absolute)

Returns:

The value associated to the given key (or default value if no value was found).

getFileProperty

public String getFileProperty(String key,
                              String defaultValue,
                              boolean absolute)

Description copied from interface: Settings

Get a File or Directory property value.

Specified by:

getFileProperty in interface Settings

Parameters:

key - Key for the value.

defaultValue - Default value to be returned if no value is found for the key. (if used, the default value will be processed to ensure it's relative or absolute as requested)

absolute - tells if the returned file should be absolute or relative to the settings base directory.

Returns:

The absolute or relative file path associated to the given key (or default value if no value was found).

setFileProperty

public void setFileProperty(String key,
                            String value)
                     throws InvalidPathException

Description copied from interface: Settings

Set a new value for a File or Directory property.
The specified file can be absolute or relative. If a relative file is specifed, it's taken as relative to the base path of this settings.
This method will fire an propertyChangeEvent to all registered listeners if the value set is different than the current value.

Specified by:

setFileProperty in interface Settings

Parameters:

key - Key for the value.

value - New value to be associated with the key.

Throws:

InvalidPathException - if the file set is invalid.

addPropertyChangeListener

public void addPropertyChangeListener(String settingKey,
                                      PropertyChangeListener listener)

Add a PropertyChangeListener for a specific setting.

Specified by:

addPropertyChangeListener in interface Settings

Parameters:

settingKey - The key of the setting to listen on.

listener - The PropertyChangeListener to be added

removePropertyChangeListener

public void removePropertyChangeListener(String settingKey,
                                         PropertyChangeListener listener)

Remove a PropertyChangeListener for a specific setting.

Specified by:

removePropertyChangeListener in interface Settings

Parameters:

settingKey - The key of the setting that was listened on.

listener - The PropertyChangeListener to be removed