Package de.mid.innovator.ui

Class PropertyProviderDefault

java.lang.Object

de.mid.innovator.ui.PropertyProviderDefault

All Implemented Interfaces:

PropertyProvider

public class PropertyProviderDefault
extends Object
implements PropertyProvider

The class is a default implementation of the PropertyProvider interface which can be used to unify command line arguments and system properties. It also helps to configure and transform the property values at runtime. It checks the configured properties against the given command line arguments and provides the user with default values.

Author:

borschet

See Also:

• Property
• PropertyCfg
• PropertyProvider

Constructor Summary

Constructors

Constructor	Description
PropertyProviderDefault()	The default constructor which creates an empty property provider.

Method Summary

Modifier and Type	Method	Description
void	disableValidateConfig()	Disables stringent validation of the configuration.
void	enableValidateConfig()	Enables stringent validation of the configuration.
List<Property>	getAllValidProperties()
boolean	getBooleanProperty(String key)	A property getter for Boolean properties.
Class<?>[]	getClassListProperty(String key)	Gets a list of classes from a given string property.
Class<?>	getClassProperty(String key)	A property getter for class properties.
<T extends Enum<T>> T	getEnumProperty(Class<T> cls, String key)	A property getter for enumeration type.
File[]	getFileListProperty(String key)	Gets a list of files given with a string property value.
File	getFileProperty(String key)	A property getter for File properties.
int	getIntegerProperty(String key)	A property getter for integer properties.
boolean	getOptionalBooleanProperty(String key)	Invokes getBooleanProperty(String)
Class<?>[]	getOptionalClassListProperty(String key, Class<?>[] defaultValue)	Invokes getClassListProperty()
Class<?>	getOptionalClassProperty(String key)	Invokes getClassProperty(String)
<T extends Enum<T>> T	getOptionalEnumProperty(Class<T> cls, String key)	Invokes getEnumProperty(Class, String)
File[]	getOptionalFileListProperty(String key, File[] defaultValue)	Invokes getFileListProperty()
File	getOptionalFileProperty(String key)	Invokes getFileProperty(String)
int	getOptionalIntegerProperty(String key)	Invokes getIntegerProperty()
String	getOptionalStringProperty(String key)	Invokes getStringProperty()
String	getStringProperty(String key)	A property getter for string properties.
void	InitWithCommandLineArguments(String[] commandLineArguments)	Initializes the property provider with a wide array of command line argument strings, checks the given values against the configuration and prepares the values for use with the typed getter methods.
boolean	isPropertySet(String key)	Returns true if the property with the given key is existing and set, else returns false.
void	provideProperty(Property p)	Adds precisely one property that can be used at runtime.
void	providePropertyList(List<Property> validProps)	Configures a list of valid properties to be used at runtime.
void	setProperty(String key, String value)	Set the value for an existing property.

Methods inherited from class java.lang.Object

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

Constructor Details

PropertyProviderDefault

public PropertyProviderDefault()

The default constructor which creates an empty property provider.

Method Details

providePropertyList

public void providePropertyList(List<Property> validProps)

Configures a list of valid properties to be used at runtime.

Specified by:

providePropertyList in interface PropertyProvider

provideProperty

public void provideProperty(Property p)

Adds precisely one property that can be used at runtime.

Specified by:

provideProperty in interface PropertyProvider

enableValidateConfig

public void enableValidateConfig()

Enables stringent validation of the configuration.

Specified by:

enableValidateConfig in interface PropertyProvider

See Also:

• InitWithCommandLineArguments(String[])

disableValidateConfig

public void disableValidateConfig()

Disables stringent validation of the configuration.

Specified by:

disableValidateConfig in interface PropertyProvider

See Also:

• InitWithCommandLineArguments(String[])

getAllValidProperties

public List<Property> getAllValidProperties()

Specified by:

getAllValidProperties in interface PropertyProvider

Returns:

all previously configured properties

InitWithCommandLineArguments

public void InitWithCommandLineArguments(String[] commandLineArguments)
                                  throws UnknownArgumentException

Initializes the property provider with a wide array of command line argument strings, checks the given values against the configuration and prepares the values for use with the typed getter methods. This means that the command line arguments are parsed according to the format "<key>=<value>". The property provider checks every given string argument so that they correspond with a valid configured property. If no such property can be found, an exception is raised. This behavior can be prevented by calling disableValidateConfig() before the property provider is initialized.

Specified by:

InitWithCommandLineArguments in interface PropertyProvider

Throws:

UnknownArgumentException - If the list of command line arguments contains a property that was not previously configured and this check is not disabled.

getOptionalBooleanProperty

public boolean getOptionalBooleanProperty(String key)

Invokes getBooleanProperty(String)

Specified by:

getOptionalBooleanProperty in interface PropertyProvider

Parameters:

key - the argument key value

Returns:

true if the property's string value is "true", otherwise false

getOptionalClassProperty

public Class<?> getOptionalClassProperty(String key)
                                  throws InvalidArgumentException

Invokes getClassProperty(String)

Specified by:

getOptionalClassProperty in interface PropertyProvider

Parameters:

key - the argument key value

Returns:

the given value, otherwise the configured default value

Throws:

