com.mongodb.client

Interface MapReduceIterable<TResult>

Type Parameters:

TResult - The type of the result.

All Superinterfaces:

Iterable<TResult>, MongoIterable<TResult>

public interface MapReduceIterable<TResult>
extends MongoIterable<TResult>

Iterable for map reduce.

Since:

3.0

Method Summary

Methods

Modifier and Type	Method and Description
MapReduceIterable<TResult>	action(MapReduceAction action) Specify the MapReduceAction to be used when writing to a collection.
MapReduceIterable<TResult>	batchSize(int batchSize) Sets the number of documents to return per batch.
MapReduceIterable<TResult>	collectionName(String collectionName) Sets the collectionName for the output of the MapReduce
MapReduceIterable<TResult>	databaseName(String databaseName) Sets the name of the database to output into.
MapReduceIterable<TResult>	filter(Bson filter) Sets the query filter to apply to the query.
MapReduceIterable<TResult>	finalizeFunction(String finalizeFunction) Sets the JavaScript function that follows the reduce method and modifies the output.
MapReduceIterable<TResult>	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<TResult>	limit(int limit) Sets the limit to apply.
MapReduceIterable<TResult>	maxTime(long maxTime, TimeUnit timeUnit) Sets the maximum execution time on the server for this operation.
MapReduceIterable<TResult>	nonAtomic(boolean nonAtomic) Sets if the post-processing step will prevent MongoDB from locking the database.
MapReduceIterable<TResult>	scope(Bson scope) Sets the global variables that are accessible in the map, reduce and finalize functions.
MapReduceIterable<TResult>	sharded(boolean sharded) Sets if the output database is sharded
MapReduceIterable<TResult>	sort(Bson sort) Sets the sort criteria to apply to the query.
MapReduceIterable<TResult>	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

Method Detail

collectionName

MapReduceIterable<TResult> 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<TResult> 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<TResult> scope(Bson 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<TResult> sort(Bson 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<TResult> filter(Bson 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<TResult> limit(int limit)

Sets the limit to apply.

Parameters:

limit - the limit, which may be null

Returns:

this

MongoDB documentation

Limit

jsMode

MapReduceIterable<TResult> 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<TResult> 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<TResult> 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<TResult> action(MapReduceAction action)

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

Parameters:

action - an MapReduceAction to perform on the collection

Returns:

this

databaseName

MapReduceIterable<TResult> 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<TResult> 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<TResult> nonAtomic(boolean nonAtomic)

Sets if the post-processing step will prevent MongoDB from locking the database. Valid only with the MapReduceAction.MERGE or MapReduceAction.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<TResult> batchSize(int batchSize)

Sets the number of documents to return per batch.

Specified by:

batchSize in interface MongoIterable<TResult>

Parameters:

batchSize - the batch size

Returns:

this

MongoDB documentation

Batch Size