svn commit: r749108 - /commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/base/ConfigurationSource.java

[oh...@apache.org]

Author: oheger
Date: Sun Mar  1 21:09:52 2009
New Revision: 749108

URL: http://svn.apache.org/viewvc?rev=749108&view=rev
Log:
In setProperty() distinguish between a new single value and a collection of values.

Modified:
    commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/base/ConfigurationSource.java

Modified: commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/base/ConfigurationSource.java
URL: http://svn.apache.org/viewvc/commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/base/ConfigurationSource.java?rev=749108&r1=749107&r2=749108&view=diff
==============================================================================
--- commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/base/ConfigurationSource.java (original)
+++ commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/base/ConfigurationSource.java Sun Mar  1 21:09:52 2009
@@ -16,6 +16,7 @@
  */
 package org.apache.commons.configuration2.base;
 
+import java.util.Collection;
 import java.util.Iterator;
 
 import org.apache.commons.configuration2.expr.ExpressionEngine;
@@ -113,7 +114,7 @@
 
     /**
      * Sets the value of a property. The new value will replace any previously
-     * set values.
+     * set values. It is treated as a single value.
      *
      * @param key The key of the property to change
      * @param value The new value
@@ -121,6 +122,16 @@
     void setProperty(String key, Object value);
 
     /**
+     * Sets multiple values for a property. Any previously set values will be
+     * replaced. The new value of this property will be constructed from all
+     * values stored in the given collection.
+     *
+     * @param key the key of the property to change
+     * @param values a collection with the new values of this property
+     */
+    void setProperty(String key, Collection<?> values);
+
+    /**
      * Removes a property from the configuration.
      *
      * @param key the key to remove along with corresponding value.