InvalidArgumentException - If the given string cannot be converted into a valid class.

getOptionalEnumProperty

public <T extends Enum<T>> T getOptionalEnumProperty(Class<T> cls,
 String key)
                                              throws InvalidArgumentException

Invokes getEnumProperty(Class, String)

Specified by:

getOptionalEnumProperty in interface PropertyProvider

Parameters:

cls - the enumeration type of the property

key - the key value

Returns:

the given value, otherwise the configured default value

Throws:

InvalidArgumentException - If the conversion from the value to a valid member of the given enumeration fails.

getOptionalFileProperty

public File getOptionalFileProperty(String key)

Invokes getFileProperty(String)

Specified by:

getOptionalFileProperty in interface PropertyProvider

Returns:

the given value, otherwise the configured default value

getOptionalIntegerProperty

public int getOptionalIntegerProperty(String key)
                               throws InvalidArgumentException

Invokes getIntegerProperty()

Specified by:

getOptionalIntegerProperty in interface PropertyProvider

Returns:

its result if defined, otherwise the configured default value

Throws:

InvalidArgumentException - If the properties string value cannot be converted into an integer.

getOptionalStringProperty

public String getOptionalStringProperty(String key)

Invokes getStringProperty()

Specified by:

getOptionalStringProperty in interface PropertyProvider

Returns:

its result if defined, otherwise the configured default value

getOptionalClassListProperty

public Class<?>[] getOptionalClassListProperty(String key,
 Class<?>[] defaultValue)
                                        throws InvalidArgumentException

Invokes getClassListProperty()

Specified by:

getOptionalClassListProperty in interface PropertyProvider

Returns:

its result if defined, otherwise the configured default value

Throws:

InvalidArgumentException - if the property string value cannot be converted into a list of classes.

getOptionalFileListProperty

public File[] getOptionalFileListProperty(String key,
 File[] defaultValue)

Invokes getFileListProperty()

Specified by:

getOptionalFileListProperty in interface PropertyProvider

Returns:

its result if defined, otherwise the configured default value

getEnumProperty

public <T extends Enum<T>> T getEnumProperty(Class<T> cls,
 String key)
                                      throws InvalidArgumentException,
MissingArgumentException

A property getter for enumeration type.

Specified by:

getEnumProperty in interface PropertyProvider

Parameters:

cls - the enumeration type of the property

key - the key value

Returns:

an instance of the enumeration

Throws:

InvalidArgumentException

MissingArgumentException - if no such property can be found.

getBooleanProperty

public boolean getBooleanProperty(String key)
                           throws MissingArgumentException

A property getter for Boolean properties.

Specified by:

getBooleanProperty in interface PropertyProvider

Throws:

MissingArgumentException - If no such property can be found.

getClassProperty

public Class<?> getClassProperty(String key)
                          throws MissingArgumentException,
InvalidArgumentException

A property getter for class properties.

Specified by:

getClassProperty in interface PropertyProvider

Throws:

InvalidArgumentException - if the property value cannot be converted into a valid class.

MissingArgumentException - if no such property can be found.

getFileProperty

public File getFileProperty(String key)
                     throws MissingArgumentException

A property getter for File properties.

Specified by:

getFileProperty in interface PropertyProvider

Returns:

a file object created with File(java.lang.String)

Throws:

MissingArgumentException - if no such property can be found.

getIntegerProperty

public int getIntegerProperty(String key)
                       throws MissingArgumentException,
InvalidArgumentException

A property getter for integer properties.

Specified by:

getIntegerProperty in interface PropertyProvider

Throws:

InvalidArgumentException - if the property value cannot be converted into an integer.

MissingArgumentException - if no such property can be found.

getStringProperty

public String getStringProperty(String key)
                         throws MissingArgumentException

A property getter for string properties.

Specified by:

getStringProperty in interface PropertyProvider

Throws:

MissingArgumentException - if no such property can be found.

getClassListProperty

public Class<?>[] getClassListProperty(String key)
                                throws MissingArgumentException,
InvalidArgumentException

Gets a list of classes from a given string property. Each class specifications must be separated by a File.pathSeparator.

Specified by:

getClassListProperty in interface PropertyProvider

Returns:

an array of classes.

Throws:

InvalidArgumentException - if an entry of the string list cannot be converted into a valid class.

MissingArgumentException - if no such property can be found.

getFileListProperty

public File[] getFileListProperty(String key)
                           throws MissingArgumentException

Gets a list of files given with a string property value. The single file specifications must be separated by File.pathSeparator.

Specified by:

getFileListProperty in interface PropertyProvider

Returns:

an array of file instances.

Throws:

MissingArgumentException - if no such property can be found.

isPropertySet

public boolean isPropertySet(String key)

Description copied from interface: PropertyProvider

Returns true if the property with the given key is existing and set, else returns false.

Specified by:

isPropertySet in interface PropertyProvider

Parameters:

key - key of the property

Returns:

true if property with key is set.

setProperty

public void setProperty(String key,
 String value)

Description copied from interface: PropertyProvider

Set the value for an existing property. If the property does not exist, nothing is done.

Specified by:

setProperty in interface PropertyProvider

Parameters:

key -

value -