Module org.refcodes.struct

Package org.refcodes.struct

Interface InterOperableMap<T>

All Superinterfaces:

org.refcodes.mixin.AnnotatorAccessor, Containable, org.refcodes.mixin.DelimiterAccessor, Dictionary<String,T>, org.refcodes.mixin.Dumpable, org.refcodes.mixin.EmptyAccessor, Keys<String,T>, PathMap<T>, org.refcodes.mixin.TypeAccessor<T>

All Known Subinterfaces:

CanonicalMap, CanonicalMap.CanonicalMapBuilder, CanonicalMap.MutableCanonicalMap, SimpleTypeMap, SimpleTypeMap.MutableSimpleTypeMap, SimpleTypeMap.SimpleTypeMapBuilder

All Known Implementing Classes:

CanonicalMapBuilderImpl, CanonicalMapImpl, SimpleTypeMapBuilderImpl, SimpleTypeMapImpl

public interface InterOperableMap<T>
extends PathMap<T>

The InterOperableMap provides convenience accessor default methods for supporting primitive data types.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	InterOperableMap.InterOperableMapBuilder<T>	The InterOperableMap.InterOperableMapBuilder provides convenience accessor default methods for supporting primitive data types.
static interface	InterOperableMap.MutableInterOperableMap<T>	The InterOperableMap.InterOperableMapBuilder provides convenience accessor default methods for supporting primitive data types.

Nested classes/interfaces inherited from interface org.refcodes.mixin.AnnotatorAccessor

org.refcodes.mixin.AnnotatorAccessor.AnnotatorBuilder<B extends org.refcodes.mixin.AnnotatorAccessor.AnnotatorBuilder<B>>, org.refcodes.mixin.AnnotatorAccessor.AnnotatorMutator, org.refcodes.mixin.AnnotatorAccessor.AnnotatorProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.DelimiterAccessor

org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B extends org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B>>, org.refcodes.mixin.DelimiterAccessor.DelimiterMutator, org.refcodes.mixin.DelimiterAccessor.DelimiterProperty

Nested classes/interfaces inherited from interface org.refcodes.struct.Dictionary

Dictionary.MutableDictionary<K,V>

Nested classes/interfaces inherited from interface org.refcodes.mixin.EmptyAccessor

org.refcodes.mixin.EmptyAccessor.EmptyMutator, org.refcodes.mixin.EmptyAccessor.EmptyProperty

Nested classes/interfaces inherited from interface org.refcodes.struct.Keys

Keys.MutableKeys<K,V>, Keys.MutableValues<K,V>

Nested classes/interfaces inherited from interface org.refcodes.struct.PathMap

PathMap.MutablePathMap<T>, PathMap.PathMapBuilder<T>

Nested classes/interfaces inherited from interface org.refcodes.mixin.TypeAccessor

org.refcodes.mixin.TypeAccessor.TypeBuilder<T extends Object,B extends org.refcodes.mixin.TypeAccessor.TypeBuilder<T,B>>, org.refcodes.mixin.TypeAccessor.TypeMutator<T extends Object>, org.refcodes.mixin.TypeAccessor.TypeProperty<T extends Object>

Field Summary

Fields inherited from interface org.refcodes.struct.PathMap

ANNOTATOR, DELIMITER

Method Summary

