io.datakernel.async

Class Stages

java.lang.Object

io.datakernel.async.Stages

public final class Stages
extends Object

Method Summary

Modifier and Type	Method and Description
static Stage<Void>	all()
static Stage<Void>	all(Iterable<? extends Stage<?>> stages)
static Stage<Void>	all(Iterator<? extends Stage<?>> stages)
static Stage<Void>	all(List<? extends Stage<?>> stages)
static Stage<Void>	all(Stage<?>... stages)
static Stage<Void>	all(Stage<?> stage1)
static Stage<Void>	all(Stage<?> stage1, Stage<?> stage2) Optimized for 2 stages.
static Stage<Void>	all(Stream<? extends Stage<?>> stages)
static <T> Stage<T>	any()
static <T> Stage<T>	any(Iterable<? extends Stage<? extends T>> stages)
static <T> Stage<T>	any(Iterator<? extends Stage<? extends T>> stages)
static <T> Stage<T>	any(List<? extends Stage<? extends T>> stages)
static <T> Stage<T>	any(Stage<? extends T>... stages)
static <T> Stage<T>	any(Stage<? extends T> stage1)
static <T> Stage<T>	any(Stage<? extends T> stage1, Stage<? extends T> stage2) Optimized for 2 stages.
static <T> Stage<T>	any(Stream<? extends Stage<? extends T>> stages)
static <A,T,R> Stage<R>	collect(List<? extends Stage<? extends T>> stages, CollectListener<T,A,R> listener, IndexedCollector<T,A,R> collector) Allows you to do something on completion of every Stage.
static <A,T,R> Stage<R>	collect(List<? extends Stage<? extends T>> stages, Collector<T,A,R> collector)
static <A,T,R> Stage<R>	collect(List<? extends Stage<? extends T>> stages, IndexedCollector<T,A,R> collector) Accumulates results of Stages using IndexedCollector.
static <T,A,R> Stage<R>	collectSequence(Iterable<? extends AsyncCallable<? extends T>> stages, Collector<T,A,R> collector)
static <T,A,R> Stage<R>	collectSequence(Iterator<? extends AsyncCallable<? extends T>> stages, Collector<T,A,R> collector) Accumulate Stage results into one final using Collector sequentially
static <T,A,R> Stage<R>	collectSequence(Stream<AsyncCallable<? extends T>> stages, Collector<T,A,R> collector)
static <T> Stage<T>	first(Iterable<? extends AsyncCallable<? extends T>> stages, BiPredicate<? super T,? super Throwable> predicate)
static <T> Stage<T>	first(Iterator<? extends AsyncCallable<? extends T>> stages, BiPredicate<? super T,? super Throwable> predicate)
static <T> Stage<T>	first(Stream<? extends AsyncCallable<? extends T>> stages, BiPredicate<? super T,? super Throwable> predicate)
static <T> Stage<T>	firstSuccessful(AsyncCallable<? extends T>... stages) Predicate in this case picks first Stage that was completed normally
static <T> Stage<T>	firstSuccessful(Iterable<? extends AsyncCallable<? extends T>> stages) Predicate in this case picks first Stage that was completed normally
static <T> Stage<T>	firstSuccessful(Iterator<? extends AsyncCallable<? extends T>> stages) Predicate in this case picks first Stage that was completed normally
static <T> Stage<T>	firstSuccessful(Stream<AsyncCallable<? extends T>> stages)
static <T> Iterable<Stage<T>>	iterable(Iterable<? extends AsyncCallable<? extends T>> callables) Transforms Iterable over AsyncCallable to Iterable over Stages
static <T> Iterator<Stage<T>>	iterator(Iterator<? extends AsyncCallable<? extends T>> callables) Transforms Iterator over AsyncCallable to Iterator over Stages
static Stage<Void>	runSequence()
static Stage<Void>	runSequence(AsyncCallable<?>... stages)
static Stage<Void>	runSequence(AsyncCallable<?> stage)
static Stage<Void>	runSequence(AsyncCallable<?> stage1, AsyncCallable<?> stage2)
static Stage<Void>	runSequence(AsyncCallable<?> stage1, AsyncCallable<?> stage2, AsyncCallable<?> stage3)
static Stage<Void>	runSequence(Iterable<? extends AsyncCallable<?>> stages)
static Stage<Void>	runSequence(Iterator<? extends AsyncCallable<?>> stages) Calls every Stage from stages in sequence.
static Stage<Void>	runSequence(Stream<? extends AsyncCallable<?>> stages)
static <T> Stage<T[]>	toArray(Class<T> type)
static <T> Stage<T[]>	toArray(Class<T> type, List<? extends Stage<? extends T>> stages) Prepared version of reduce that reduces stages into Stage<Array>
static <T> Stage<T[]>	toArray(Class<T> type, Stage<? extends T>... stages)
static <T> Stage<T[]>	toArray(Class<T> type, Stage<? extends T> stage1)
static <T> Stage<T[]>	toArray(Class<T> type, Stage<? extends T> stage1, Stage<? extends T> stage2)
static <T> Stage<T[]>	toArray(Class<T> type, Stream<? extends Stage<? extends T>> stages)
static <T> Stage<List<T>>	toList()
static <T> Stage<List<T>>	toList(List<? extends Stage<? extends T>> stages) Prepared version of reduce that reduces stages into Stage<List>
static <T> Stage<List<T>>	toList(Stage<? extends T>... stages)
static <T> Stage<List<T>>	toList(Stage<? extends T> stage1)
static <T> Stage<List<T>>	toList(Stage<? extends T> stage1, Stage<? extends T> stage2)
static <T> Stage<List<T>>	toList(Stream<? extends Stage<? extends T>> stages)
static <T1> Stage<Tuple1<T1>>	toTuple(Stage<? extends T1> stage1)
static <T1,T2> Stage<Tuple2<T1,T2>>	toTuple(Stage<? extends T1> stage1, Stage<? extends T2> stage2)
static <T1,T2,T3> Stage<Tuple3<T1,T2,T3>>	toTuple(Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3)
static <T1,T2,T3,T4> Stage<Tuple4<T1,T2,T3,T4>>	toTuple(Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3, Stage<? extends T4> stage4)
static <T1,T2,T3,T4,T5> Stage<Tuple5<T1,T2,T3,T4,T5>>	toTuple(Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3, Stage<? extends T4> stage4, Stage<? extends T5> stage5)
static <T1,T2,T3,T4,T5,T6> Stage<Tuple6<T1,T2,T3,T4,T5,T6>>	toTuple(Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3, Stage<? extends T4> stage4, Stage<? extends T5> stage5, Stage<? extends T6> stage6)
static <T1,R> Stage<R>	toTuple(TupleConstructor1<T1,R> constructor, Stage<? extends T1> stage1)
static <T1,T2,R> Stage<R>	toTuple(TupleConstructor2<T1,T2,R> constructor, Stage<? extends T1> stage1, Stage<? extends T2> stage2)
static <T1,T2,T3,R> Stage<R>	toTuple(TupleConstructor3<T1,T2,T3,R> constructor, Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3)
static <T1,T2,T3,T4,R> Stage<R>	toTuple(TupleConstructor4<T1,T2,T3,T4,R> constructor, Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3, Stage<? extends T4> stage4)
static <T1,T2,T3,T4,T5,R> Stage<R>	toTuple(TupleConstructor5<T1,T2,T3,T4,T5,R> constructor, Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3, Stage<? extends T4> stage4, Stage<? extends T5> stage5)
static <T1,T2,T3,T4,T5,T6,R> Stage<R>	toTuple(TupleConstructor6<T1,T2,T3,T4,T5,T6,R> constructor, Stage<? extends T1> stage1, Stage<? extends T2> stage2, Stage<? extends T3> stage3, Stage<? extends T4> stage4, Stage<? extends T5> stage5, Stage<? extends T6> stage6)

