net.sf.gridarta.preferences

Class Storage

java.lang.Object

net.sf.gridarta.preferences.Storage

public class Storage
extends java.lang.Object

Maintains a set of preference values. The values are stored in a flat file.

Constructor Summary

Constructors

Constructor and Description
Storage(java.lang.String defaultPath, java.io.File file) Create a new instance.

Method Summary

Modifier and Type	Method and Description
java.lang.String[]	childrenNames(java.lang.String path) Return the names of the children of a node.
java.lang.String[]	getKeys(java.lang.String path) Return all of the keys that have an associated value in a node.
java.lang.String	getValue(java.lang.String path, java.lang.String key) Return the value associated with the specified key at a node, or null if there is no association for this key.
void	newNode(java.lang.String path) Make sure a node exists.
void	putValue(java.lang.String path, java.lang.String key, java.lang.String value) Put the given key-value association into a node.
void	removeNode(java.lang.String path) Remove a preference node including all preferences that it contains.
void	removeValue(java.lang.String path, java.lang.String key) Remove the association (if any) for the specified key at a node.
void	sync(boolean sync) Save changes to the underlying file.

Methods inherited from class java.lang.Object

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

Constructor Detail

Storage

public Storage(@NotNull
               java.lang.String defaultPath,
               @Nullable
               java.io.File file)

Create a new instance.

Parameters:

defaultPath - the default key name for loading/saving values

file - the file for loading/saving values or null to not use a backing file

Method Detail

newNode

public void newNode(@NotNull
                    java.lang.String path)

Make sure a node exists.

Parameters:

path - the node path name

childrenNames

@NotNull
public java.lang.String[] childrenNames(@NotNull
                                                 java.lang.String path)

Return the names of the children of a node. The returned array will be of size zero if the node has no children.

Parameters:

path - the node path name

Returns:

the children names

getValue

@Nullable
public java.lang.String getValue(@NotNull
                                           java.lang.String path,
                                           @NotNull
                                           java.lang.String key)

Return the value associated with the specified key at a node, or null if there is no association for this key.

Parameters:

path - the node path name

key - the key to get value for

Returns:

the value

getKeys

@NotNull
public java.lang.String[] getKeys(@NotNull
                                           java.lang.String path)

Return all of the keys that have an associated value in a node. The returned array will be of size zero if the node has no preferences.

Parameters:

path - the node path name

Returns:

the key names

putValue

public void putValue(@NotNull
                     java.lang.String path,
                     @NotNull
                     java.lang.String key,
                     @NotNull
                     java.lang.String value)

Put the given key-value association into a node.

Parameters:

path - the node path name

key - the key to store

value - the value to store

removeNode

public void removeNode(@NotNull
                       java.lang.String path)

Remove a preference node including all preferences that it contains.

Parameters:

path - the node path name

removeValue

public void removeValue(@NotNull
                        java.lang.String path,
                        @NotNull
                        java.lang.String key)

Remove the association (if any) for the specified key at a node.

Parameters:

path - the node path name to remove from

key - the key to remove

sync

public void sync(boolean sync)
          throws java.util.prefs.BackingStoreException

Save changes to the underlying file.

Parameters:

sync - not currently used

Throws:

java.util.prefs.BackingStoreException - in case sync was not possible, i.e. due to I/O problems