Modifier and Type	Method	Description
default Boolean	getBoolean(Object aKey)	Returns the Boolean value of the property referred to by the key.
default Boolean	getBoolean(Object... aPathElements)	Returns the Boolean value of the property referred to by the path elements.
default Boolean	getBoolean(String aKey)	Returns the Boolean value of the property referred to by the key.
default Boolean	getBoolean(String... aPathElements)	Returns the Boolean value of the property referred to by the path elements.
default Boolean	getBoolean(Collection<?> aPathElements)	Returns the Boolean value of the property referred to by the path elements.
default Boolean	getBooleanOr(Object[] aPathElements, Boolean aDefaultValue)	Returns the Boolean value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Boolean	getBooleanOr(Object aKey, Boolean aDefaultValue)	Returns the Boolean value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Boolean	getBooleanOr(String[] aPathElements, Boolean aDefaultValue)	Returns the Boolean value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Boolean	getBooleanOr(String aKey, Boolean aDefaultValue)	Returns the Boolean value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Boolean	getBooleanOr(Collection<?> aPathElements, Boolean aDefaultValue)	Returns the Boolean value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Byte	getByte(Object aKey)	Returns the Byte value of the property referred to by the key.
default Byte	getByte(Object... aPathElements)	Returns the Byte value of the property referred to by the path elements.
default Byte	getByte(String aKey)	Returns the Byte value of the property referred to by the key.
default Byte	getByte(String... aPathElements)	Returns the Byte value of the property referred to by the path elements.
default Byte	getByte(Collection<?> aPathElements)	Returns the Byte value of the property referred to by the path elements.
default Byte	getByteOr(Object[] aPathElements, Byte aDefaultValue)	Returns the Byte value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Byte	getByteOr(Object aKey, Byte aDefaultValue)	Returns the Byte value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Byte	getByteOr(String[] aPathElements, Byte aDefaultValue)	Returns the Byte value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Byte	getByteOr(String aKey, Byte aDefaultValue)	Returns the Byte value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Byte	getByteOr(Collection<?> aPathElements, Byte aDefaultValue)	Returns the Byte value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Character	getChar(Object aKey)	Returns the Character value of the property referred to by the key.
default Character	getChar(Object... aPathElements)	Returns the Character value of the property referred to by the path elements.
default Character	getChar(String aKey)	Returns the Character value of the property referred to by the key.
default Character	getChar(String... aPathElements)	Returns the Character value of the property referred to by the key.
default Character	getChar(Collection<?> aPathElements)	Returns the Character value of the property referred to by the path elements.
default Character	getCharOr(Object[] aPathElements, Character aDefaultValue)	Returns the Character value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Character	getCharOr(Object aKey, Character aDefaultValue)	Returns the Character value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Character	getCharOr(String[] aPathElements, Character aDefaultValue)	Returns the Character value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Character	getCharOr(String aKey, Character aDefaultValue)	Returns the Character value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Character	getCharOr(Collection<?> aPathElements, Character aDefaultValue)	Returns the Character value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <C> Class<C>	getClass(Object aKey)	Returns the Class value of the property referred to by the key.
default <C> Class<C>	getClass(Object... aPathElements)	Returns the Class value of the property referred to by the path elements.
default <C> Class<C>	getClass(String aKey)	Returns the Class value of the property referred to by the key.
default <C> Class<C>	getClass(String... aPathElements)	Returns the Class value of the property referred to by the path elements.
default <C> Class<C>	getClass(Collection<?> aPathElements)	Returns the Class value of the property referred to by the path elements.
default <C> Class<C>	getClassOr(Object[] aPathElements, Class<C> aDefaultValue)	Returns the Class value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <C> Class<C>	getClassOr(Object aKey, Class<C> aDefaultValue)	Returns the Class value of the property referred to by the key or the provided default value if there is no such value for the given key.
default <C> Class<C>	getClassOr(String[] aPathElements, Class<C> aDefaultValue)	Returns the Class value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <C> Class<C>	getClassOr(String aKey, Class<C> aDefaultValue)	Returns the Class value of the property referred to by the key or the provided default value if there is no such value for the given key.
default <C> Class<C>	getClassOr(Collection<?> aPathElements, Class<C> aDefaultValue)	Returns the Class value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Double	getDouble(Object aKey)	Returns the Double value of the property referred to by the key.
default Double	getDouble(Object... aPathElements)	Returns the Double value of the property referred to by the path elements.
default Double	getDouble(String aKey)	Returns the Double value of the property referred to by the key.
default Double	getDouble(String... aPathElements)	Returns the Double value of the property referred to by the path elements.
default Double	getDouble(Collection<?> aPathElements)	Returns the Double value of the property referred to by the path elements.
default Double	getDoubleOr(Object[] aPathElements, Double aDefaultValue)	Returns the Double value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Double	getDoubleOr(Object aKey, Double aDefaultValue)	Returns the Double value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Double	getDoubleOr(String[] aPathElements, Double aDefaultValue)	Returns the Double value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Double	getDoubleOr(String aKey, Double aDefaultValue)	Returns the Double value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Double	getDoubleOr(Collection<?> aPathElements, Double aDefaultValue)	Returns the Double value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <E extends Enum<E>> E	getEnum(Class<E> aEnumType, Object aKey)	Returns the Enum value of the property referred to by the key.
default <E extends Enum<E>> E	getEnum(Class<E> aEnumType, Object... aPathElements)	Returns the Enum value of the property referred to by the path elements.
default <E extends Enum<E>> E	getEnum(Class<E> aEnumType, String aKey)	Returns the Enum value of the property referred to by the key.
default <E extends Enum<E>> E	getEnum(Class<E> aEnumType, String... aPathElements)	Returns the Enum value of the property referred to by the key.
default <E extends Enum<E>> E	getEnum(Class<E> aEnumType, Collection<?> aPathElements)	Returns the Enum value of the property referred to by the path elements.
default <E extends Enum<E>> E	getEnumOr(Class<E> aEnumType, Object[] aPathElements, E aDefaultValue)	Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <E extends Enum<E>> E	getEnumOr(Class<E> aEnumType, Object aKey, E aDefaultValue)	Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key.
default <E extends Enum<E>> E	getEnumOr(Class<E> aEnumType, String[] aPathElements, E aDefaultValue)	Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <E extends Enum<E>> E	getEnumOr(Class<E> aEnumType, String aKey, E aDefaultValue)	Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key.
default <E extends Enum<E>> E	getEnumOr(Class<E> aEnumType, Collection<?> aPathElements, E aDefaultValue)	Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <E extends Enum<E>> E	getEnumOr(Object[] aPathElements, E aDefaultValue)	Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <E extends Enum<E>> E	getEnumOr(Object aKey, E aDefaultValue)	Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key.
default <E extends Enum<E>> E	getEnumOr(String[] aPathElements, E aDefaultValue)	Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default <E extends Enum<E>> E	getEnumOr(String aKey, E aDefaultValue)	Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key.
default <E extends Enum<E>> E	getEnumOr(Collection<?> aPathElements, E aDefaultValue)	Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Float	getFloat(Object aKey)	Returns the Float value of the property referred to by the key.
default Float	getFloat(Object... aPathElements)	Returns the Float value of the property referred to by the path elements.
default Float	getFloat(String aKey)	Returns the Float value of the property referred to by the key.
default Float	getFloat(String... aPathElements)	Returns the Float value of the property referred to by the path elements.
default Float	getFloat(Collection<?> aPathElements)	Returns the Float value of the property referred to by the path elements.
default Float	getFloatOr(Object[] aPathElements, Float aDefaultValue)	Returns the Float value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Float	getFloatOr(Object aKey, Float aDefaultValue)	Returns the Float value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Float	getFloatOr(String[] aPathElements, Float aDefaultValue)	Returns the Float value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Float	getFloatOr(String aKey, Float aDefaultValue)	Returns the Float value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Float	getFloatOr(Collection<?> aPathElements, Float aDefaultValue)	Returns the Float value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Integer	getInt(Object aKey)	Returns the Integer value of the property referred to by the key.
default Integer	getInt(Object... aPathElements)	Returns the Integer value of the property referred to by the path elements.
default Integer	getInt(String aKey)	Returns the Integer value of the property referred to by the key.
default Integer	getInt(String... aPathElements)	Returns the Integer value of the property referred to by the path elements.
default Integer	getInt(Collection<?> aPathElements)	Returns the Integer value of the property referred to by the path elements.
default Integer	getIntOr(Object[] aPathElements, Integer aDefaultValue)	Returns the Integer value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Integer	getIntOr(Object aKey, Integer aDefaultValue)	Returns the Integer value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Integer	getIntOr(String[] aPathElements, Integer aDefaultValue)	Returns the Integer value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Integer	getIntOr(String aKey, Integer aDefaultValue)	Returns the Integer value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Integer	getIntOr(Collection<?> aPathElements, Integer aDefaultValue)	Returns the Integer value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Long	getLong(Object aKey)	Returns the Long value of the property referred to by the key.
default Long	getLong(Object... aPathElements)	Returns the Long value of the property referred to by the path elements.
default Long	getLong(String aKey)	Returns the Long value of the property referred to by the key.
default Long	getLong(String... aPathElements)	Returns the Long value of the property referred to by the path elements.
default Long	getLong(Collection<?> aPathElements)	Returns the Long value of the property referred to by the path elements.
default Long	getLongOr(Object[] aPathElements, Long aDefaultValue)	Returns the Long value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Long	getLongOr(Object aKey, Long aDefaultValue)	Returns the Long value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Long	getLongOr(String[] aPathElements, Long aDefaultValue)	Returns the Long value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Long	getLongOr(String aKey, Long aDefaultValue)	Returns the Long value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Long	getLongOr(Collection<?> aPathElements, Long aDefaultValue)	Returns the Long value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Short	getShort(Object aKey)	Returns the Short value of the property referred to by the key.
default Short	getShort(Object... aPathElements)	Returns the Short value of the property referred to by the path elements.
default Short	getShort(String aKey)	Returns the Short value of the property referred to by the key.
default Short	getShort(String... aPathElements)	Returns the Short value of the property referred to by the path elements.
default Short	getShort(Collection<?> aPathElements)	Returns the Short value of the property referred to by the path elements.
default Short	getShortOr(Object[] aPathElements, Short aDefaultValue)	Returns the Short value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Short	getShortOr(Object aKey, Short aDefaultValue)	Returns the Short value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Short	getShortOr(String[] aPathElements, Short aDefaultValue)	Returns the Short value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default Short	getShortOr(String aKey, Short aDefaultValue)	Returns the Short value of the property referred to by the key or the provided default value if there is no such value for the given key.
default Short	getShortOr(Collection<?> aPathElements, Short aDefaultValue)	Returns the Short value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default String	getString(Object aKey)	Returns the String value of the property referred to by the key.
default String	getString(Object... aPathElements)	Returns the String value of the property referred to by the path elements.
default String	getString(String aKey)	Returns the String value of the property referred to by the key.
default String	getString(String... aPathElements)	Returns the String value of the property referred to by the path elements.
default String	getString(Collection<?> aPathElements)	Returns the String value of the property referred to by the path elements.
default String	getStringOr(Object[] aPathElements, String aDefaultValue)	Returns the String value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default String	getStringOr(Object aKey, String aDefaultValue)	Returns the String value of the property referred to by the key or the provided default value if there is no such value for the given key.
default String	getStringOr(String[] aPathElements, String aDefaultValue)	Returns the String value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.
default String	getStringOr(String aKey, String aDefaultValue)	Returns the String value of the property referred to by the key or the provided default value if there is no such value for the given key.
default String	getStringOr(Collection<?> aPathElements, String aDefaultValue)	Returns the String value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path.

