svn commit: r1582625 - /cayenne/main/trunk/cayenne-server/src/main/java/org/apache/cayenne/access/translator/batch/BatchTranslator.java

[aa...@apache.org]

Author: aadamchik
Date: Fri Mar 28 06:39:44 2014
New Revision: 1582625

URL: http://svn.apache.org/r1582625
Log:
CAY-1923 Optimize BatchTranslator - use fixed size array of BatchParameterBinding

javadoc

Modified:
    cayenne/main/trunk/cayenne-server/src/main/java/org/apache/cayenne/access/translator/batch/BatchTranslator.java

Modified: cayenne/main/trunk/cayenne-server/src/main/java/org/apache/cayenne/access/translator/batch/BatchTranslator.java
URL: http://svn.apache.org/viewvc/cayenne/main/trunk/cayenne-server/src/main/java/org/apache/cayenne/access/translator/batch/BatchTranslator.java?rev=1582625&r1=1582624&r2=1582625&view=diff
==============================================================================
--- cayenne/main/trunk/cayenne-server/src/main/java/org/apache/cayenne/access/translator/batch/BatchTranslator.java (original)
+++ cayenne/main/trunk/cayenne-server/src/main/java/org/apache/cayenne/access/translator/batch/BatchTranslator.java Fri Mar 28 06:39:44 2014
@@ -34,16 +34,17 @@ public interface BatchTranslator {
     String getSql();
 
     /**
-     * Returns the widest possible array of bindings for this query. Each
-     * binding's position corresponds to a value position in
-     * {@link BatchQueryRow}.
+     * Returns the widest possible array of bindings for this query.
      */
     BatchParameterBinding[] getBindings();
 
     /**
      * Updates internal bindings to be used with a given row, returning updated
-     * bindings array. Note that usually the returned array is the same copy on
-     * every iteration, only with changed object state.
+     * bindings array. This method guarantees that the returned array contains
+     * the same bindings in the same order as in the array returned from
+     * {@link #getBindings()} (but in a state corresponding to the 'row'
+     * parameter). Usually the returned array is actually the same object reused
+     * for every iteration, only with changed object state.
      */
     BatchParameterBinding[] updateBindings(BatchQueryRow row);
 }