org.yasl.arch.impl.prefs
Class PreferencesManagerImpl

java.lang.Object
  org.yasl.arch.impl.prefs.PreferencesManagerImpl

All Implemented Interfaces:

PreferencesManager

public class PreferencesManagerImpl

extends Object

implements PreferencesManager

Version:

1.0

Author:

not attributable

Field Summary

Fields inherited from interface org.yasl.arch.prefs.PreferencesManager

PREF_APP_HEIGHT, PREF_APP_POS_X, PREF_APP_POS_Y, PREF_APP_WIDTH

Constructor Summary

PreferencesManagerImpl()

PreferencesManagerImpl(Map defaultProps)

PreferencesManagerImpl(Map defaultProps, String defaultPrefsFolder, String defaultPrefsFilename)

PreferencesManagerImpl(String defaultPrefsFolder, String defaultPrefsFilename)

Method Summary

void	addPreferencesChangeListener(PreferencesListener listener) Adds a preferences listener to the manager.
boolean	getBooleanValue(String key) Convenience method for transforming a value to a boolean.
Color	getColorValue(String key) Convenience method for transforming a value to a Color.
String	getDefaultPreferencesHeader() Returns the value to be placed at the top of the preferences file as a comment.
String	getDefaultPrefsFilename() Returns the default name of the file to hold user preferences.
String	getDefaultPrefsFolder() Returns the default name of the folder that will hold app config files in the user's home directory.
double	getDoubleValue(String key) Convenience method for transforming a value to a double.
float	getFloatValue(String key) Convenience method for transforming a value to a float.
int	getIntValue(String key) Convenience method for transforming a value to an int.
String	getPreference(String key) Returns the value associated with the key.
String	getPreference(String key, String defaultValue) Returns the value associated with the key.
File	getPreferenceFile() Utility method for creating a file object using the user's home folder.
File	getPreferenceFile(String folder, String filename) Utility method for creating a file object using the user's home folder.
List	getPreferenceKeys() Returns list of the preference keys.
boolean	isPreferenceAvailable(String key) Returns true if the key is mapped in the preferences.
void	loadPreferences(File prefFile) Populate the preferences from the specified properties file.
void	removePreferencesChangeListener(PreferencesListener listener) Removes a preferences listener from the manager.
void	saveFrameLocation(JFrame frame) Saves the frame location in the preferences.
void	saveFrameSize(JFrame frame) Saves the frame size in the preferences.
void	savePreferences(File prefFile) Saves the preferences to the properties file specified.
void	savePreferences(File prefFile, String header) Saves the preferences to the properties file specified.
void	setBooleanValue(String key, boolean value) Convenience method for setting a boolean preference.
void	setColorValue(String key, Color colorValue) Convenience method for setting a Color preference.
void	setDefaultPreferencesHeader(String header) Sets the value to be placed at the top of the preferences file as a comment.
void	setDoubleValue(String key, double value) Convenience method for setting double preferences.
void	setFloatValue(String key, float value) Convenience method for setting float values.
void	setFrameLocation(JFrame frame) Sets the size of the location of the frame based on the values set in the preferences.
void	setFrameSize(JFrame frame) Sets the size of the frame based on the values set in the preferences.
void	setIntValue(String key, int value) Convenience method for setting an int value.
void	setPreference(String key, Object value) Sets the value to be associated with the passed key.

Methods inherited from class java.lang.Object

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

Constructor Detail

PreferencesManagerImpl

public PreferencesManagerImpl()

PreferencesManagerImpl

public PreferencesManagerImpl(Map defaultProps)

PreferencesManagerImpl

public PreferencesManagerImpl(String defaultPrefsFolder,
                              String defaultPrefsFilename)

PreferencesManagerImpl

public PreferencesManagerImpl(Map defaultProps,
                              String defaultPrefsFolder,
                              String defaultPrefsFilename)

Method Detail

saveFrameSize

public void saveFrameSize(JFrame frame)

Saves the frame size in the preferences.

Specified by:

saveFrameSize in interface PreferencesManager

Parameters:

frame - JFrame

setFrameSize

public void setFrameSize(JFrame frame)

Sets the size of the frame based on the values set in the preferences.

Specified by:

setFrameSize in interface PreferencesManager

Parameters:

frame - JFrame

saveFrameLocation

public void saveFrameLocation(JFrame frame)

Saves the frame location in the preferences.

Specified by:

saveFrameLocation in interface PreferencesManager

Parameters:

frame - JFrame

setFrameLocation

public void setFrameLocation(JFrame frame)

Sets the size of the location of the frame based on the values set in the preferences.

Specified by:

setFrameLocation in interface PreferencesManager

Parameters:

frame - JFrame

getPreferenceKeys

public List getPreferenceKeys()

Returns list of the preference keys.

Specified by:

getPreferenceKeys in interface PreferencesManager

Returns:

List

getBooleanValue

public boolean getBooleanValue(String key)

Convenience method for transforming a value to a boolean.

Specified by:

getBooleanValue in interface PreferencesManager

Parameters:

key - String

Returns:

boolean

setBooleanValue

public void setBooleanValue(String key,
                            boolean value)

Convenience method for setting a boolean preference.

Specified by:

setBooleanValue in interface PreferencesManager

Parameters:

key - String

value - boolean

getColorValue

public Color getColorValue(String key)

Convenience method for transforming a value to a Color.

The color should be encoded in the following format: R,G,B. For example: 23,44,8

