org.eclipse.jface.dialogs
Interface IDialogSettings

All Known Implementing Classes:

DialogSettings

public interface IDialogSettings

An interface to a storage mechanism for making dialog settings persistent. The store manages a collection of key/value pairs. The key must be a string and the values can be either, strings or array of strings. Convenience API to convert primitive types to strings is provided.

Method Summary

IDialogSettings	addNewSection(String name) Create a new section in the receiver and return it.
void	addSection(IDialogSettings section) Add a section in the receiver.
String	get(String key) Returns the value of the given key in this dialog settings.
String[]	getArray(String key) Returns the value, an array of strings, of the given key in this dialog settings.
boolean	getBoolean(String key) Convenience API.
double	getDouble(String key) Convenience API.
float	getFloat(String key) Convenience API.
int	getInt(String key) Convenience API.
long	getLong(String key) Convenience API.
String	getName() Returns the IDialogSettings name.
IDialogSettings	getSection(String sectionName) Returns the section with the given name in this dialog settings.
IDialogSettings[]	getSections() Returns all the sections in this dialog settings.
void	load(Reader reader) Load a dialog settings from a stream and fill the receiver with its content.
void	load(String fileName) Load a dialog settings from a file and fill the receiver with its content.
void	put(String key, boolean value) Convenience API.
void	put(String key, double value) Convenience API.
void	put(String key, float value) Convenience API.
void	put(String key, int value) Convenience API.
void	put(String key, long value) Convenience API.
void	put(String key, String value) Adds the pair key/value to this dialog settings.
void	put(String key, String[] value) Adds the pair key/value to this dialog settings.
void	save(String fileName) Save a dialog settings to a file.
void	save(Writer writer) Save a dialog settings to a stream

Method Detail

addNewSection

public IDialogSettings addNewSection(String name)

Create a new section in the receiver and return it.

Parameters:

name - the name of the new section

Returns:

the new section

addSection

public void addSection(IDialogSettings section)

Add a section in the receiver.

Parameters:

section - the section to be added

get

public String get(String key)

Returns the value of the given key in this dialog settings.

Parameters:

key - the key

Returns:

the value, or null if none

getArray

public String[] getArray(String key)

Returns the value, an array of strings, of the given key in this dialog settings.

Parameters:

key - the key

Returns:

the array of string, or null if none

getBoolean

public boolean getBoolean(String key)

Convenience API. Convert the value of the given key in this dialog settings to a boolean and return it.

Parameters:

key - the key

Returns:

the boolean value, or false if none

getDouble

public double getDouble(String key)
                 throws NumberFormatException

Convenience API. Convert the value of the given key in this dialog settings to a double and return it.

Parameters:

key - the key

Returns:

the value coverted to double, or throws NumberFormatException if none

Throws:

NumberFormatException - if the string value does not contain a parsable number.

See Also:

Double.valueOf(java.lang.String)

getFloat

public float getFloat(String key)
               throws NumberFormatException

Convenience API. Convert the value of the given key in this dialog settings to a float and return it.

Parameters:

key - the key

Returns:

the value coverted to float, or throws NumberFormatException if none

Throws:

NumberFormatException - if the string value does not contain a parsable number.

See Also:

Float.valueOf(java.lang.String)

getInt

public int getInt(String key)
           throws NumberFormatException

Convenience API. Convert the value of the given key in this dialog settings to a int and return it.

Parameters:

key - the key

Returns:

the value coverted to int, or throws NumberFormatException if none

Throws:

NumberFormatException - if the string value does not contain a parsable number.

See Also:

Integer.valueOf(java.lang.String)

getLong

public long getLong(String key)
             throws NumberFormatException

Convenience API. Convert the value of the given key in this dialog settings to a long and return it.

Parameters:

key - the key

Returns:

the value coverted to long, or throws NumberFormatException if none

Throws:

NumberFormatException - if the string value does not contain a parsable number.

See Also:

Long.valueOf(java.lang.String)

getName

public String getName()

Returns the IDialogSettings name.

Returns:

the name

getSection

public IDialogSettings getSection(String sectionName)

Returns the section with the given name in this dialog settings.

Returns:

the section, or null if none

getSections

public IDialogSettings[] getSections()

Returns all the sections in this dialog settings.

Returns:

the section, or null if none

load

public void load(Reader reader)
          throws IOException

Load a dialog settings from a stream and fill the receiver with its content.

Parameters:

reader - a Reader specifying the stream where the settings are read from.

IOException

load

public void load(String fileName)
          throws IOException

Load a dialog settings from a file and fill the receiver with its content.

Parameters:

fileName - the name of the file the settings are read from.

IOException

put

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

Adds the pair key/value to this dialog settings.

Parameters:

key - the key.

value - the value to be associated with the key

put

public void put(String key,
                double value)

Convenience API. Converts the double value to a string and adds the pair key/value to this dialog settings.

Parameters:

key - the key.

value - the value to be associated with the key

put

public void put(String key,
                float value)

Convenience API. Converts the float value to a string and adds the pair key/value to this dialog settings.

Parameters:

key - the key.

value - the value to be associated with the key

put

public void put(String key,
                int value)

Convenience API. Converts the int value to a string and adds the pair key/value to this dialog settings.

Parameters:

key - the key.

value - the value to be associated with the key

put

public void put(String key,
                long value)

Convenience API. Converts the long value to a string and adds the pair key/value to this dialog settings.

Parameters:

key - the key.

value - the value to be associated with the key

put

public void put(String key,
                String value)

Adds the pair key/value to this dialog settings.

Parameters:

key - the key.

value - the value to be associated with the key

put

public void put(String key,
                boolean value)

Convenience API. Converts the boolean value to a string and adds the pair key/value to this dialog settings.

Parameters:

key - the key.

value - the value to be associated with the key

save

public void save(Writer writer)
          throws IOException

Save a dialog settings to a stream

Parameters:

writer - a Writer specifying the stream the settings are written in.

IOException

save

public void save(String fileName)
          throws IOException

Save a dialog settings to a file.

Parameters:

fileName - the name of the file the settings are written in.

IOException