com.mongodb.client

Interface MongoIterable<T>

Type Parameters:

T - The type that this iterable will decode documents to.

All Superinterfaces:

Iterable<T>

All Known Subinterfaces:

AggregateIterable<T>, DistinctIterable<T>, FindIterable<T>, ListCollectionsIterable<T>, ListDatabasesIterable<T>, ListIndexesIterable<T>, MapReduceIterable<T>

public interface MongoIterable<T>
extends Iterable<T>

The MongoIterable is the results from an operation, such as a query.

Since:

3.0

Method Summary

Modifier and Type	Method and Description
MongoIterable<T>	batchSize(int batchSize) Sets the number of documents to return per batch.
T	first() Helper to return the first item in the iterator or null.
void	forEach(Block<? super T> block) Iterates over all documents in the view, applying the given block to each.
<A extends Collection<? super T>> A	into(A target) Iterates over all the documents, adding each to the given target.
MongoCursor<T>	iterator()
<U> MongoIterable<U>	map(Function<T,U> mapper) Maps this iterable from the source document type to the target document type.

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

iterator

MongoCursor<T> iterator()

Specified by:

iterator in interface Iterable<T>

first

T first()

Helper to return the first item in the iterator or null.

Returns:

T the first item or null.

map

<U> MongoIterable<U> map(Function<T,U> mapper)

Maps this iterable from the source document type to the target document type.

Type Parameters:

U - the target document type

Parameters:

mapper - a function that maps from the source to the target document type

Returns:

an iterable which maps T to U

forEach

void forEach(Block<? super T> block)

Iterates over all documents in the view, applying the given block to each.

Similar to map but the function is fully encapsulated with no returned result.

Parameters:

block - the block to apply to each document of type T.

into

<A extends Collection<? super T>> A into(A target)

Iterates over all the documents, adding each to the given target.

Type Parameters:

A - the collection type

Parameters:

target - the collection to insert into

Returns:

the target

batchSize

MongoIterable<T> batchSize(int batchSize)

Sets the number of documents to return per batch.

Parameters:

batchSize - the batch size

Returns:

this

MongoDB documentation

Batch Size