Methods inherited from class java.lang.Object

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

Method Detail

all

public static Stage<Void> all()

See Also:

all(List)

all

public static Stage<Void> all(Stage<?> stage1)

See Also:

all(List)

all

public static Stage<Void> all(Stage<?> stage1,
                              Stage<?> stage2)

Optimized for 2 stages.

See Also:

all(List)

all

public static Stage<Void> all(Stage<?>... stages)

See Also:

all(List)

all

public static Stage<Void> all(Stream<? extends Stage<?>> stages)

See Also:

all(List)

all

public static Stage<Void> all(Iterable<? extends Stage<?>> stages)

See Also:

all(List)

all

public static Stage<Void> all(List<? extends Stage<?>> stages)

Returns:

Stage that completes when all stages are completed

all

public static Stage<Void> all(Iterator<? extends Stage<?>> stages)

Returns:

Stage that completes when all stages are completed

any

public static <T> Stage<T> any()

any

public static <T> Stage<T> any(Stage<? extends T> stage1)

See Also:

any(List)

any

public static <T> Stage<T> any(Stage<? extends T> stage1,
                               Stage<? extends T> stage2)

Optimized for 2 stages.

See Also:

any(List)

any

@SafeVarargs
public static <T> Stage<T> any(Stage<? extends T>... stages)