Methods inherited from interface org.refcodes.mixin.AnnotatorAccessor

getAnnotator

Methods inherited from interface org.refcodes.struct.Containable

size

Methods inherited from interface org.refcodes.mixin.DelimiterAccessor

getDelimiter

Methods inherited from interface org.refcodes.mixin.Dumpable

toDump, toDump

Methods inherited from interface org.refcodes.mixin.EmptyAccessor

isEmpty

Methods inherited from interface org.refcodes.struct.Keys

containsKey, containsValue, get, getOr, keySet, use, values

Methods inherited from interface org.refcodes.struct.PathMap

children, children, children, children, children, children, containsKey, containsKey, containsKey, dirs, dirs, dirs, dirs, dirs, dirs, findPaths, fromExternalPath, get, get, get, getArray, getArray, getArray, getArray, getArray, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayIndexes, getArrayOr, getArrayOr, getArrayOr, getArrayOr, getArrayOr, getDir, getDir, getDir, getDir, getDir, getDirAt, getDirAt, getDirAt, getDirAt, getDirAt, getDirAt, getDirIndexes, getDirIndexes, getDirIndexes, getDirIndexes, getDirIndexes, getDirs, getDirs, getDirs, getDirs, getDirs, getRootPath, getValueAt, getValueAt, getValueAt, getValueAt, getValueAt, getValueAt, hasChildren, hasChildren, hasChildren, hasChildren, hasChildren, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasDirAt, hasParentPath, hasPath, hasPath, hasPath, hasPath, hasSubDirs, hasSubDirs, hasSubDirs, hasSubDirs, hasValue, hasValue, hasValue, hasValue, hasValue, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, hasValueAt, isArray, isArray, isArray, isArray, isArray, isArray, isChild, isChild, isChild, isChild, isDir, isDir, isDir, isDir, isDir, isEqualTo, isIndexDir, isIndexDir, isIndexDir, isIndexDir, isIndexDir, isLeaf, isLeaf, isLeaf, isLeaf, isLeaf, isRootPath, keySet, keySet, keySet, keySet, keySet, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastArrayIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, lastDirIndex, leaves, leaves, leaves, leaves, leaves, leaves, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextArrayIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, nextDirIndex, paths, paths, paths, paths, paths, paths, query, query, query, query, query, queryBetween, queryBetween, queryBetween, queryBetween, queryBetween, queryBetween, queryFrom, queryFrom, queryFrom, queryFrom, queryFrom, queryFrom, queryPaths, queryPaths, queryPaths, queryPaths, queryPaths, queryPaths, queryTo, queryTo, queryTo, queryTo, queryTo, queryTo, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveBetween, retrieveFrom, retrieveFrom, retrieveFrom, retrieveFrom, retrieveFrom, retrieveTo, retrieveTo, retrieveTo, retrieveTo, retrieveTo, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, sortedKeys, toDataStructure, toDataStructure, toExternalPath, toInstance, toInstance, toLeaf, toMap, toMap, toNormalizedPath, toParentPath, toPath, toPath, toPath, toPath, toPathElements, toPathList, toPathStack, toPrintable, toPropertyPath, toType, toType, toType, toType, toType, toType, toType, toType

