|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.commons.configuration.event.EventSource org.apache.commons.configuration.AbstractConfiguration org.apache.commons.configuration.DataConfiguration
Decorator providing additional getters for any Configuration. This extended Configuration supports more types: URL, Locale, Date, Calendar, Color, as well as lists and arrays for all types.
Let us know if you find this useful, the most frequently used getters are likely to be integrated in the Configuration interface in a future version.
Field Summary | |
protected Configuration |
configuration
Stores the wrapped configuration. |
static String |
DATE_FORMAT_KEY
The key of the property storing the user defined date format. |
static String |
DEFAULT_DATE_FORMAT
The default format for dates. |
Fields inherited from class org.apache.commons.configuration.AbstractConfiguration |
END_TOKEN, EVENT_ADD_PROPERTY, EVENT_CLEAR, EVENT_CLEAR_PROPERTY, EVENT_SET_PROPERTY, START_TOKEN |
Constructor Summary | |
DataConfiguration(Configuration configuration)
Creates a new instance of DataConfiguration and sets the
wrapped configuration. |
Method Summary | |
protected void |
addPropertyDirect(String key,
Object obj)
Adds a key/value pair to the Configuration. |
void |
clearProperty(String key)
Removes the specified property from this configuration. |
boolean |
containsKey(String key)
Check if the configuration contains the specified key. |
BigDecimal[] |
getBigDecimalArray(String key)
Get an array of BigDecimals associated with the given configuration key. |
BigDecimal[] |
getBigDecimalArray(String key,
BigDecimal[] defaultValue)
Get an array of BigDecimals associated with the given configuration key. |
List |
getBigDecimalList(String key)
Get a list of BigDecimals associated with the given configuration key. |
List |
getBigDecimalList(String key,
List defaultValue)
Get a list of BigDecimals associated with the given configuration key. |
BigInteger[] |
getBigIntegerArray(String key)
Get an array of BigIntegers associated with the given configuration key. |
BigInteger[] |
getBigIntegerArray(String key,
BigInteger[] defaultValue)
Get an array of BigIntegers associated with the given configuration key. |
List |
getBigIntegerList(String key)
Get a list of BigIntegers associated with the given configuration key. |
List |
getBigIntegerList(String key,
List defaultValue)
Get a list of BigIntegers associated with the given configuration key. |
boolean[] |
getBooleanArray(String key)
Get an array of boolean primitives associated with the given configuration key. |
boolean[] |
getBooleanArray(String key,
boolean[] defaultValue)
Get an array of boolean primitives associated with the given configuration key. |
List |
getBooleanList(String key)
Get a list of Boolean objects associated with the given configuration key. |
List |
getBooleanList(String key,
List defaultValue)
Get a list of Boolean objects associated with the given configuration key. |
byte[] |
getByteArray(String key)
Get an array of byte primitives associated with the given configuration key. |
byte[] |
getByteArray(String key,
byte[] defaultValue)
Get an array of byte primitives associated with the given configuration key. |
List |
getByteList(String key)
Get a list of Byte objects associated with the given configuration key. |
List |
getByteList(String key,
List defaultValue)
Get a list of Byte objects associated with the given configuration key. |
Calendar |
getCalendar(String key)
Get a Calendar associated with the given configuration key. |
Calendar |
getCalendar(String key,
Calendar defaultValue)
Get a Calendar associated with the given configuration key. |
Calendar |
getCalendar(String key,
Calendar defaultValue,
String format)
Get a Calendar associated with the given configuration key. |
Calendar |
getCalendar(String key,
String format)
Get a Calendar associated with the given configuration key. |
Calendar[] |
getCalendarArray(String key)
Get an array of Calendars associated with the given configuration key. |
Calendar[] |
getCalendarArray(String key,
Calendar[] defaultValue)
Get an array of Calendars associated with the given configuration key. |
Calendar[] |
getCalendarArray(String key,
Calendar[] defaultValue,
String format)
Get an array of Calendars associated with the given configuration key. |
Calendar[] |
getCalendarArray(String key,
String format)
Get an array of Calendars associated with the given configuration key. |
List |
getCalendarList(String key)
Get a list of Calendars associated with the given configuration key. |
List |
getCalendarList(String key,
List defaultValue)
Get a list of Calendars associated with the given configuration key. |
List |
getCalendarList(String key,
List defaultValue,
String format)
Get a list of Calendars associated with the given configuration key. |
List |
getCalendarList(String key,
String format)
Get a list of Calendars associated with the given configuration key. |
Color |
getColor(String key)
Get a Color associated with the given configuration key. |
Color |
getColor(String key,
Color defaultValue)
Get a Color associated with the given configuration key. |
Color[] |
getColorArray(String key)
Get an array of Colors associated with the given configuration key. |
Color[] |
getColorArray(String key,
Color[] defaultValue)
Get an array of Colors associated with the given configuration key. |
List |
getColorList(String key)
Get a list of Colors associated with the given configuration key. |
List |
getColorList(String key,
List defaultValue)
Get a list of Colors associated with the given configuration key. |
Configuration |
getConfiguration()
Return the configuration decorated by this DataConfiguration. |
Date |
getDate(String key)
Get a Date associated with the given configuration key. |
Date |
getDate(String key,
Date defaultValue)
Get a Date associated with the given configuration key. |
Date |
getDate(String key,
Date defaultValue,
String format)
Get a Date associated with the given configuration key. |
Date |
getDate(String key,
String format)
Get a Date associated with the given configuration key. |
Date[] |
getDateArray(String key)
Get an array of Dates associated with the given configuration key. |
Date[] |
getDateArray(String key,
Date[] defaultValue)
Get an array of Dates associated with the given configuration key. |
Date[] |
getDateArray(String key,
Date[] defaultValue,
String format)
Get an array of Dates associated with the given configuration key. |
Date[] |
getDateArray(String key,
String format)
Get an array of Dates associated with the given configuration key. |
List |
getDateList(String key)
Get a list of Dates associated with the given configuration key. |
List |
getDateList(String key,
List defaultValue)
Get a list of Dates associated with the given configuration key. |
List |
getDateList(String key,
List defaultValue,
String format)
Get a list of Dates associated with the given configuration key. |
List |
getDateList(String key,
String format)
Get a list of Dates associated with the given configuration key. |
double[] |
getDoubleArray(String key)
Get an array of double primitives associated with the given configuration key. |
double[] |
getDoubleArray(String key,
double[] defaultValue)
Get an array of double primitives associated with the given configuration key. |
List |
getDoubleList(String key)
Get a list of Double objects associated with the given configuration key. |
List |
getDoubleList(String key,
List defaultValue)
Get a list of Double objects associated with the given configuration key. |
float[] |
getFloatArray(String key)
Get an array of float primitives associated with the given configuration key. |
float[] |
getFloatArray(String key,
float[] defaultValue)
Get an array of float primitives associated with the given configuration key. |
List |
getFloatList(String key)
Get a list of Float objects associated with the given configuration key. |
List |
getFloatList(String key,
List defaultValue)
Get a list of Float objects associated with the given configuration key. |
int[] |
getIntArray(String key)
Get an array of int primitives associated with the given configuration key. |
int[] |
getIntArray(String key,
int[] defaultValue)
Get an array of int primitives associated with the given configuration key. |
List |
getIntegerList(String key)
Get a list of Integer objects associated with the given configuration key. |
List |
getIntegerList(String key,
List defaultValue)
Get a list of Integer objects associated with the given configuration key. |
Iterator |
getKeys()
Get the list of the keys contained in the configuration. The returned iterator can be used to obtain all defined keys. Note that the exact behavior of the iterator's remove() method is specific to
a concrete implementation. It may remove the corresponding
property from the configuration, but this is not guaranteed. In any case
it is no replacement for calling
for this property. So it is
highly recommended to avoid using the iterator's remove()
method. |
Locale |
getLocale(String key)
Get a Locale associated with the given configuration key. |
Locale |
getLocale(String key,
Locale defaultValue)
Get a Locale associated with the given configuration key. |
Locale[] |
getLocaleArray(String key)
Get an array of Locales associated with the given configuration key. |
Locale[] |
getLocaleArray(String key,
Locale[] defaultValue)
Get an array of Locales associated with the given configuration key. |
List |
getLocaleList(String key)
Get a list of Locales associated with the given configuration key. |
List |
getLocaleList(String key,
List defaultValue)
Get a list of Locales associated with the given configuration key. |
long[] |
getLongArray(String key)
Get an array of long primitives associated with the given configuration key. |
long[] |
getLongArray(String key,
long[] defaultValue)
Get an array of long primitives associated with the given configuration key. |
List |
getLongList(String key)
Get a list of Long objects associated with the given configuration key. |
List |
getLongList(String key,
List defaultValue)
Get a list of Long objects associated with the given configuration key. |
Object |
getProperty(String key)
Gets a property from the configuration. |
short[] |
getShortArray(String key)
Get an array of short primitives associated with the given configuration key. |
short[] |
getShortArray(String key,
short[] defaultValue)
Get an array of short primitives associated with the given configuration key. |
List |
getShortList(String key)
Get a list of Short objects associated with the given configuration key. |
List |
getShortList(String key,
List defaultValue)
Get a list of Short objects associated with the given configuration key. |
URL |
getURL(String key)
Get an URL associated with the given configuration key. |
URL |
getURL(String key,
URL defaultValue)
Get an URL associated with the given configuration key. |
URL[] |
getURLArray(String key)
Get an array of URLs associated with the given configuration key. |
URL[] |
getURLArray(String key,
URL[] defaultValue)
Get an array of URLs associated with the given configuration key. |
List |
getURLList(String key)
Get a list of URLs associated with the given configuration key. |
List |
getURLList(String key,
List defaultValue)
Get a list of URLs associated with the given configuration key. |
boolean |
isEmpty()
Check if the configuration is empty. |
Methods inherited from class org.apache.commons.configuration.AbstractConfiguration |
addProperty, clear, clearPropertyDirect, getBigDecimal, getBigDecimal, getBigInteger, getBigInteger, getBoolean, getBoolean, getBoolean, getByte, getByte, getByte, getDefaultListDelimiter, getDelimiter, getDouble, getDouble, getDouble, getFloat, getFloat, getFloat, getInt, getInt, getInteger, getKeys, getList, getList, getListDelimiter, getLong, getLong, getLong, getProperties, getProperties, getShort, getShort, getShort, getString, getString, getStringArray, interpolate, interpolate, interpolateHelper, isDelimiterParsingDisabled, isThrowExceptionOnMissing, resolveContainerStore, setDefaultListDelimiter, setDelimiter, setDelimiterParsingDisabled, setListDelimiter, setProperty, setThrowExceptionOnMissing, subset |
Methods inherited from class org.apache.commons.configuration.event.EventSource |
addConfigurationListener, clearConfigurationListeners, createEvent, fireEvent, getConfigurationListeners, isDetailEvents, removeConfigurationListener, setDetailEvents |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final String DATE_FORMAT_KEY
public static final String DEFAULT_DATE_FORMAT
protected Configuration configuration
Constructor Detail |
public DataConfiguration(Configuration configuration)
DataConfiguration
and sets the
wrapped configuration.
configuration
- the wrapped configurationMethod Detail |
public Configuration getConfiguration()
public Object getProperty(String key)
Configuration
Configuration
interface the other get methods (that
return specific data types) will internally make use of this method. On
this level variable substitution is not yet performed. The returned
object is an internal representation of the property value for the passed
in key. It is owned by the Configuration
object. So a caller
should not modify this object. It cannot be guaranteed that this object
will stay constant over time (i.e. further update operations on the
configuration may change its internal state).
getProperty
in interface Configuration
key
- property to retrieve
protected void addPropertyDirect(String key, Object obj)
AbstractConfiguration
addPropertyDirect
in class AbstractConfiguration
key
- key to use for mappingobj
- object to storepublic boolean isEmpty()
AbstractConfiguration
isEmpty
in interface Configuration
isEmpty
in class AbstractConfiguration
public boolean containsKey(String key)
AbstractConfiguration
containsKey
in interface Configuration
containsKey
in class AbstractConfiguration
public void clearProperty(String key)
AbstractConfiguration
clearPropertyDirect()
, which will do the real work.
clearProperty
in interface Configuration
clearProperty
in class AbstractConfiguration
key
- the key to be removedpublic Iterator getKeys()
AbstractConfiguration
remove()
method is specific to
a concrete implementation. It may remove the corresponding
property from the configuration, but this is not guaranteed. In any case
it is no replacement for calling
Configuration.clearProperty(String)
for this property. So it is
highly recommended to avoid using the iterator's remove()
method.
getKeys
in interface Configuration
getKeys
in class AbstractConfiguration
public List getBooleanList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of booleans.public List getBooleanList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of booleans.public boolean[] getBooleanArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of booleans.public boolean[] getBooleanArray(String key, boolean[] defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of booleans.public List getByteList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of bytes.public List getByteList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of bytes.public byte[] getByteArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of bytes.public byte[] getByteArray(String key, byte[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of bytes.public List getShortList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of shorts.public List getShortList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of shorts.public short[] getShortArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of shorts.public short[] getShortArray(String key, short[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of shorts.public List getIntegerList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of integers.public List getIntegerList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of integers.public int[] getIntArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of integers.public int[] getIntArray(String key, int[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of integers.public List getLongList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of longs.public List getLongList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of longs.public long[] getLongArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of longs.public long[] getLongArray(String key, long[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of longs.public List getFloatList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of floats.public List getFloatList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of floats.public float[] getFloatArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of floats.public float[] getFloatArray(String key, float[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of floats.public List getDoubleList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of doubles.public List getDoubleList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of doubles.public double[] getDoubleArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of doubles.public double[] getDoubleArray(String key, double[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of doubles.public List getBigIntegerList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of BigIntegers.public List getBigIntegerList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of BigIntegers.public BigInteger[] getBigIntegerArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of BigIntegers.public BigInteger[] getBigIntegerArray(String key, BigInteger[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of BigIntegers.public List getBigDecimalList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of BigDecimals.public List getBigDecimalList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of BigDecimals.public BigDecimal[] getBigDecimalArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of BigDecimals.public BigDecimal[] getBigDecimalArray(String key, BigDecimal[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of BigDecimals.public URL getURL(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not an URL.public URL getURL(String key, URL defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not an URL.public List getURLList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of URLs.public List getURLList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of URLs.public URL[] getURLArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of URLs.public URL[] getURLArray(String key, URL[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of URLs.public Date getDate(String key)
DATE_FORMAT_KEY
property, or if it's not defined with the
DEFAULT_DATE_FORMAT
pattern.
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a Date.public Date getDate(String key, String format)
key
- The configuration key.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a Date.public Date getDate(String key, Date defaultValue)
DATE_FORMAT_KEY
property, or if it's not defined with the
DEFAULT_DATE_FORMAT
pattern. If the key doesn't map to an
existing object, the default value is returned.
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a Date.public Date getDate(String key, Date defaultValue, String format)
key
- The configuration key.defaultValue
- The default value.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a Date.public List getDateList(String key)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object an empty list is returned.
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public List getDateList(String key, String format)
key
- The configuration key.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public List getDateList(String key, List defaultValue)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object, the default value is
returned.
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public List getDateList(String key, List defaultValue, String format)
key
- The configuration key.defaultValue
- The default value.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public Date[] getDateArray(String key)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object an empty array is returned.
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public Date[] getDateArray(String key, String format)
key
- The configuration key.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public Date[] getDateArray(String key, Date[] defaultValue)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object an empty array is returned.
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public Date[] getDateArray(String key, Date[] defaultValue, String format)
key
- The configuration key.defaultValue
- The default value.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Dates.public Calendar getCalendar(String key)
DATE_FORMAT_KEY
property, or if it's not defined
with the DEFAULT_DATE_FORMAT
pattern.
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a Calendar.public Calendar getCalendar(String key, String format)
key
- The configuration key.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a Calendar.public Calendar getCalendar(String key, Calendar defaultValue)
DATE_FORMAT_KEY
property, or if it's not defined
with the DEFAULT_DATE_FORMAT
pattern. If the key doesn't map
to an existing object, the default value is returned.
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a Calendar.public Calendar getCalendar(String key, Calendar defaultValue, String format)
key
- The configuration key.defaultValue
- The default value.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a Calendar.public List getCalendarList(String key)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object an empty list is returned.
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public List getCalendarList(String key, String format)
key
- The configuration key.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public List getCalendarList(String key, List defaultValue)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object, the default value is
returned.
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public List getCalendarList(String key, List defaultValue, String format)
key
- The configuration key.defaultValue
- The default value.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public Calendar[] getCalendarArray(String key)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object an empty array is returned.
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public Calendar[] getCalendarArray(String key, String format)
key
- The configuration key.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public Calendar[] getCalendarArray(String key, Calendar[] defaultValue)
DATE_FORMAT_KEY
property,
or if it's not defined with the DEFAULT_DATE_FORMAT
pattern.
If the key doesn't map to an existing object an empty array is returned.
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public Calendar[] getCalendarArray(String key, Calendar[] defaultValue, String format)
key
- The configuration key.defaultValue
- The default value.format
- The non-localized DateFormat
pattern.
ConversionException
- is thrown if the key maps to an
object that is not a list of Calendars.public Locale getLocale(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a Locale.public Locale getLocale(String key, Locale defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a Locale.public List getLocaleList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Locales.public List getLocaleList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of Locales.public Locale[] getLocaleArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Locales.public Locale[] getLocaleArray(String key, Locale[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of Locales.public Color getColor(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a Color.public Color getColor(String key, Color defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a Color.public List getColorList(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Colors.public List getColorList(String key, List defaultValue)
key
- The configuration key.defaultValue
- The default value.
ConversionException
- is thrown if the key maps to an
object that is not a list of Colors.public Color[] getColorArray(String key)
key
- The configuration key.
ConversionException
- is thrown if the key maps to an
object that is not a list of Colors.public Color[] getColorArray(String key, Color[] defaultValue)
key
- The configuration key.defaultValue
- the default value, which will be returned if the property is not found
ConversionException
- is thrown if the key maps to an
object that is not a list of Colors.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |