Module is.codion.common.model

Package is.codion.common.model.preferences

Class FilePreferences

java.lang.Object

java.util.prefs.Preferences

java.util.prefs.AbstractPreferences

is.codion.common.model.preferences.FilePreferences

public final class FilePreferences
extends AbstractPreferences

A file-based preferences implementation without length restrictions.

Supports hierarchical preferences through nested JSON structure.

Clearing the preferences instance and flushing deletes the underlying file.

Note that, unlike the AbstractPreferences contract, PreferenceChangeListeners are not notified of put(String, String) calls.

See Also:

• filePreferences(String)
• PREFERENCES_LOCATION
• PRETTY_PRINT
• UserPreferences

Field Summary

Fields

Modifier and Type	Field	Description
static final PropertyValue<String>	PREFERENCES_LOCATION	Provides a way to override the default (OS dependent) directory used to store the user preferences file.
static final PropertyValue<Boolean>	PRETTY_PRINT	Specifies whether JSON preference files are pretty-printed, causes significant size increase.

Fields inherited from class java.util.prefs.AbstractPreferences

lock, newNode

Fields inherited from class java.util.prefs.Preferences

MAX_KEY_LENGTH, MAX_NAME_LENGTH, MAX_VALUE_LENGTH

Method Summary

Modifier and Type	Method	Description
protected String[]	childrenNamesSpi()
protected AbstractPreferences	childSpi(String name)
static Preferences	filePreferences(String filename)
protected void	flushSpi()
protected @Nullable String	getSpi(String key)
protected String[]	keysSpi()
void	put(String key, String value)
protected void	putSpi(String key, String value)
protected void	removeNodeSpi()
protected void	removeSpi(String key)
protected void	syncSpi()

Methods inherited from class java.util.prefs.AbstractPreferences

absolutePath, addNodeChangeListener, addPreferenceChangeListener, cachedChildren, childrenNames, clear, exportNode, exportSubtree, flush, get, getBoolean, getByteArray, getChild, getDouble, getFloat, getInt, getLong, isRemoved, isUserNode, keys, name, node, nodeExists, parent, putBoolean, putByteArray, putDouble, putFloat, putInt, putLong, remove, removeNode, removeNodeChangeListener, removePreferenceChangeListener, sync, toString

Methods inherited from class java.util.prefs.Preferences

importPreferences, systemNodeForPackage, systemRoot, userNodeForPackage, userRoot

Methods inherited from class java.lang.Object

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

Field Details

PREFERENCES_LOCATION

public static final PropertyValue<String> PREFERENCES_LOCATION

Provides a way to override the default (OS dependent) directory used to store the user preferences file.

Note that changing this value after a file based preferences instance has been created has no effect on subsequent instances.

• Value type: String
• Default value: null

See Also:

• filePreferences(String)

PRETTY_PRINT

public static final PropertyValue<Boolean> PRETTY_PRINT

Specifies whether JSON preference files are pretty-printed, causes significant size increase.

Note that this value is captured when a file based preferences instance is created; changing it afterwards has no effect on that instance.

• Value type: Boolean
• Default value: false

Method Details

put

public void put(String key,
 String value)

Overrides:

put in class AbstractPreferences

filePreferences

public static Preferences filePreferences(String filename)

Parameters:

filename - the preferences filename

Returns:

a file based Preferences instance based on the given filename

putSpi

protected void putSpi(String key,
 String value)

Specified by:

putSpi in class AbstractPreferences

getSpi

protected @Nullable String getSpi(String key)

Specified by:

getSpi in class AbstractPreferences

removeSpi

protected void removeSpi(String key)

Specified by:

removeSpi in class AbstractPreferences

keysSpi

protected String[] keysSpi()
                    throws BackingStoreException

Specified by:

keysSpi in class AbstractPreferences

Throws:

BackingStoreException

flushSpi

protected void flushSpi()
                 throws BackingStoreException

Specified by:

flushSpi in class AbstractPreferences

Throws:

BackingStoreException

syncSpi

protected void syncSpi()
                throws BackingStoreException

Specified by:

syncSpi in class AbstractPreferences

Throws:

BackingStoreException

childrenNamesSpi

protected String[] childrenNamesSpi()

Specified by:

childrenNamesSpi in class AbstractPreferences

childSpi

protected AbstractPreferences childSpi(String name)

Specified by:

childSpi in class AbstractPreferences

removeNodeSpi

protected void removeNodeSpi()
                      throws BackingStoreException

Specified by:

removeNodeSpi in class AbstractPreferences

Throws:

BackingStoreException