Methods inherited from interface org.refcodes.mixin.TypeAccessor

getType

Method Details

getBoolean

default Boolean getBoolean(Object... aPathElements)
                    throws NumberFormatException

Returns the Boolean value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBoolean

default Boolean getBoolean(Collection<?> aPathElements)
                    throws NumberFormatException

Returns the Boolean value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBoolean

default Boolean getBoolean(Object aKey)
                    throws NumberFormatException

Returns the Boolean value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBoolean

default Boolean getBoolean(String... aPathElements)
                    throws NumberFormatException

Returns the Boolean value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBoolean

default Boolean getBoolean(String aKey)
                    throws NumberFormatException

Returns the Boolean value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBooleanOr

default Boolean getBooleanOr(Object aKey,
 Boolean aDefaultValue)
                      throws NumberFormatException

Returns the Boolean value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBooleanOr

default Boolean getBooleanOr(Object[] aPathElements,
 Boolean aDefaultValue)
                      throws NumberFormatException

Returns the Boolean value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBooleanOr

default Boolean getBooleanOr(Collection<?> aPathElements,
 Boolean aDefaultValue)
                      throws NumberFormatException

Returns the Boolean value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBooleanOr

default Boolean getBooleanOr(String aKey,
 Boolean aDefaultValue)
                      throws NumberFormatException

