svn commit: r632661 - /commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/expr/ExpressionEngine.java

[oh...@apache.org]

Author: oheger
Date: Sat Mar  1 13:15:14 2008
New Revision: 632661

URL: http://svn.apache.org/viewvc?rev=632661&view=rev
Log:
Added new attributeKey() method to ExpressionEngine interface

Modified:
    commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/expr/ExpressionEngine.java

Modified: commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/expr/ExpressionEngine.java
URL: http://svn.apache.org/viewvc/commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/expr/ExpressionEngine.java?rev=632661&r1=632660&r2=632661&view=diff
==============================================================================
--- commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/expr/ExpressionEngine.java (original)
+++ commons/proper/configuration/branches/configuration2_experimental/src/main/java/org/apache/commons/configuration2/expr/ExpressionEngine.java Sat Mar  1 13:15:14 2008
@@ -16,8 +16,6 @@
  */
 package org.apache.commons.configuration2.expr;
 
-import java.util.List;
-
 /**
  * <p>
  * Definition of an interface for evaluating keys for hierarchical
@@ -43,6 +41,7 @@
  *
  * @since 1.3
  * @author Oliver Heger
+ * @version $Id$
  */
 public interface ExpressionEngine
 {
@@ -79,6 +78,20 @@
      * @return this node's key
      */
     <T> String nodeKey(T node, String parentKey, NodeHandler<T> handler);
+
+    /**
+     * Returns the key of an attribute of the specified node. This method is
+     * analogous to <code>nodeKey()</code>, but deals with attributes.
+     *
+     * @param parentNode the parent node, to which the attribute belongs
+     * @param parentKey the key of the parent node (can be <b>null</b> for the
+     *        root node)
+     * @param attrName the name of the affected attribute
+     * @param handler the node handler
+     * @return the key for the specified attribute
+     */
+    <T> String attributeKey(T parentNode, String parentKey, String attrName,
+            NodeHandler<T> handler);
 
     /**
      * Returns information needed for an add operation. This method gets called