See Also:

any(List)

any

public static <T> Stage<T> any(Stream<? extends Stage<? extends T>> stages)

any

public static <T> Stage<T> any(Iterable<? extends Stage<? extends T>> stages)

any

public static <T> Stage<T> any(List<? extends Stage<? extends T>> stages)

Returns:

first completed stage this method returns one of the first completed stages, because it's async we can't really get FIRST completed stage.

any

public static <T> Stage<T> any(Iterator<? extends Stage<? extends T>> stages)

collect

public static <A,T,R> Stage<R> collect(List<? extends Stage<? extends T>> stages,
                                       Collector<T,A,R> collector)

collect

public static <A,T,R> Stage<R> collect(List<? extends Stage<? extends T>> stages,
                                       IndexedCollector<T,A,R> collector)

Accumulates results of Stages using IndexedCollector.

Type Parameters:

T - type of input value

A - type of accumulator

R - type of result

Parameters:

stages - collection of Stages

collector - reducer which is used for combining Stage results into one value

Returns:

Stage with accumulated result

See Also:

IndexedCollector

collect

public static <A,T,R> Stage<R> collect(List<? extends Stage<? extends T>> stages,
                                       CollectListener<T,A,R> listener,
                                       IndexedCollector<T,A,R> collector)

Allows you to do something on completion of every Stage.

Parameters:

listener - calls CollectListener.onCollectResult(Object) with every Stage result

See Also:

collect(List, IndexedCollector)

toList

public static <T> Stage<List<T>> toList()

toList

public static <T> Stage<List<T>> toList(Stage<? extends T> stage1)

See Also:

toList(Stage[])

toList

public static <T> Stage<List<T>> toList(Stage<? extends T> stage1,
                                        Stage<? extends T> stage2)

See Also:

toList(Stage[])

toList

@SafeVarargs
public static <T> Stage<List<T>> toList(Stage<? extends T>... stages)

See Also:

toList(Stage[])

toList

public static <T> Stage<List<T>> toList(Stream<? extends Stage<? extends T>> stages)

See Also:

toList(Stage[])

toList

public static <T> Stage<List<T>> toList(List<? extends Stage<? extends T>> stages)

Prepared version of reduce that reduces stages into Stage<List>

See Also:

collect(List, IndexedCollector)

toArray

public static <T> Stage<T[]> toArray(Class<T> type)

toArray

public static <T> Stage<T[]> toArray(Class<T> type,
                                     Stage<? extends T> stage1)

See Also:

toArray(Class, List)

toArray

public static <T> Stage<T[]> toArray(Class<T> type,
                                     Stage<? extends T> stage1,
                                     Stage<? extends T> stage2)

See Also:

toArray(Class, List)

toArray

