Package com.intergral.fusionreactor.capi

Interface ConfigurationSurrogate

public interface ConfigurationSurrogate

This interface specifies the public members of a FusionReactor Configuration object.

Clients use this class to interact with FusionReactor's configuration. Changes are reflected immediately in the stored configuration but some may require a restart in order to become visible in the application.

Since:

2.0

Method Summary

Modifier and Type	Method	Description
void	applyChanges(Map changes)	Apply a set of changes to this configuration object.
void	assertValidity()	Check whether the currently loaded configuration is valid.
Properties	getAsProperties()
boolean	getBooleanValue(String name)
boolean	getBooleanValue(String name, boolean defaultValue)
int	getIntValue(String name)
int	getIntValue(String name, int defaultValue)
Iterator	getKeyIterator()
String	getStringValue(String name)
String	getStringValue(String name, String defaultValue)
int	getVersion()
void	removeKey(String key)	Remove a key from the configuration.
void	setValue(String key, String value)	Insert a new configuration key/value into the store.

Method Detail

applyChanges

void applyChanges(Map changes)

Apply a set of changes to this configuration object. Any keys which do not exist are added, and any which exist are overwritten.

Parameters:

changes - the changes to apply.

Since:

2.0

assertValidity

void assertValidity()
             throws ConfigurationInvalidExceptionSurrogate

Check whether the currently loaded configuration is valid.

Throws:

ConfigurationInvalidExceptionSurrogate - if the configuration is not valid

Since:

2.0

getAsProperties

Properties getAsProperties()

Returns:

this configuration as a properties set.

Since:

2.0

getBooleanValue

boolean getBooleanValue(String name,
                        boolean defaultValue)

Parameters:

name - the name of the value being sought.

defaultValue - the default value to be returned if the named parameter was not found.

Returns:

the value of the named parameter as a boolean value or the default if it was not found.

Since:

2.0

getBooleanValue

boolean getBooleanValue(String name)

Parameters:

name - the name of the parameter being sought.

Returns:

the value of the named parameter as a boolean primitive.

Since:

2.0

getIntValue

int getIntValue(String name,
                int defaultValue)

Parameters:

name - the name of the parameter being sought.

defaultValue - the default value to be returned.

Returns:

the specified value as an int, or the default value if the key is not found.

Since:

2.0

getIntValue

int getIntValue(String name)
         throws NumberFormatException,
                NullPointerException

Parameters:

name - the name of the value being sought.

Returns:

the specified value as an int.

Throws:

NumberFormatException - if the given element could not be coerced to int (via Integer)

NullPointerException - if the key does not exist

Since:

2.0

getKeyIterator

Iterator getKeyIterator()

Returns:

an Iterator over set of configuration keys held by this object.

Since:

2.0

getStringValue

String getStringValue(String name,
                      String defaultValue)

Parameters:

name - the name of the parameter being sought.

defaultValue - the default value to be returned.

Returns:

a named string value, or defaultValue if the named value is not found.

Since:

2.0

getStringValue

String getStringValue(String name)

Parameters:

name - the name of the parameter being sought.

Returns:

a named string value

Since:

2.0

getVersion

int getVersion()

Returns:

the Configuration file version of the running FusionReactor configuration.

Since:

2.0

removeKey

void removeKey(String key)

Remove a key from the configuration. N.b. this may leave the configuration in an invalid state.

Parameters:

key - the key to be removed from the configuration.

Since:

2.0

setValue

void setValue(String key,
              String value)

Insert a new configuration key/value into the store.

Parameters:

key - the name of the value being stored

value - the value being stored

Since:

2.0