org.settings4j.connector

Class PreferencesConnector

java.lang.Object

org.settings4j.connector.AbstractConnector

org.settings4j.connector.AbstractPropertyConnector

org.settings4j.connector.PreferencesConnector

All Implemented Interfaces:

Connector

public class PreferencesConnector
extends AbstractPropertyConnector

Connector which uses the Preferences feature of Java.

Locations:

• In W98/Me/NT/W2K/XP/W2003/Vista/W7-32/W7-64 this information is stored in the fragile, hard-to-back-up registry in HKEY_LOCAL_MACHINE\JavaSoft\Prefs for system Preferences and HKEY_CURRENT_USER\JavaSoft\Prefs for user Preferences in a very fluffy format. Every capital letter is preceded with a / and any fields containing accented letters are encoded in Base64.
• In Windows, user Preferences show up at HKEY_CURRENT_USER\Software\JavaSoft\Prefs\com\mindprod\replicator and HKEY_USERS\ usernamexxx\Software\JavaSoft\Prefs\com\mindprod\replicator where the package name is com.mindprod.replicator.
• In Windows, system Preferences show up at HKEY_LOCAL_MACHINE\Software\JavaSoft\Prefs\com\mindprod\replicator, where the package name is com.mindprod.replicator
• In Linux, preferences are stored in ordinary xml files. System Preferences are stored in etc/.java.
• In Linux, user preferences are stored in ~/.java. The file for user preferences may have a goofy base64-encoded name something like this:
  /home/username/.java/.userPrefs/ com/mindprod/replicator/_!':!bw "t!#4!b@"p!'4!~!"w!()!bw"k!#4!cg"l!(!!b!"p!'}@"0!'8!cg==

Author:

Harald.Brabenetz

Constructor Summary

Constructors

Constructor and Description
PreferencesConnector() Default Constructor initialize the User and System Preferences.

Method Summary

Methods

Modifier and Type	Method and Description
protected String	getPreferenceValue(String path, String key, String defaultValue, Preferences preferences) Resolve the given path and key against the given Preferences.
protected String	getProperty(String keyPath, String defaultValue) Very similar to System.getProperty except that the SecurityException is hidden.
protected void	setPreferenceValue(String path, String key, String value, Preferences preferences) Resolve the given path and key against the given Preferences.
void	setString(String keyPath, String value) Stores the given Value into the User-Preferences.
void	setSystemString(String keyPath, String value) Stores the given Value into the System-Preferences.

Methods inherited from class org.settings4j.connector.AbstractPropertyConnector

getContent, getObject, getString

Methods inherited from class org.settings4j.connector.AbstractConnector

addConnector, getConnectors, getContentResolver, getName, getObjectResolver, init, setContentResolver, setName, setObjectResolver

Methods inherited from class java.lang.Object

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

Constructor Detail

PreferencesConnector

public PreferencesConnector()

Default Constructor initialize the User and System Preferences.

Method Detail

getProperty

protected String getProperty(String keyPath,
                 String defaultValue)

Very similar to System.getProperty except that the SecurityException is hidden.

Specified by:

getProperty in class AbstractPropertyConnector

Parameters:

keyPath - The key to search for.

defaultValue - The default value to return.

Returns:

the string value of the system property, or the default value if there is no property with that key.

getPreferenceValue

protected String getPreferenceValue(String path,
                        String key,
                        String defaultValue,
                        Preferences preferences)

Resolve the given path and key against the given Preferences.

Parameters:

path - the preferences path (placeholder part before '/')

key - the preferences key (placeholder part after '/')

defaultValue - the default Value.

preferences - the Preferences to resolve against

Returns:

the value for the placeholder, or null if none found

setString

public void setString(String keyPath,
             String value)

Stores the given Value into the User-Preferences.

Parameters:

keyPath - - The full KeyPath

value - - The new Value

setSystemString

public void setSystemString(String keyPath,
                   String value)

Stores the given Value into the System-Preferences.

Parameters:

keyPath - - The full KeyPath

value - - The new Value

setPreferenceValue

protected void setPreferenceValue(String path,
                      String key,
                      String value,
                      Preferences preferences)

Resolve the given path and key against the given Preferences.

Parameters:

path - the preferences path (placeholder part before '/')

key - the preferences key (placeholder part after '/')

value - the Value to store.

preferences - the Preferences to resolve against