org.gridgain.grid.util.lang

Interface GridReducer3<E1,E2,E3,R>

Type Parameters:

E1 - Type of the first free variable, i.e. the element the closure is called on.

E2 - Type of the second free variable, i.e. the element the closure is called on.

E3 - Type of the third free variable, i.e. the element the closure is called on.

R - Type of the closure's return value.

All Superinterfaces:

GridOutClosure<R>, Serializable

All Known Subinterfaces:

R3<E1,E2,E3,R>

All Known Implementing Classes:

GridReducer3X, RX3

public interface GridReducer3<E1,E2,E3,R>
extends GridOutClosure<R>

Defines generic for-all or reduce type of closure. Unlike for-each type of closure that returns optional value on each execution of the closure - the reducer returns a single value for one or more collected values.

Closures are a first-class functions that are defined with (or closed over) their free variables that are bound to the closure scope at execution. Since Java 6 doesn't provide a language construct for first-class function the closures are implemented as abstract classes.

Thread Safety

Note that this interface does not impose or assume any specific thread-safety by its implementations. Each implementation can elect what type of thread-safety it provides, if any.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	collect(E1 e1, E2 e2, E3 e3) Collects given values.

Methods inherited from interface org.gridgain.grid.lang.GridOutClosure

apply

Method Detail

collect

boolean collect(@Nullable
              E1 e1,
              @Nullable
              E2 e2,
              @Nullable
              E3 e3)

Collects given values. All values will be reduced by GridOutClosure.apply() method.

The nulls could be passed if the data being collected is indeed null. If execution failed this method will not be called.

Parameters:

e1 - First bound free variable, i.e. the element the closure is called on.

e2 - Second bound free variable, i.e. the element the closure is called on.

e3 - Third bound free variable, i.e. the element the closure is called on.

Returns:

true to continue collecting, false to instruct caller to stop collecting and call GridOutClosure.apply() method.