Returns the Boolean value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getBooleanOr

default Boolean getBooleanOr(String[] aPathElements,
 Boolean aDefaultValue)
                      throws NumberFormatException

Returns the Boolean value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Boolean representation of the key's String value of false if there is no such key.

Throws:

NumberFormatException - thrown in case conversion fails.

getByte

default Byte getByte(Object... aPathElements)
              throws NumberFormatException

Returns the Byte value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByte

default Byte getByte(Collection<?> aPathElements)
              throws NumberFormatException

Returns the Byte value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByte

default Byte getByte(Object aKey)
              throws NumberFormatException

Returns the Byte value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByte

default Byte getByte(String... aPathElements)
              throws NumberFormatException

Returns the Byte value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByte

default Byte getByte(String aKey)
              throws NumberFormatException

Returns the Byte value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByteOr

default Byte getByteOr(Object aKey,
 Byte aDefaultValue)
                throws NumberFormatException

Returns the Byte value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByteOr

default Byte getByteOr(Object[] aPathElements,
 Byte aDefaultValue)
                throws NumberFormatException

Returns the Byte value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByteOr

default Byte getByteOr(Collection<?> aPathElements,
 Byte aDefaultValue)
                throws NumberFormatException

Returns the Byte value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByteOr

