/*

  * Licensed to the Apache Software Foundation (ASF) under one or more

  * contributor license agreements.  See the NOTICE file distributed with

  * this work for additional information regarding copyright ownership.

  * The ASF licenses this file to You under the Apache License, Version 2.0

  * (the "License"); you may not use this file except in compliance with

  * the License.  You may obtain a copy of the License at

  *

  *     http://www.apache.org/licenses/LICENSE-2.0

  *

  * Unless required by applicable law or agreed to in writing, software

  * distributed under the License is distributed on an "AS IS" BASIS,

  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  * See the License for the specific language governing permissions and

  * limitations under the License.

  */

 package org.apache.commons.configuration;

 import java.awt.Color;

 import java.io.Serializable;

 import java.lang.reflect.Array;

 import java.math.BigDecimal;

 import java.math.BigInteger;

 import java.net.URL;

 import java.util.ArrayList;

 import java.util.Calendar;

 import java.util.Collection;

 import java.util.Date;

 import java.util.Iterator;

 import java.util.List;

 import java.util.Locale;

 import java.util.NoSuchElementException;

 import org.apache.commons.lang.ClassUtils;

 import org.apache.commons.lang.StringUtils;

 /**

  * Decorator providing additional getters for any Configuration. This extended

  * Configuration supports more types:

  * <ul>

  *   <li>{@link java.net.URL}</li>

  *   <li>{@link java.util.Locale}</li>

  *   <li>{@link java.util.Date}</li>

  *   <li>{@link java.util.Calendar}</li>

  *   <li>{@link java.awt.Color}</li>

  *   <li>{@link java.net.InetAddress}</li>

  *   <li>{@link javax.mail.internet.InternetAddress} (requires Javamail in the classpath)</li>

  *   <li>{@link java.lang.Enum} (Java 5 enumeration types)</li>

  * </ul>

  *

  * Lists and arrays are available for all types.

  *

  * <h4>Example</h4>

  *

  * Configuration file <tt>config.properties</tt>:

  * <pre>

  * title.color = #0000FF

  * remote.host = 192.168.0.53

  * default.locales = fr,en,de

  * email.contact = ebourg@apache.org, oheger@apache.org

  * </pre>

  *

  * Usage:

  *

  * <pre>

  * DataConfiguration config = new DataConfiguration(new PropertiesConfiguration("config.properties"));

  *

  * // retrieve a property using a specialized getter

  * Color color = config.getColor("title.color");

  *

  * // retrieve a property using a generic getter

  * InetAddress host = (InetAddress) config.get(InetAddress.class, "remote.host");

  * Locale[] locales = (Locale[]) config.getArray(Locale.class, "default.locales");

  * List contacts = config.getList(InternetAddress.class, "email.contact");

  * </pre>

  *

  * <h4>Dates</h4>

  *

  * Date objects are expected to be formatted with the pattern <tt>yyyy-MM-dd HH:mm:ss</tt>.

  * This default format can be changed by specifying another format in the

  * getters, or by putting a date format in the configuration under the key

  * <tt>org.apache.commons.configuration.format.date</tt>.

  *

  * @author <a href="ebourg@apache.org">Emmanuel Bourg</a>

  * @version $Revision: 589380 $, $Date: 2007-10-28 17:37:35 +0100 (So, 28 Okt 2007) $

  * @since 1.1

  */

 public class DataConfiguration extends AbstractConfiguration implements Serializable

 {

     /** The key of the property storing the user defined date format. */

     public static final String DATE_FORMAT_KEY = "org.apache.commons.configuration.format.date";

     /** The default format for dates. */

     public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd HH:mm:ss";

     /**

      * The serial version UID.

      */

     private static final long serialVersionUID = -69011336405718640L;

     /** Stores the wrapped configuration.*/

     protected Configuration configuration;

     /**

      * Creates a new instance of <code>DataConfiguration</code> and sets the

      * wrapped configuration.

      *

      * @param configuration the wrapped configuration

      */

     public DataConfiguration(Configuration configuration)

     {

         this.configuration = configuration;

     }

     /**

      * Return the configuration decorated by this DataConfiguration.

      *

      * @return the wrapped configuration

      */

     public Configuration getConfiguration()

     {

         return configuration;

     }

     public Object getProperty(String key)

     {

         return configuration.getProperty(key);

     }

     protected void addPropertyDirect(String key, Object obj)

     {

         if (configuration instanceof AbstractConfiguration)

         {

             ((AbstractConfiguration) configuration).addPropertyDirect(key, obj);

         }

         else

         {

             configuration.addProperty(key, obj);

         }

     }

     public boolean isEmpty()

     {

         return configuration.isEmpty();

     }

     public boolean containsKey(String key)

     {

         return configuration.containsKey(key);

     }

     public void clearProperty(String key)

     {

         configuration.clearProperty(key);

     }

     public Iterator getKeys()

     {

         return configuration.getKeys();

     }

     /**

      * Get an object of the specified type associated with the given

      * configuration key. If the key doesn't map to an existing object, the

      * method returns null unless {@link #isThrowExceptionOnMissing()} is set

      * to <tt>true</tt>.

      *

      * @param cls the target type of the value

      * @param key the key of the value

      *

      * @return the value of the requested type for the key

      *

      * @throws NoSuchElementException if the key doesn't map to an existing

      *     object and <tt>throwExceptionOnMissing=true</tt>

      * @throws ConversionException if the value is not compatible with the requested type

      *

      * @since 1.5

      */

     public Object get(Class cls, String key)

     {

         Object value = get(cls, key, null);

         if (value != null)

         {

             return value;

         }

         else if (isThrowExceptionOnMissing())

         {

             throw new NoSuchElementException('\'' + key + "' doesn't map to an existing object");

         }

         else

         {

             return null;

         }

     }

     /**

      * Get an object of the specified type associated with the given

      * configuration key. If the key doesn't map to an existing object, the

      * default value is returned.

      *

      * @param cls          the target type of the value

      * @param key          the key of the value

      * @param defaultValue the default value

      *

      * @return the value of the requested type for the key

      *

      * @throws ConversionException if the value is not compatible with the requested type

      *

      * @since 1.5

      */

     public Object get(Class cls, String key, Object defaultValue)

     {

         Object value = resolveContainerStore(key);

         if (value == null)

         {

             return defaultValue;

         }

         else

         {

             try

             {

                 if (Date.class.equals(cls) || Calendar.class.equals(cls))

                 {

                     return PropertyConverter.to(cls, interpolate(value), new String[] {getDefaultDateFormat()});

                 }

                 else

                 {

                     return PropertyConverter.to(cls, interpolate(value), null);

                 }

             }

             catch (ConversionException e)

             {

                 throw new ConversionException('\'' + key + "' doesn't map to a " + cls, e);

             }

         }

     }

     /**

      * Get a list of typed objects associated with the given configuration key.

      * If the key doesn't map to an existing object, an empty list is returned.

      *

      * @param cls the type expected for the elements of the list

      * @param key The configuration key.

      * @return The associated list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an object that

      *     is not compatible with a list of the specified class.

      *

      * @since 1.5

      */

     public List getList(Class cls, String key)

     {

         return getList(cls, key, new ArrayList());

     }

     /**

      * Get a list of typed objects associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param cls the      type expected for the elements of the list

      * @param key          the configuration key.

      * @param defaultValue the default value.

      * @return The associated List.

      *

      * @throws ConversionException is thrown if the key maps to an object that

      *     is not compatible with a list of the specified class.

      *

      * @since 1.5

      */

     public List getList(Class cls, String key, List defaultValue)

     {

         Object value = getProperty(key);

         Class valueClass = value != null ? value.getClass() : null;

         List list;

         if (value == null || (value instanceof String && StringUtils.isEmpty((String) value)))

         {

             // the value is null or is an empty string

             list = defaultValue;

         }

         else

         {

             list = new ArrayList();

             Object[] params = null;

             if (cls.equals(Date.class) || cls.equals(Calendar.class))

             {

                 params = new Object[] {getDefaultDateFormat()};

             }

             try

             {

                 if (valueClass.isArray())

                 {

                     // get the class of the objects contained in the array

                     Class arrayType = valueClass.getComponentType();

                     int length = Array.getLength(value);

                     if (arrayType.equals(cls)

                             || (arrayType.isPrimitive() && cls.equals(ClassUtils.primitiveToWrapper(arrayType))))

                     {

                         // the value is an array of the specified type, or an array

                         // of the primitive type derived from the specified type

                         for (int i = 0; i < length; i++)

                         {

                             list.add(Array.get(value, i));

                         }

                     }

                     else

                     {

                         // attempt to convert the elements of the array

                         for (int i = 0; i < length; i++)

                         {

                             list.add(PropertyConverter.to(cls, interpolate(Array.get(value, i)), params));

                         }

                     }

                 }

                 else if (value instanceof Collection)

                 {

                     Collection values = (Collection) value;

                     Iterator it = values.iterator();

                     while (it.hasNext())

                     {

                         list.add(PropertyConverter.to(cls, interpolate(it.next()), params));

                     }

                 }

                 else

                 {

                     // attempt to convert a single value

                     list.add(PropertyConverter.to(cls, interpolate(value), params));

                 }

             }

             catch (ConversionException e)

             {

                 throw new ConversionException("'" + key + "' doesn't map to a list of " + cls, e);

             }

         }

         return list;

     }

     /**

      * Get an array of typed objects associated with the given configuration key.

      * If the key doesn't map to an existing object, an empty list is returned.

      *

      * @param cls the type expected for the elements of the array

      * @param key The configuration key.

      * @return The associated array if the key is found, and the value compatible with the type specified.

      *

      * @throws ConversionException is thrown if the key maps to an object that

      *     is not compatible with a list of the specified class.

      *

      * @since 1.5

      */

     public Object getArray(Class cls, String key)

     {

         return getArray(cls, key, Array.newInstance(cls, 0));

     }

     /**

      * Get an array of typed objects associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is returned.

      *

      * @param cls          the type expected for the elements of the array

      * @param key          the configuration key.

      * @param defaultValue the default value

      * @return The associated array if the key is found, and the value compatible with the type specified.

      *

      * @throws ConversionException is thrown if the key maps to an object that

      *     is not compatible with an array of the specified class.

      * @throws IllegalArgumentException if the default value is not an array of the specified type

      *

      * @since 1.5

      */

     public Object getArray(Class cls, String key, Object defaultValue)

     {

         // check the type of the default value

         if (defaultValue != null

                 && (!defaultValue.getClass().isArray() || !cls

                         .isAssignableFrom(defaultValue.getClass()

                                 .getComponentType())))

         {

             throw new IllegalArgumentException(

                     "The type of the default value (" + defaultValue.getClass()

                             + ")" + " is not an array of the specified class ("

                             + cls + ")");

         }

         if (cls.isPrimitive())

         {

             return getPrimitiveArray(cls, key, defaultValue);

         }

         List list = getList(cls, key);

         if (list.isEmpty())

         {

             return defaultValue;

         }

         else

         {

             return list.toArray((Object[]) Array.newInstance(cls, list.size()));

         }

     }

     /**

      * Get an array of primitive values associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is returned.

      *

      * @param cls          the primitive type expected for the elements of the array

      * @param key          the configuration key.

      * @param defaultValue the default value

      * @return The associated array if the key is found, and the value compatible with the type specified.

      *

      * @throws ConversionException is thrown if the key maps to an object that

      *     is not compatible with an array of the specified class.

      *

      * @since 1.5

      */

     private Object getPrimitiveArray(Class cls, String key, Object defaultValue)

     {

         Object value = getProperty(key);

         Class valueClass = value != null ? value.getClass() : null;

         Object array;

         if (value == null || (value instanceof String && StringUtils.isEmpty((String) value)))

         {

             // the value is null or is an empty string

             array = defaultValue;

         }

         else

         {

             if (valueClass.isArray())

             {

                 // get the class of the objects contained in the array

                 Class arrayType = valueClass.getComponentType();

                 int length = Array.getLength(value);

                 if (arrayType.equals(cls))

                 {

                     // the value is an array of the same primitive type

                     array = value;

                 }

                 else if (arrayType.equals(ClassUtils.primitiveToWrapper(cls)))

                 {

                     // the value is an array of the wrapper type derived from the specified primitive type

                     array = Array.newInstance(cls, length);

                     for (int i = 0; i < length; i++)

                     {

                         Array.set(array, i, Array.get(value, i));

                     }

                 }

                 else

                 {

                     throw new ConversionException('\'' + key + "' (" + arrayType + ")"

                             + " doesn't map to a compatible array of " + cls);

                 }

             }

             else if (value instanceof Collection)

             {

                 Collection values = (Collection) value;

                 array = Array.newInstance(cls, values.size());

                 Iterator it = values.iterator();

                 int i = 0;

                 while (it.hasNext())

                 {

                     Array.set(array, i++, PropertyConverter.to(cls, interpolate(it.next()), null));

                 }

             }

             else

             {

                 try

                 {

                     // attempt to convert a single value

                     Object convertedValue = PropertyConverter.to(cls, interpolate(value), null);

                     // create an array of one element

                     array = Array.newInstance(cls, 1);

                     Array.set(array, 0, convertedValue);

                 }

                 catch (ConversionException e)

                 {

                     throw new ConversionException('\'' + key + "' doesn't map to an array of " + cls, e);

                 }

             }

         }

         return array;

     }

     /**

      * Get a list of Boolean objects associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Boolean list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of booleans.

      */

     public List getBooleanList(String key)

     {

         return getBooleanList(key, new ArrayList());

     }

     /**

      * Get a list of Boolean objects associated with the given

      * configuration key. If the key doesn't map to an existing object,

      * the default value is returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of Booleans.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of booleans.

      */

     public List getBooleanList(String key, List defaultValue)

     {

          return getList(Boolean.class, key, defaultValue);

     }

     /**

      * Get an array of boolean primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated boolean array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of booleans.

      */

     public boolean[] getBooleanArray(String key)

     {

         return (boolean[]) getArray(Boolean.TYPE, key);

     }

     /**

      * Get an array of boolean primitives associated with the given

      * configuration key. If the key doesn't map to an existing object,

      * the default value is returned.

      *

      * @param key          The configuration key.

      * @param defaultValue The default value.

      * @return The associated boolean array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of booleans.

      */

     public boolean[] getBooleanArray(String key, boolean[] defaultValue)

     {

         return (boolean[]) getArray(Boolean.TYPE, key, defaultValue);

     }

     /**

      * Get a list of Byte objects associated with the given configuration key.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Byte list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of bytes.

      */

     public List getByteList(String key)

     {

         return getByteList(key, new ArrayList());

     }

     /**

      * Get a list of Byte objects associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of Bytes.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of bytes.

      */

     public List getByteList(String key, List defaultValue)

     {

         return getList(Byte.class, key, defaultValue);

     }

     /**

      * Get an array of byte primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated byte array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of bytes.

      */

     public byte[] getByteArray(String key)

     {

         return getByteArray(key, new byte[0]);

     }

     /**

      * Get an array of byte primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated byte array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of bytes.

      */

     public byte[] getByteArray(String key, byte[] defaultValue)

     {

         return (byte[]) getArray(Byte.TYPE, key, defaultValue);

     }

     /**

      * Get a list of Short objects associated with the given configuration key.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Short list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of shorts.

      */

     public List getShortList(String key)

     {

         return getShortList(key, new ArrayList());

     }

     /**

      * Get a list of Short objects associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of Shorts.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of shorts.

      */

     public List getShortList(String key, List defaultValue)

     {

         return getList(Short.class, key, defaultValue);

     }

     /**

      * Get an array of short primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated short array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of shorts.

      */

     public short[] getShortArray(String key)

     {

         return getShortArray(key, new short[0]);

     }

     /**

      * Get an array of short primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated short array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of shorts.

      */

     public short[] getShortArray(String key, short[] defaultValue)

     {

         return (short[]) getArray(Short.TYPE, key, defaultValue);

     }

     /**

      * Get a list of Integer objects associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Integer list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of integers.

      */

     public List getIntegerList(String key)

     {

         return getIntegerList(key, new ArrayList());

     }

     /**

      * Get a list of Integer objects associated with the given

      * configuration key. If the key doesn't map to an existing object,

      * the default value is returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of Integers.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of integers.

      */

     public List getIntegerList(String key, List defaultValue)

     {

         return getList(Integer.class, key, defaultValue);

     }

     /**

      * Get an array of int primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated int array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of integers.

      */

     public int[] getIntArray(String key)

     {

         return getIntArray(key, new int[0]);

     }

     /**

      * Get an array of int primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated int array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of integers.

      */

     public int[] getIntArray(String key, int[] defaultValue)

     {

         return (int[]) getArray(Integer.TYPE, key, defaultValue);

     }

     /**

      * Get a list of Long objects associated with the given configuration key.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Long list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of longs.

      */

     public List getLongList(String key)

     {

         return getLongList(key, new ArrayList());

     }

     /**

      * Get a list of Long objects associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of Longs.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of longs.

      */

     public List getLongList(String key, List defaultValue)

     {

         return getList(Long.class, key, defaultValue);

     }

     /**

      * Get an array of long primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated long array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of longs.

      */

     public long[] getLongArray(String key)

     {

         return getLongArray(key, new long[0]);

     }

     /**

      * Get an array of long primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated long array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of longs.

      */

     public long[] getLongArray(String key, long[] defaultValue)

     {

         return (long[]) getArray(Long.TYPE, key, defaultValue);

     }

     /**

      * Get a list of Float objects associated with the given configuration key.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Float list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of floats.

      */

     public List getFloatList(String key)

     {

         return getFloatList(key, new ArrayList());

     }

     /**

      * Get a list of Float objects associated with the given

      * configuration key. If the key doesn't map to an existing object,

      * the default value is returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of Floats.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of floats.

      */

     public List getFloatList(String key, List defaultValue)

     {

         return getList(Float.class, key, defaultValue);

     }

     /**

      * Get an array of float primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated float array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of floats.

      */

     public float[] getFloatArray(String key)

     {

         return getFloatArray(key, new float[0]);

     }

     /**

      * Get an array of float primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated float array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of floats.

      */

     public float[] getFloatArray(String key, float[] defaultValue)

     {

         return (float[]) getArray(Float.TYPE, key, defaultValue);

     }

     /**

      * Get a list of Double objects associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Double list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of doubles.

      */

     public List getDoubleList(String key)

     {

         return getDoubleList(key, new ArrayList());

     }

     /**

      * Get a list of Double objects associated with the given

      * configuration key. If the key doesn't map to an existing object,

      * the default value is returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of Doubles.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of doubles.

      */

     public List getDoubleList(String key, List defaultValue)

     {

         return getList(Double.class, key, defaultValue);

     }

     /**

      * Get an array of double primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated double array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of doubles.

      */

     public double[] getDoubleArray(String key)

     {

         return getDoubleArray(key, new double[0]);

     }

     /**

      * Get an array of double primitives associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated double array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of doubles.

      */

     public double[] getDoubleArray(String key, double[] defaultValue)

     {

         return (double[]) getArray(Double.TYPE, key, defaultValue);

     }

     /**

      * Get a list of BigIntegers associated with the given configuration key.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated BigInteger list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigIntegers.

      */

     public List getBigIntegerList(String key)

     {

         return getBigIntegerList(key, new ArrayList());

     }

     /**

      * Get a list of BigIntegers associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of BigIntegers.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigIntegers.

      */

     public List getBigIntegerList(String key, List defaultValue)

     {

         return getList(BigInteger.class, key, defaultValue);

     }

     /**

      * Get an array of BigIntegers associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated BigInteger array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigIntegers.

      */

     public BigInteger[] getBigIntegerArray(String key)

     {

         return getBigIntegerArray(key, new BigInteger[0]);

     }

     /**

      * Get an array of BigIntegers associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated BigInteger array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigIntegers.

      */

     public BigInteger[] getBigIntegerArray(String key, BigInteger[] defaultValue)

     {

         return (BigInteger[]) getArray(BigInteger.class, key, defaultValue);

     }

     /**

      * Get a list of BigDecimals associated with the given configuration key.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated BigDecimal list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigDecimals.

      */

     public List getBigDecimalList(String key)

     {

         return getBigDecimalList(key, new ArrayList());

     }

     /**

      * Get a list of BigDecimals associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of BigDecimals.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigDecimals.

      */

     public List getBigDecimalList(String key, List defaultValue)

     {

         return getList(BigDecimal.class, key, defaultValue);

     }

     /**

      * Get an array of BigDecimals associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated BigDecimal array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigDecimals.

      */

     public BigDecimal[] getBigDecimalArray(String key)

     {

         return getBigDecimalArray(key, new BigDecimal[0]);

     }

     /**

      * Get an array of BigDecimals associated with the given

      * configuration key. If the key doesn't map to an existing object

      * an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated BigDecimal array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of BigDecimals.

      */

     public BigDecimal[] getBigDecimalArray(String key, BigDecimal[] defaultValue)

     {

         return (BigDecimal[]) getArray(BigDecimal.class, key, defaultValue);

     }

     /**

      * Get an URL associated with the given configuration key.

      *

      * @param key The configuration key.

      * @return The associated URL.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not an URL.

      */

     public URL getURL(String key)

     {

         return (URL) get(URL.class, key);

     }

     /**

      * Get an URL associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value

      * is returned.

      *

      * @param key          The configuration key.

      * @param defaultValue The default value.

      * @return The associated URL.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not an URL.

      */

     public URL getURL(String key, URL defaultValue)

     {

         return (URL) get(URL.class, key, defaultValue);

     }

     /**

      * Get a list of URLs associated with the given configuration key.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated URL list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of URLs.

      */

     public List getURLList(String key)

     {

         return getURLList(key, new ArrayList());

     }

     /**

      * Get a list of URLs associated with the given configuration key.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param key The configuration key.

      * @param defaultValue The default value.

      * @return The associated List of URLs.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of URLs.

      */

     public List getURLList(String key, List defaultValue)

     {

         return getList(URL.class, key, defaultValue);

     }

     /**

      * Get an array of URLs associated with the given configuration key.

      * If the key doesn't map to an existing object an empty array is returned.

      *

      * @param key The configuration key.

      * @return The associated URL array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of URLs.

      */

     public URL[] getURLArray(String key)

     {

         return getURLArray(key, new URL[0]);

     }

     /**

      * Get an array of URLs associated with the given configuration key.

      * If the key doesn't map to an existing object an empty array is returned.

      *

      * @param key The configuration key.

      * @param defaultValue the default value, which will be returned if the property is not found

      * @return The associated URL array if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of URLs.

      */

     public URL[] getURLArray(String key, URL[] defaultValue)

     {

         return (URL[]) getArray(URL.class, key, defaultValue);

     }

     /**

      * Get a Date associated with the given configuration key. If the property

      * is a String, it will be parsed with the format defined by the user in

      * the {@link #DATE_FORMAT_KEY} property, or if it's not defined with the

      * {@link #DEFAULT_DATE_FORMAT} pattern.

      *

      * @param key The configuration key.

      * @return The associated Date.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a Date.

      */

     public Date getDate(String key)

     {

         return (Date) get(Date.class, key);

     }

     /**

      * Get a Date associated with the given configuration key. If the property

      * is a String, it will be parsed with the specified format pattern.

      *

      * @param key    The configuration key.

      * @param format The non-localized {@link java.text.DateFormat} pattern.

      * @return The associated Date

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a Date.

      */

     public Date getDate(String key, String format)

     {

         Date value = getDate(key, null, format);

         if (value != null)

         {

             return value;

         }

         else if (isThrowExceptionOnMissing())

         {

             throw new NoSuchElementException('\'' + key + "' doesn't map to an existing object");

         }

         else

         {

             return null;

         }

     }

     /**

      * Get a Date associated with the given configuration key. If the property

      * is a String, it will be parsed with the format defined by the user in

      * the {@link #DATE_FORMAT_KEY} property, or if it's not defined with the

      * {@link #DEFAULT_DATE_FORMAT} pattern. If the key doesn't map to an

      * existing object, the default value is returned.

      *

      * @param key          The configuration key.

      * @param defaultValue The default value.

      * @return The associated Date.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a Date.

      */

     public Date getDate(String key, Date defaultValue)

     {

         return getDate(key, defaultValue, getDefaultDateFormat());

     }

     /**

      * Get a Date associated with the given configuration key. If the property

      * is a String, it will be parsed with the specified format pattern.

      * If the key doesn't map to an existing object, the default value

      * is returned.

      *

      * @param key          The configuration key.

      * @param defaultValue The default value.

      * @param format       The non-localized {@link java.text.DateFormat} pattern.

      * @return The associated Date.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a Date.

      */

     public Date getDate(String key, Date defaultValue, String format)

     {

         Object value = resolveContainerStore(key);

         if (value == null)

         {

             return defaultValue;

         }

         else

         {

             try

             {

                 return PropertyConverter.toDate(interpolate(value), format);

             }

             catch (ConversionException e)

             {

                 throw new ConversionException('\'' + key + "' doesn't map to a Date", e);

             }

         }

     }

     /**

      * Get a list of Dates associated with the given configuration key.

      * If the property is a list of Strings, they will be parsed with the

      * format defined by the user in the {@link #DATE_FORMAT_KEY} property,

      * or if it's not defined with the {@link #DEFAULT_DATE_FORMAT} pattern.

      * If the key doesn't map to an existing object an empty list is returned.

      *

      * @param key The configuration key.

      * @return The associated Date list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of Dates.

      */

     public List getDateList(String key)

     {

         return getDateList(key, new ArrayList());

     }

     /**

      * Get a list of Dates associated with the given configuration key.

      * If the property is a list of Strings, they will be parsed with the

      * specified format pattern. If the key doesn't map to an existing object

      * an empty list is returned.

      *

      * @param key    The configuration key.

      * @param format The non-localized {@link java.text.DateFormat} pattern.

      * @return The associated Date list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of Dates.

      */

     public List getDateList(String key, String format)

     {

         return getDateList(key, new ArrayList(), format);

     }

     /**

      * Get a list of Dates associated with the given configuration key.

      * If the property is a list of Strings, they will be parsed with the

      * format defined by the user in the {@link #DATE_FORMAT_KEY} property,

      * or if it's not defined with the {@link #DEFAULT_DATE_FORMAT} pattern.

      * If the key doesn't map to an existing object, the default value is

      * returned.

      *

      * @param key          The configuration key.

      * @param defaultValue The default value.

      * @return The associated Date list if the key is found.

      *

      * @throws ConversionException is thrown if the key maps to an

      *         object that is not a list of Dates.

      */

     public List getDateList(String key, List defaultValue)

     {

         return getDateList(key, defaultValue, getDefaultDateFormat());

     }

     /**

      * Get a list of Dates associated with the given configuration key.

      * If the property is a list of Strings, they will be parsed with the

      * specified format pattern. If the key doesn't map to an existing object,

      * the default value is returned.

      *

      * @param key          The configuration key.

      * @param defaultValue The default value.

      * @param format       The non-localized {@link java.text.DateFormat} pattern.

      * @return The associated Date list if the key is found.

      *

      * @throws 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)

     {

         Object value = getProperty(key);

         List list;

         if (value == null || (value instanceof String && StringUtils.isEmpty((String) value)))

         {

             list = defaultValue;

         }

         else if (value.getClass().isArray())

         {