@SafeVarargs
public static <T> Stage<T[]> toArray(Class<T> type,
                                                  Stage<? extends T>... stages)

See Also:

toArray(Class, List)

toArray

public static <T> Stage<T[]> toArray(Class<T> type,
                                     Stream<? extends Stage<? extends T>> stages)

See Also:

toArray(Class, List)

toArray

public static <T> Stage<T[]> toArray(Class<T> type,
                                     List<? extends Stage<? extends T>> stages)

Prepared version of reduce that reduces stages into Stage<Array>

See Also:

collect(List, IndexedCollector)

toTuple

public static <T1,R> Stage<R> toTuple(TupleConstructor1<T1,R> constructor,
                                      Stage<? extends T1> stage1)

toTuple

public static <T1,T2,R> Stage<R> toTuple(TupleConstructor2<T1,T2,R> constructor,
                                         Stage<? extends T1> stage1,
                                         Stage<? extends T2> stage2)

toTuple

public static <T1,T2,T3,R> Stage<R> toTuple(TupleConstructor3<T1,T2,T3,R> constructor,
                                            Stage<? extends T1> stage1,
                                            Stage<? extends T2> stage2,
                                            Stage<? extends T3> stage3)

toTuple

public static <T1,T2,T3,T4,R> Stage<R> toTuple(TupleConstructor4<T1,T2,T3,T4,R> constructor,
                                               Stage<? extends T1> stage1,
                                               Stage<? extends T2> stage2,
                                               Stage<? extends T3> stage3,
                                               Stage<? extends T4> stage4)

toTuple

public static <T1,T2,T3,T4,T5,R> Stage<R> toTuple(TupleConstructor5<T1,T2,T3,T4,T5,R> constructor,
                                                  Stage<? extends T1> stage1,
                                                  Stage<? extends T2> stage2,
                                                  Stage<? extends T3> stage3,
                                                  Stage<? extends T4> stage4,
                                                  Stage<? extends T5> stage5)

toTuple

public static <T1,T2,T3,T4,T5,T6,R> Stage<R> toTuple(TupleConstructor6<T1,T2,T3,T4,T5,T6,R> constructor,
                                                     Stage<? extends T1> stage1,
                                                     Stage<? extends T2> stage2,
                                                     Stage<? extends T3> stage3,
                                                     Stage<? extends T4> stage4,
                                                     Stage<? extends T5> stage5,
                                                     Stage<? extends T6> stage6)

toTuple

public static <T1> Stage<Tuple1<T1>> toTuple(Stage<? extends T1> stage1)

toTuple

public static <T1,T2> Stage<Tuple2<T1,T2>> toTuple(Stage<? extends T1> stage1,
                                                   Stage<? extends T2> stage2)

toTuple

public static <T1,T2,T3> Stage<Tuple3<T1,T2,T3>> toTuple(Stage<? extends T1> stage1,
                                                         Stage<? extends T2> stage2,
                                                         Stage<? extends T3> stage3)

toTuple

public static <T1,T2,T3,T4> Stage<Tuple4<T1,T2,T3,T4>> toTuple(Stage<? extends T1> stage1,
                                                               Stage<? extends T2> stage2,
                                                               Stage<? extends T3> stage3,
                                                               Stage<? extends T4> stage4)

toTuple

public static <T1,T2,T3,T4,T5> Stage<Tuple5<T1,T2,T3,T4,T5>> toTuple(Stage<? extends T1> stage1,
                                                                     Stage<? extends T2> stage2,
                                                                     Stage<? extends T3> stage3,
                                                                     Stage<? extends T4> stage4,
                                                                     Stage<? extends T5> stage5)

toTuple

public static <T1,T2,T3,T4,T5,T6> Stage<Tuple6<T1,T2,T3,T4,T5,T6>> toTuple(Stage<? extends T1> stage1,
                                                                           Stage<? extends T2> stage2,
                                                                           Stage<? extends T3> stage3,
                                                                           Stage<? extends T4> stage4,
                                                                           Stage<? extends T5> stage5,
                                                                           Stage<? extends T6> stage6)