default Byte getByteOr(String aKey,
 Byte aDefaultValue)
                throws NumberFormatException

Returns the Byte value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getByteOr

default Byte getByteOr(String[] aPathElements,
 Byte aDefaultValue)
                throws NumberFormatException

Returns the Byte value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Byte representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getChar

default Character getChar(Object aKey)
                   throws NumberFormatException

Returns the Character value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getChar

default Character getChar(String aKey)
                   throws NumberFormatException

Returns the Character value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getChar

default Character getChar(String... aPathElements)
                   throws NumberFormatException

Returns the Character value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getChar

default Character getChar(Object... aPathElements)
                   throws NumberFormatException

Returns the Character value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getChar

default Character getChar(Collection<?> aPathElements)
                   throws NumberFormatException

Returns the Character value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getCharOr

default Character getCharOr(Object aKey,
 Character aDefaultValue)
                     throws NumberFormatException

Returns the Character value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getCharOr

default Character getCharOr(Object[] aPathElements,
 Character aDefaultValue)
                     throws NumberFormatException

Returns the Character value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getCharOr

default Character getCharOr(Collection<?> aPathElements,
 Character aDefaultValue)
                     throws NumberFormatException

Returns the Character value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getCharOr

default Character getCharOr(String aKey,
 Character aDefaultValue)
                     throws NumberFormatException

Returns the Character value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getCharOr

default Character getCharOr(String[] aPathElements,
 Character aDefaultValue)
                     throws NumberFormatException

Returns the Character value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Character representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClass

default <C> Class<C> getClass(Object... aPathElements)
                       throws NumberFormatException

Returns the Class value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClass

default <C> Class<C> getClass(Collection<?> aPathElements)
                       throws NumberFormatException

Returns the Class value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClass

default <C> Class<C> getClass(Object aKey)
                       throws NumberFormatException

Returns the Class value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClass

default <C> Class<C> getClass(String... aPathElements)
                       throws NumberFormatException

Returns the Class value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClass

default <C> Class<C> getClass(String aKey)
                       throws NumberFormatException

Returns the Class value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClassOr

default <C> Class<C> getClassOr(Object aKey,
 Class<C> aDefaultValue)
                         throws NumberFormatException

Returns the Class value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClassOr

default <C> Class<C> getClassOr(Object[] aPathElements,
 Class<C> aDefaultValue)
                         throws NumberFormatException

Returns the Class value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClassOr

default <C> Class<C> getClassOr(Collection<?> aPathElements,
 Class<C> aDefaultValue)
                         throws NumberFormatException

Returns the Class value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClassOr

default <C> Class<C> getClassOr(String aKey,
 Class<C> aDefaultValue)
                         throws NumberFormatException

Returns the Class value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getClassOr

default <C> Class<C> getClassOr(String[] aPathElements,
 Class<C> aDefaultValue)
                         throws NumberFormatException

Returns the Class value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

C - The type of the class in question.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Class representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDouble

default Double getDouble(Object... aPathElements)
                  throws NumberFormatException

Returns the Double value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDouble

default Double getDouble(Collection<?> aPathElements)
                  throws NumberFormatException

Returns the Double value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDouble

default Double getDouble(Object aKey)
                  throws NumberFormatException

Returns the Double value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDouble

default Double getDouble(String... aPathElements)
                  throws NumberFormatException

Returns the Double value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDouble

default Double getDouble(String aKey)
                  throws NumberFormatException

Returns the Double value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDoubleOr

default Double getDoubleOr(Object aKey,
 Double aDefaultValue)
                    throws NumberFormatException

Returns the Double value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDoubleOr

default Double getDoubleOr(Object[] aPathElements,
 Double aDefaultValue)
                    throws NumberFormatException

Returns the Double value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDoubleOr

default Double getDoubleOr(Collection<?> aPathElements,
 Double aDefaultValue)
                    throws NumberFormatException

Returns the Double value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDoubleOr

default Double getDoubleOr(String aKey,
 Double aDefaultValue)
                    throws NumberFormatException

Returns the Double value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getDoubleOr

default Double getDoubleOr(String[] aPathElements,
 Double aDefaultValue)
                    throws NumberFormatException

