accumulo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1334105 - /accumulo/branches/1.4/src/core/src/main/java/org/apache/accumulo/core/iterators/
Date Fri, 04 May 2012 18:06:22 GMT
Author: billie
Date: Fri May  4 18:06:22 2012
New Revision: 1334105

ACCUMULO-574 expand seek javadoc


Modified: accumulo/branches/1.4/src/core/src/main/java/org/apache/accumulo/core/iterators/
--- accumulo/branches/1.4/src/core/src/main/java/org/apache/accumulo/core/iterators/
+++ accumulo/branches/1.4/src/core/src/main/java/org/apache/accumulo/core/iterators/
Fri May  4 18:06:22 2012
@@ -76,6 +76,12 @@ public interface SortedKeyValueIterator<
    * Seeks to the first key in the Range, restricting the resulting K,V pairs to those with
the specified columns. An iterator does not have to stop at the end
    * of the range. The whole range is provided so that iterators can make optimizations.
+   * Seek may be called multiple times with different parameters after {@link #init} is called.
+   * 
+   * Iterators that examine groups of adjacent key/value pairs (e.g. rows) to determine their
top key and value should be sure that they properly handle a seek
+   * to a key in the middle of such a group (e.g. the middle of a row). Even if the client
always seeks to a range containing an entire group (a,c), the tablet
+   * server could send back a batch of entries corresponding to (a,b], then reseek the iterator
to range (b,c) when the scan is continued.
+   * 
    * @param range
    *          <tt>Range</tt> of keys to iterate over.
    * @param columnFamilies

View raw message