runSequence

public static Stage<Void> runSequence()

See Also:

runSequence(Iterator)

runSequence

public static Stage<Void> runSequence(AsyncCallable<?> stage)

See Also:

runSequence(Iterator)

runSequence

public static Stage<Void> runSequence(AsyncCallable<?> stage1,
                                      AsyncCallable<?> stage2)

See Also:

runSequence(Iterator)

runSequence

public static Stage<Void> runSequence(AsyncCallable<?>... stages)

See Also:

runSequence(Iterator)

runSequence

public static Stage<Void> runSequence(AsyncCallable<?> stage1,
                                      AsyncCallable<?> stage2,
                                      AsyncCallable<?> stage3)

See Also:

runSequence(Iterator)

runSequence

public static Stage<Void> runSequence(Stream<? extends AsyncCallable<?>> stages)

runSequence

public static Stage<Void> runSequence(Iterable<? extends AsyncCallable<?>> stages)

See Also:

runSequence(Iterator)

runSequence

public static Stage<Void> runSequence(Iterator<? extends AsyncCallable<?>> stages)

Calls every Stage from stages in sequence.

Returns:

Stage that completes when all stages are completed

collectSequence

public static <T,A,R> Stage<R> collectSequence(Stream<AsyncCallable<? extends T>> stages,
                                               Collector<T,A,R> collector)

See Also:

collectSequence(Iterator, Collector)

collectSequence

public static <T,A,R> Stage<R> collectSequence(Iterable<? extends AsyncCallable<? extends T>> stages,
                                               Collector<T,A,R> collector)

See Also:

collectSequence(Iterator, Collector)

collectSequence

public static <T,A,R> Stage<R> collectSequence(Iterator<? extends AsyncCallable<? extends T>> stages,
                                               Collector<T,A,R> collector)

Accumulate Stage results into one final using Collector sequentially

Returns:

new Stage that completes when all stages are completed

See Also:

Collector

firstSuccessful

@SafeVarargs
public static <T> Stage<T> firstSuccessful(AsyncCallable<? extends T>... stages)

Predicate in this case picks first Stage that was completed normally

See Also:

first(Iterator, BiPredicate)

firstSuccessful

public static <T> Stage<T> firstSuccessful(Stream<AsyncCallable<? extends T>> stages)

firstSuccessful

public static <T> Stage<T> firstSuccessful(Iterable<? extends AsyncCallable<? extends T>> stages)

Predicate in this case picks first Stage that was completed normally

See Also:

first(Iterator, BiPredicate)

firstSuccessful

public static <T> Stage<T> firstSuccessful(Iterator<? extends AsyncCallable<? extends T>> stages)

Predicate in this case picks first Stage that was completed normally

See Also:

first(Iterator, BiPredicate)

first

public static <T> Stage<T> first(Stream<? extends AsyncCallable<? extends T>> stages,
                                 BiPredicate<? super T,? super Throwable> predicate)

first

public static <T> Stage<T> first(Iterable<? extends AsyncCallable<? extends T>> stages,
                                 BiPredicate<? super T,? super Throwable> predicate)

See Also:

first(Iterator, BiPredicate)

first

public static <T> Stage<T> first(Iterator<? extends AsyncCallable<? extends T>> stages,
                                 BiPredicate<? super T,? super Throwable> predicate)

Parameters:

predicate - for filtering results, consumes result of Stage

Returns:

first completed result of Stage that satisfies predicate

iterable

public static <T> Iterable<Stage<T>> iterable(Iterable<? extends AsyncCallable<? extends T>> callables)

Transforms Iterable over AsyncCallable to Iterable over Stages

iterator

public static <T> Iterator<Stage<T>> iterator(Iterator<? extends AsyncCallable<? extends T>> callables)

Transforms Iterator over AsyncCallable to Iterator over Stages

Parameters:

callables - Iterator over AsyncCallable

Returns:

new Iterator over Stage