Returns the Double value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Double representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnum

default <E extends Enum<E>> E getEnum(Class<E> aEnumType,
 Object aKey)
                               throws NumberFormatException

Returns the Enum value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aKey - The key for which to retrieve the value.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnum

default <E extends Enum<E>> E getEnum(Class<E> aEnumType,
 String aKey)
                               throws NumberFormatException

Returns the Enum value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aKey - The key for which to retrieve the value.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnum

default <E extends Enum<E>> E getEnum(Class<E> aEnumType,
 String... aPathElements)
                               throws NumberFormatException

Returns the Enum value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aPathElements - The path elements for which to retrieve the value.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnum

default <E extends Enum<E>> E getEnum(Class<E> aEnumType,
 Object... aPathElements)
                               throws NumberFormatException

Returns the Enum value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aPathElements - The path elements for which to retrieve the value.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnum

default <E extends Enum<E>> E getEnum(Class<E> aEnumType,
 Collection<?> aPathElements)
                               throws NumberFormatException

Returns the Enum value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aPathElements - The path elements for which to retrieve the value.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Class<E> aEnumType,
 Object aKey,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Class<E> aEnumType,
 Object[] aPathElements,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Class<E> aEnumType,
 Collection<?> aPathElements,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Class<E> aEnumType,
 String aKey,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Class<E> aEnumType,
 String[] aPathElements,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Type Parameters:

E - The type of the enumeration in question.

Parameters:

