svn commit: r1643917 - in /commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2: AbstractConfiguration.java ImmutableConfiguration.java

[oh...@apache.org]

Author: oheger
Date: Mon Dec  8 21:02:26 2014
New Revision: 1643917

URL: http://svn.apache.org/r1643917
Log:
[CONFIGURATION-200] Extended ImmutableConfiguration interface.

A new size() method was added. Currently, only a dummy implementation
exists.

Modified:
    commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java
    commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java

Modified: commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java
URL: http://svn.apache.org/viewvc/commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java?rev=1643917&r1=1643916&r2=1643917&view=diff
==============================================================================
--- commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java (original)
+++ commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/AbstractConfiguration.java Mon Dec  8 21:02:26 2014
@@ -1027,6 +1027,13 @@ public abstract class AbstractConfigurat
         }
     }
 
+    @Override
+    public int size()
+    {
+        // TODO implementation
+        return 0;
+    }
+
     /**
      * Actually checks whether this configuration contains data. This method is
      * called by {@code isEmpty()}. It has to be defined by concrete subclasses.

Modified: commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java
URL: http://svn.apache.org/viewvc/commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java?rev=1643917&r1=1643916&r2=1643917&view=diff
==============================================================================
--- commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java (original)
+++ commons/proper/configuration/trunk/src/main/java/org/apache/commons/configuration2/ImmutableConfiguration.java Mon Dec  8 21:02:26 2014
@@ -63,6 +63,17 @@ public interface ImmutableConfiguration
     boolean isEmpty();
 
     /**
+     * Returns the number of keys stored in this configuration. Note that a
+     * concrete implementation is not guaranteed to be efficient; for some
+     * implementations it may be expensive to determine the size. Especially, if
+     * you just want to check whether a configuration is empty, it is preferable
+     * to use the {@link #isEmpty()} method.
+     *
+     * @return the number of keys stored in this configuration
+     */
+    int size();
+
+    /**
      * Check if the configuration contains the specified key.
      *
      * @param key the key whose presence in this configuration is to be tested