/*

  * 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.util.ArrayList;

 import java.util.Iterator;

 import java.util.List;

 import java.util.Map;

 /**

  * A Map based Configuration.

  *

  * @author Emmanuel Bourg

  * @version $Revision: 439648 $, $Date: 2006-09-02 22:42:10 +0200 (Sa, 02 Sep 2006) $

  * @since 1.1

  */

 public class MapConfiguration extends AbstractConfiguration implements Cloneable

 {

     /** The Map decorated by this configuration. */

     protected Map map;

     /**

      * Create a Configuration decorator around the specified Map. The map is

      * used to store the configuration properties, any change will also affect

      * the Map.

      *

      * @param map the map

      */

     public MapConfiguration(Map map)

     {

         this.map = map;

     }

     /**

      * Return the Map decorated by this configuration.

      *

      * @return the map this configuration is based onto

      */

     public Map getMap()

     {

         return map;

     }

     public Object getProperty(String key)

     {

         Object value = map.get(key);

         if ((value instanceof String) && (!isDelimiterParsingDisabled()))

         {

             List list = PropertyConverter.split((String) value, getListDelimiter());

             return list.size() > 1 ? list : value;

         }

         else

         {

             return value;

         }

     }

     protected void addPropertyDirect(String key, Object value)

     {

         Object previousValue = getProperty(key);

         if (previousValue == null)

         {

             map.put(key, value);

         }

         else if (previousValue instanceof List)

         {

             // the value is added to the existing list

             ((List) previousValue).add(value);

         }

         else

         {

             // the previous value is replaced by a list containing the previous value and the new value

             List list = new ArrayList();

             list.add(previousValue);

             list.add(value);

             map.put(key, list);

         }

     }

     public boolean isEmpty()

     {

         return map.isEmpty();

     }

     public boolean containsKey(String key)

     {

         return map.containsKey(key);

     }

     protected void clearPropertyDirect(String key)

     {

         map.remove(key);

     }

     public Iterator getKeys()

     {

         return map.keySet().iterator();

     }

     /**

      * Returns a copy of this object. The returned configuration will contain

      * the same properties as the original. Event listeners are not cloned.

      *

      * @return the copy

      * @since 1.3

      */

     public Object clone()

     {

         try

         {

             MapConfiguration copy = (MapConfiguration) super.clone();

             copy.clearConfigurationListeners();

             copy.map = (Map) ConfigurationUtils.clone(map);

             return copy;

         }

         catch (CloneNotSupportedException cex)

         {

             // cannot happen

             throw new ConfigurationRuntimeException(cex);

         }

     }

 }