aEnumType - The type of the enumeration in question.

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Object aKey,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Object[] aPathElements,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(Collection<?> aPathElements,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(String aKey,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getEnumOr

default <E extends Enum<E>> E getEnumOr(String[] aPathElements,
 E aDefaultValue)
                                 throws NumberFormatException

Returns the Enum value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Enum representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloat

default Float getFloat(Object... aPathElements)
                throws NumberFormatException

Returns the Float value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloat

default Float getFloat(Collection<?> aPathElements)
                throws NumberFormatException

Returns the Float value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloat

default Float getFloat(Object aKey)
                throws NumberFormatException

Returns the Float value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloat

default Float getFloat(String... aPathElements)
                throws NumberFormatException

Returns the Float value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloat

default Float getFloat(String aKey)
                throws NumberFormatException

Returns the Float value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloatOr

default Float getFloatOr(Object aKey,
 Float aDefaultValue)
                  throws NumberFormatException

Returns the Float value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloatOr

default Float getFloatOr(Object[] aPathElements,
 Float aDefaultValue)
                  throws NumberFormatException

Returns the Float value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloatOr

default Float getFloatOr(Collection<?> aPathElements,
 Float aDefaultValue)
                  throws NumberFormatException

Returns the Float value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloatOr

default Float getFloatOr(String aKey,
 Float aDefaultValue)
                  throws NumberFormatException

Returns the Float value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getFloatOr

default Float getFloatOr(String[] aPathElements,
 Float aDefaultValue)
                  throws NumberFormatException

Returns the Float value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Float representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getInt

default Integer getInt(Object... aPathElements)
                throws NumberFormatException

Returns the Integer value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getInt

default Integer getInt(Collection<?> aPathElements)
                throws NumberFormatException

Returns the Integer value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getInt

default Integer getInt(Object aKey)
                throws NumberFormatException

Returns the Integer value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getInt

default Integer getInt(String... aPathElements)
                throws NumberFormatException

Returns the Integer value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getInt

default Integer getInt(String aKey)
                throws NumberFormatException

Returns the Integer value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getIntOr

default Integer getIntOr(Object aKey,
 Integer aDefaultValue)
                  throws NumberFormatException

Returns the Integer value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getIntOr

default Integer getIntOr(Object[] aPathElements,
 Integer aDefaultValue)
                  throws NumberFormatException

Returns the Integer value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getIntOr

default Integer getIntOr(Collection<?> aPathElements,
 Integer aDefaultValue)
                  throws NumberFormatException

Returns the Integer value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getIntOr

default Integer getIntOr(String aKey,
 Integer aDefaultValue)
                  throws NumberFormatException

Returns the Integer value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getIntOr

default Integer getIntOr(String[] aPathElements,
 Integer aDefaultValue)
                  throws NumberFormatException

Returns the Integer value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Integer representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLong

default Long getLong(Object... aPathElements)
              throws NumberFormatException

Returns the Long value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLong

default Long getLong(Collection<?> aPathElements)
              throws NumberFormatException

Returns the Long value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLong

default Long getLong(Object aKey)
              throws NumberFormatException

Returns the Long value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLong

default Long getLong(String... aPathElements)
              throws NumberFormatException

Returns the Long value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLong

default Long getLong(String aKey)
              throws NumberFormatException

Returns the Long value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLongOr

default Long getLongOr(Object aKey,
 Long aDefaultValue)
                throws NumberFormatException

Returns the Long value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLongOr

default Long getLongOr(Object[] aPathElements,
 Long aDefaultValue)
                throws NumberFormatException

Returns the Long value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLongOr

default Long getLongOr(Collection<?> aPathElements,
 Long aDefaultValue)
                throws NumberFormatException

Returns the Long value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLongOr

default Long getLongOr(String aKey,
 Long aDefaultValue)
                throws NumberFormatException

Returns the Long value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getLongOr

default Long getLongOr(String[] aPathElements,
 Long aDefaultValue)
                throws NumberFormatException

Returns the Long value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Long representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShort

default Short getShort(Object... aPathElements)
                throws NumberFormatException

Returns the Short value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShort

default Short getShort(Collection<?> aPathElements)
                throws NumberFormatException

Returns the Short value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShort

default Short getShort(Object aKey)
                throws NumberFormatException

Returns the Short value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShort

default Short getShort(String... aPathElements)
                throws NumberFormatException

Returns the Short value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShort

default Short getShort(String aKey)
                throws NumberFormatException

Returns the Short value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShortOr

default Short getShortOr(Object aKey,
 Short aDefaultValue)
                  throws NumberFormatException

Returns the Short value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShortOr

default Short getShortOr(Object[] aPathElements,
 Short aDefaultValue)
                  throws NumberFormatException

Returns the Short value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShortOr

default Short getShortOr(Collection<?> aPathElements,
 Short aDefaultValue)
                  throws NumberFormatException

Returns the Short value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShortOr

default Short getShortOr(String aKey,
 Short aDefaultValue)
                  throws NumberFormatException

Returns the Short value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getShortOr

default Short getShortOr(String[] aPathElements,
 Short aDefaultValue)
                  throws NumberFormatException

Returns the Short value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The Short representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getString

default String getString(Object... aPathElements)
                  throws NumberFormatException

Returns the String value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getString

default String getString(Collection<?> aPathElements)
                  throws NumberFormatException

Returns the String value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getString

default String getString(Object aKey)
                  throws NumberFormatException

Returns the String value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getString

default String getString(String... aPathElements)
                  throws NumberFormatException

Returns the String value of the property referred to by the path elements. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getString

default String getString(String aKey)
                  throws NumberFormatException

Returns the String value of the property referred to by the key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to retrieve the value.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getStringOr

default String getStringOr(Object aKey,
 String aDefaultValue)
                    throws NumberFormatException

Returns the String value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getStringOr

default String getStringOr(Object[] aPathElements,
 String aDefaultValue)
                    throws NumberFormatException

Returns the String value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getStringOr

default String getStringOr(Collection<?> aPathElements,
 String aDefaultValue)
                    throws NumberFormatException

Returns the String value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getStringOr

default String getStringOr(String aKey,
 String aDefaultValue)
                    throws NumberFormatException

Returns the String value of the property referred to by the key or the provided default value if there is no such value for the given key. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aKey - The key for which to get the element.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.

getStringOr

default String getStringOr(String[] aPathElements,
 String aDefaultValue)
                    throws NumberFormatException

Returns the String value of the property referred to by the path represented by the given path elements or the provided default value if there is no such value for the given path. As property keys and values are of type String, the String value is converted accordingly.

Parameters:

aPathElements - The path elements for which to retrieve the value.

aDefaultValue - The default value in case there is no such value for the given key.

Returns:

The String representation of the key's String value.

Throws:

NumberFormatException - thrown in case conversion fails.