org.gridgain.grid.lang
Class GridClosure<E1,R>

java.lang.Object
  org.gridgain.grid.lang.GridMetadataAwareAdapter
      org.gridgain.grid.lang.GridLambdaAdapter
          org.gridgain.grid.lang.GridClosure<E1,R>

Type Parameters:

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

R - Type of the closure's return value.

All Implemented Interfaces:

Serializable, Cloneable, GridMetadataAware, GridPeerDeployAware, GridLambda

Direct Known Subclasses:

C1, GridClosureX, GridMapper

public abstract class GridClosure<E1,R>
extends GridLambdaAdapter

Defines generic for-each type of closure. Closure is a first-class function that is defined with (or closed over) its 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.

Type Alias

To provide for more terse code you can use a typedef C1 class or various factory methods in GridFunc class. Note, however, that since typedefs in Java rely on inheritance you should not use these type aliases in signatures.

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.

Wiki & Forum:

Wiki
Forum

See Also:

C1, GridFunc, Serialized Form

Constructor Summary

GridClosure()

Method Summary

<A> GridClosure<E1,A>	andThen(GridClosure<R,A> c) Gets closure that applies given closure over the result of this closure.
GridInClosure<E1>	andThen(GridInClosure<R> c) Gets closure that applies given closure over the result of this closure.
abstract R	apply(E1 e) Closure body.
<A> GridClosure<A,R>	compose(GridClosure<A,E1> c) Gets closure that applies this closure over the result of given closure.
<A1,A2> GridClosure2<A1,A2,R>	compose(GridClosure2<A1,A2,E1> c) Gets closure that applies this closure over the result of given closure.
<A1,A2,A3> GridClosure3<A1,A2,A3,R>	compose(GridClosure3<A1,A2,A3,E1> c) Gets closure that applies this closure over the result of given closure.
GridOutClosure<R>	compose(GridOutClosure<E1> c) Gets closure that applies this closure over the result of given closure.
GridOutClosure<R>	curry(E1 e) Curries this closure with given value.
<E2> GridClosure2<E1,E2,R>	uncurry2() Gets closure that ignores its second argument and returns the same value as this closure with just one first argument.
<E2,E3> GridClosure3<E1,E2,E3,R>	uncurry3() Gets closure that ignores its second and third argument and returns the same value as this closure with just one first argument.

Methods inherited from class org.gridgain.grid.lang.GridLambdaAdapter

classLoader, deployClass, peerDeployLike, withMeta

Methods inherited from class org.gridgain.grid.lang.GridMetadataAwareAdapter

addMeta, addMetaIfAbsent, addMetaIfAbsent, allMeta, clone, copyMeta, copyMeta, hasMeta, hasMeta, meta, putMetaIfAbsent, putMetaIfAbsent, readExternalMeta, removeMeta, removeMeta, replaceMeta, writeExternalMeta

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gridgain.grid.GridMetadataAware

addMeta, addMetaIfAbsent, addMetaIfAbsent, allMeta, copyMeta, copyMeta, hasMeta, hasMeta, meta, putMetaIfAbsent, putMetaIfAbsent, removeMeta, removeMeta, replaceMeta

Constructor Detail

GridClosure

public GridClosure()

Method Detail

apply

public abstract R apply(E1 e)

Closure body.

Parameters:

e - Bound free variable, i.e. the element the closure is called or closed on.

Returns:

Optional return value.

curry

public GridOutClosure<R> curry(E1 e)

Curries this closure with given value. When result closure is called it will be executed with given value.

Parameters:

e - Value to curry with.

Returns:

Curried or partially applied closure with given value.

uncurry2

public <E2> GridClosure2<E1,E2,R> uncurry2()

Gets closure that ignores its second argument and returns the same value as this closure with just one first argument.

Type Parameters:

E2 - Type of 2nd argument that is ignored.

Returns:

Closure that ignores its second argument and returns the same value as this closure with just one first argument.

uncurry3

public <E2,E3> GridClosure3<E1,E2,E3,R> uncurry3()

Gets closure that ignores its second and third argument and returns the same value as this closure with just one first argument.

Type Parameters:

E2 - Type of 2nd argument that is ignored.

E3 - Type of 3d argument that is ignored.

Returns:

Closure that ignores its second and third argument and returns the same value as this closure with just one first argument.

andThen

public <A> GridClosure<E1,A> andThen(GridClosure<R,A> c)

Gets closure that applies given closure over the result of this closure.

Type Parameters:

A - Return type of new closure.

Parameters:

c - Closure.

Returns:

New closure.

andThen

public GridInClosure<E1> andThen(GridInClosure<R> c)

Gets closure that applies given closure over the result of this closure.

Parameters:

c - Closure.

Returns:

New closure.

compose

public GridOutClosure<R> compose(GridOutClosure<E1> c)

Gets closure that applies this closure over the result of given closure.

Parameters:

c - Closure.

Returns:

New closure.

compose

public <A> GridClosure<A,R> compose(GridClosure<A,E1> c)

Gets closure that applies this closure over the result of given closure.

Type Parameters:

A - Argument type of new closure.

Parameters:

c - Closure.

Returns:

New closure.

compose

public <A1,A2> GridClosure2<A1,A2,R> compose(GridClosure2<A1,A2,E1> c)

Gets closure that applies this closure over the result of given closure.

Type Parameters:

A1 - First argument type of new closure.

A2 - Second argument type of new closure.

Parameters:

c - Closure.

Returns:

New closure.

compose

public <A1,A2,A3> GridClosure3<A1,A2,A3,R> compose(GridClosure3<A1,A2,A3,E1> c)

Gets closure that applies this closure over the result of given closure.

Type Parameters:

A1 - First argument type of new closure.

A2 - Second argument type of new closure.

A3 - Third argument type of new closure.

Parameters:

c - Closure.

Returns:

New closure.