AfflictionNetworks/depot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Some language about the proper usage of Sequence.

Browse Source
This commit is contained in:
Ray Greenwell
2010-02-25 23:17:06 +00:00
parent 0b51d1e62f
commit 42d99f90ca
1 changed files with 5 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/java/com/samskivert/depot/util/Sequence.java
+5
View File
@@ -31,6 +31,11 @@ import com.google.common.base.Function;
* Thus a caller is expected to either simply iterate over the elements once, or use {@link * Thus a caller is expected to either simply iterate over the elements once, or use {@link
* #toList} to convert the sequence to concrete list to avoid repeated application of the * #toList} to convert the sequence to concrete list to avoid repeated application of the
* conversion function on elements of the sequence. * conversion function on elements of the sequence.
*
* Repository authors <i>may</i> want to return this interface for transformed findAll queries
* in order to avoid creating a second large List to contain elements. However, that exposes
* this interface to callers. The other two options are: go ahead and call toList() and return
* that to callers, or enforce single-iteration and return the result of iterator().
*/ */
public interface Sequence<T> extends Iterable<T> public interface Sequence<T> extends Iterable<T>
{ {