If the key does not exist, null is returned.

Specified by:

getColorValue in interface PreferencesManager

Parameters:

key - String

Returns:

Color

setColorValue

public void setColorValue(String key,
                          Color colorValue)

Convenience method for setting a Color preference.

Specified by:

setColorValue in interface PreferencesManager

Parameters:

key - String

colorValue - Color

getDoubleValue

public double getDoubleValue(String key)

Convenience method for transforming a value to a double.

Specified by:

getDoubleValue in interface PreferencesManager

Parameters:

key - String

Returns:

double

setDoubleValue

public void setDoubleValue(String key,
                           double value)

Convenience method for setting double preferences.

Specified by:

setDoubleValue in interface PreferencesManager

Parameters:

key - String

value - double

getFloatValue

public float getFloatValue(String key)

Convenience method for transforming a value to a float.

Specified by:

getFloatValue in interface PreferencesManager

Parameters:

key - String

Returns:

float

setFloatValue

public void setFloatValue(String key,
                          float value)

Convenience method for setting float values.

Specified by:

setFloatValue in interface PreferencesManager

Parameters:

key - String

value - float

getIntValue

public int getIntValue(String key)

Convenience method for transforming a value to an int.

Specified by:

getIntValue in interface PreferencesManager

Parameters:

key - String

Returns:

int

setIntValue

public void setIntValue(String key,
                        int value)

Convenience method for setting an int value.

Specified by:

setIntValue in interface PreferencesManager

Parameters:

key - String

value - int

getPreference

public String getPreference(String key,
                            String defaultValue)

Returns the value associated with the key.

If the key does not exist, the returned value is the defaultValue.

Specified by:

getPreference in interface PreferencesManager

Parameters:

key - String

defaultValue - String

Returns:

String

getPreference

public String getPreference(String key)

Returns the value associated with the key.

If the key does not exist, the returned value is null.

Specified by:

getPreference in interface PreferencesManager

Parameters:

key - String

Returns:

String

loadPreferences

public void loadPreferences(File prefFile)
                     throws FileNotFoundException,
                            IOException

Populate the preferences from the specified properties file.

Specified by:

loadPreferences in interface PreferencesManager

Parameters:

prefFile - File

Throws:

FileNotFoundException

IOException

savePreferences

public void savePreferences(File prefFile,
                            String header)
                     throws FileNotFoundException,
                            IOException

Saves the preferences to the properties file specified.

Specified by:

savePreferences in interface PreferencesManager

Parameters:

prefFile - File

header - String

Throws:

FileNotFoundException

IOException

savePreferences

public void savePreferences(File prefFile)
                     throws FileNotFoundException,
                            IOException

Saves the preferences to the properties file specified. Will use the default preferences header if it has been set.

Specified by:

savePreferences in interface PreferencesManager

Parameters:

prefFile - File

Throws:

FileNotFoundException

IOException

getDefaultPreferencesHeader

public String getDefaultPreferencesHeader()

Returns the value to be placed at the top of the preferences file as a comment.

This method may return null if the default header has not been set.

Specified by:

getDefaultPreferencesHeader in interface PreferencesManager

Returns:

String

setDefaultPreferencesHeader

public void setDefaultPreferencesHeader(String header)

Sets the value to be placed at the top of the preferences file as a comment.

Specified by:

setDefaultPreferencesHeader in interface PreferencesManager

Returns:

String

setPreference

public void setPreference(String key,
                          Object value)

Sets the value to be associated with the passed key.

The value cannot be null.

Specified by:

setPreference in interface PreferencesManager

Parameters:

key - String

value - Object

getPreferenceFile

public File getPreferenceFile(String folder,
                              String filename)
                       throws IOException

Utility method for creating a file object using the user's home folder.

If the folder does not exist, it will be created.

Specified by:

getPreferenceFile in interface PreferencesManager

Parameters:

folder - String -- The name of the folder that will hold app config files in the user's home directory.

filename - String -- The name of the file to hold user preferences.

Returns:

File

Throws:

IOException

getPreferenceFile

public File getPreferenceFile()
                       throws IOException

Utility method for creating a file object using the user's home folder.

If the folder does not exist, it will be created.

This method will use the default folder and default filename.

Specified by:

getPreferenceFile in interface PreferencesManager

Returns:

File

Throws:

IOException

getDefaultPrefsFolder

public String getDefaultPrefsFolder()

Returns the default name of the folder that will hold app config files in the user's home directory.

Specified by:

getDefaultPrefsFolder in interface PreferencesManager

Returns:

String

getDefaultPrefsFilename

public String getDefaultPrefsFilename()

Returns the default name of the file to hold user preferences.

Specified by:

getDefaultPrefsFilename in interface PreferencesManager

Returns:

String

isPreferenceAvailable

public boolean isPreferenceAvailable(String key)

Returns true if the key is mapped in the preferences.

Specified by:

isPreferenceAvailable in interface PreferencesManager

Returns:

boolean

addPreferencesChangeListener

public void addPreferencesChangeListener(PreferencesListener listener)

Adds a preferences listener to the manager. The listener will be notified when a preference changes.

Specified by:

addPreferencesChangeListener in interface PreferencesManager

Parameters:

listener - PreferencesListener

removePreferencesChangeListener

public void removePreferencesChangeListener(PreferencesListener listener)

Removes a preferences listener from the manager.

Specified by:

removePreferencesChangeListener in interface PreferencesManager

Parameters:

listener - PreferencesListener