com.mongodb.client

Interface MapReduceIterable<T>

Type Parameters:

T - The type of the result.

All Superinterfaces:

Iterable<T>, MongoIterable<T>

public interface MapReduceIterable<T>
extends MongoIterable<T>

Iterable for map reduce.

Since:

3.0

Method Summary

Modifier and Type	Method and Description
MapReduceIterable<T>	action(MapReduceAction action) Specify the Action to be used when writing to a collection.
MapReduceIterable<T>	batchSize(int batchSize) Sets the number of documents to return per batch.
MapReduceIterable<T>	collectionName(String collectionName) Sets the collectionName for the output of the MapReduce
MapReduceIterable<T>	databaseName(String databaseName) Sets the name of the database to output into.
MapReduceIterable<T>	filter(Object filter) Sets the query filter to apply to the query.
MapReduceIterable<T>	finalizeFunction(String finalizeFunction) Sets the JavaScript function that follows the reduce method and modifies the output.
MapReduceIterable<T>	jsMode(boolean jsMode) Sets the flag that specifies whether to convert intermediate data into BSON format between the execution of the map and reduce functions.
MapReduceIterable<T>	limit(int limit) Sets the limit to apply.
MapReduceIterable<T>	maxTime(long maxTime, TimeUnit timeUnit) Sets the maximum execution time on the server for this operation.
MapReduceIterable<T>	nonAtomic(boolean nonAtomic) Sets if the post-processing step will prevent MongoDB from locking the database.
MapReduceIterable<T>	scope(Object scope) Sets the global variables that are accessible in the map, reduce and finalize functions.
MapReduceIterable<T>	sharded(boolean sharded) Sets if the output database is sharded
MapReduceIterable<T>	sort(Object sort) Sets the sort criteria to apply to the query.
MapReduceIterable<T>	verbose(boolean verbose) Sets whether to include the timing information in the result information.

Methods inherited from interface com.mongodb.client.MongoIterable

first, forEach, into, iterator, map

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Detail

collectionName

MapReduceIterable<T> collectionName(String collectionName)

Sets the collectionName for the output of the MapReduce

The default action is replace the collection if it exists, to change this use action(com.mongodb.client.model.MapReduceAction).

Parameters:

collectionName - the name of the collection that you want the map-reduce operation to write its output.

Returns:

this

finalizeFunction

MapReduceIterable<T> finalizeFunction(String finalizeFunction)

Sets the JavaScript function that follows the reduce method and modifies the output.

Parameters:

finalizeFunction - the JavaScript function that follows the reduce method and modifies the output.

Returns:

this

MongoDB documentation

Requirements for the finalize Function

scope

MapReduceIterable<T> scope(Object scope)

Sets the global variables that are accessible in the map, reduce and finalize functions.

Parameters:

scope - the global variables that are accessible in the map, reduce and finalize functions.

Returns:

this

MongoDB documentation

mapReduce

sort

MapReduceIterable<T> sort(Object sort)

Sets the sort criteria to apply to the query.

Parameters:

sort - the sort criteria, which may be null.

Returns:

this

MongoDB documentation

Sort

filter

MapReduceIterable<T> filter(Object filter)

Sets the query filter to apply to the query.

Parameters:

filter - the filter to apply to the query.

Returns:

this

MongoDB documentation

Filter

limit

MapReduceIterable<T> limit(int limit)

Sets the limit to apply.

Parameters:

limit - the limit, which may be null

Returns:

this

MongoDB documentation

Limit

jsMode

MapReduceIterable<T> jsMode(boolean jsMode)

Sets the flag that specifies whether to convert intermediate data into BSON format between the execution of the map and reduce functions. Defaults to false.

Parameters:

jsMode - the flag that specifies whether to convert intermediate data into BSON format between the execution of the map and reduce functions

Returns:

jsMode

MongoDB documentation

mapReduce

verbose

MapReduceIterable<T> verbose(boolean verbose)

Sets whether to include the timing information in the result information.

Parameters:

verbose - whether to include the timing information in the result information.

Returns:

this

maxTime

MapReduceIterable<T> maxTime(long maxTime,
                             TimeUnit timeUnit)

Sets the maximum execution time on the server for this operation.

Parameters:

maxTime - the max time

timeUnit - the time unit, which may not be null

Returns:

this

MongoDB documentation

Max Time

action

MapReduceIterable<T> action(MapReduceAction action)

Specify the Action to be used when writing to a collection.

Parameters:

action - an MapReduceAction to perform on the collection

Returns:

this

databaseName

MapReduceIterable<T> databaseName(String databaseName)

Sets the name of the database to output into.

Parameters:

databaseName - the name of the database to output into.

Returns:

this

MongoDB documentation

output with an action

sharded

MapReduceIterable<T> sharded(boolean sharded)

Sets if the output database is sharded

Parameters:

sharded - if the output database is sharded

Returns:

this

MongoDB documentation

output with an action

nonAtomic

MapReduceIterable<T> nonAtomic(boolean nonAtomic)

Sets if the post-processing step will prevent MongoDB from locking the database. Valid only with the Action.MERGE or Action.REDUCE actions.

Parameters:

nonAtomic - if the post-processing step will prevent MongoDB from locking the database.

Returns:

this

MongoDB documentation

output with an action

batchSize

MapReduceIterable<T> batchSize(int batchSize)

Sets the number of documents to return per batch.

Specified by:

batchSize in interface MongoIterable<T>

Parameters:

batchSize - the batch size

Returns:

this

MongoDB documentation

Batch Size