com.github.dm.jrt.function

Interface FunctionalRoutineBuilder

All Superinterfaces:

ConfigurableBuilder<FunctionalRoutineBuilder>

public interface FunctionalRoutineBuilder
extends ConfigurableBuilder<FunctionalRoutineBuilder>

Interface defining a builder of functional routines.

Created by davide-maestroni on 10/18/2015.

Method Summary

Methods

Modifier and Type	Method and Description
<OUT> FunctionalRoutine<Void,OUT>	from(CommandInvocation<OUT> invocation) Builds and returns a new functional routine generating outputs from the specified command invocation.
<OUT> FunctionalRoutine<Void,OUT>	from(Consumer<? super ResultChannel<OUT>> consumer) Builds and returns a new functional routine generating outputs from the specified consumer.
<OUT> FunctionalRoutine<Void,OUT>	from(Supplier<OUT> supplier) Builds and returns a new functional routine generating outputs from the specified supplier.
<DATA> FunctionalRoutine<DATA,DATA>	thenAsyncAccumulate(BiFunction<? super DATA,? super DATA,DATA> function) Concatenates a functional routine based on the specified accumulate function.
<DATA> FunctionalRoutine<DATA,DATA>	thenAsyncFilter(Predicate<? super DATA> predicate) Concatenates a functional routine based on the specified predicate. The output will be filtered according to the result returned by the predicate.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenAsyncMap(BiConsumer<? super IN,? super ResultChannel<OUT>> consumer) Concatenates a functional routine based on the specified consumer.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenAsyncMap(Function<? super IN,OUT> function) Concatenates a functional routine based on the specified function.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenAsyncMap(InvocationFactory<IN,OUT> factory) Concatenates a functional routine based on the specified factory.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenAsyncMap(Routine<IN,OUT> routine) Concatenates a functional routine based on the specified instance.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenAsyncReduce(BiConsumer<? super List<? extends IN>,? super ResultChannel<OUT>> consumer) Concatenates a functional routine based on the specified reducing consumer. The outputs will be reduced by applying the function, only when the routine invocation completes.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenAsyncReduce(Function<? super List<? extends IN>,OUT> function) Concatenates a functional routine based on the specified reducing function. The outputs will be reduced by applying the function, only when the routine invocation completes.
<DATA> FunctionalRoutine<DATA,DATA>	thenParallelFilter(Predicate<? super DATA> predicate) Concatenates a functional routine based on the specified predicate. The output will be filtered according to the result returned by the predicate.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenParallelMap(BiConsumer<? super IN,? super ResultChannel<OUT>> consumer) Concatenates a functional routine based on the specified consumer.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenParallelMap(Function<? super IN,OUT> function) Concatenates a functional routine based on the specified function.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenParallelMap(InvocationFactory<IN,OUT> factory) Concatenates a functional routine based on the specified factory.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenParallelMap(Routine<IN,OUT> routine) Concatenates a functional routine based on the specified instance.
<DATA> FunctionalRoutine<DATA,DATA>	thenSyncAccumulate(BiFunction<? super DATA,? super DATA,DATA> function) Concatenates a functional routine based on the specified accumulate function.
<DATA> FunctionalRoutine<DATA,DATA>	thenSyncFilter(Predicate<? super DATA> predicate) Concatenates a functional routine based on the specified predicate. The output will be filtered according to the result returned by the predicate.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenSyncMap(BiConsumer<? super IN,? super ResultChannel<OUT>> consumer) Concatenates a functional routine based on the specified consumer.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenSyncMap(Function<? super IN,OUT> function) Concatenates a functional routine based on the specified function.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenSyncMap(InvocationFactory<IN,OUT> factory) Concatenates a functional routine based on the specified factory.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenSyncMap(Routine<IN,OUT> routine) Concatenates a functional routine based on the specified instance.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenSyncReduce(BiConsumer<? super List<? extends IN>,? super ResultChannel<OUT>> consumer) Concatenates a functional routine based on the specified reducing consumer. The outputs will be reduced by applying the function, only when the routine invocation completes.
<IN,OUT> FunctionalRoutine<IN,OUT>	thenSyncReduce(Function<? super List<? extends IN>,OUT> function) Concatenates a functional routine based on the specified reducing function. The outputs will be reduced by applying the function, only when the routine invocation completes.

Methods inherited from interface com.github.dm.jrt.builder.ConfigurableBuilder

invocations

Method Detail

from

@NotNull
<OUT> FunctionalRoutine<Void,OUT> from(@NotNull
                                             CommandInvocation<OUT> invocation)

Builds and returns a new functional routine generating outputs from the specified command invocation.

Type Parameters:

OUT - the output data type.

Parameters:

invocation - the command invocation instance.

Returns:

the newly created routine instance.

from

@NotNull
<OUT> FunctionalRoutine<Void,OUT> from(@NotNull
                                             Consumer<? super ResultChannel<OUT>> consumer)

Builds and returns a new functional routine generating outputs from the specified consumer.

Type Parameters:

OUT - the output data type.

Parameters:

consumer - the consumer instance.

Returns:

the newly created routine instance.

from

@NotNull
<OUT> FunctionalRoutine<Void,OUT> from(@NotNull
                                             Supplier<OUT> supplier)

Builds and returns a new functional routine generating outputs from the specified supplier.

Type Parameters:

OUT - the output data type.

Parameters:

supplier - the supplier instance.

Returns:

the newly created routine instance.

thenAsyncAccumulate

@NotNull
<DATA> FunctionalRoutine<DATA,DATA> thenAsyncAccumulate(@NotNull
                                                              BiFunction<? super DATA,? super DATA,DATA> function)

Concatenates a functional routine based on the specified accumulate function.
The output will be accumulated as follows:

     

         acc = function.apply(acc, input);
     
 

The accumulated value will be passed as result only when the routine invocation completes.

Note that the created routine will be invoked in an asynchronous mode.

Type Parameters:

DATA - the data type.

Parameters:

function - the bi-function instance.

Returns:

the concatenated functional routine.

thenAsyncFilter

@NotNull
<DATA> FunctionalRoutine<DATA,DATA> thenAsyncFilter(@NotNull
                                                          Predicate<? super DATA> predicate)

Concatenates a functional routine based on the specified predicate.
The output will be filtered according to the result returned by the predicate.

Note that the created routine will be invoked in an asynchronous mode.

Type Parameters:

DATA - the data type.

Parameters:

predicate - the predicate instance.

Returns:

the concatenated functional routine.

thenAsyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenAsyncMap(@NotNull
                                                      BiConsumer<? super IN,? super ResultChannel<OUT>> consumer)

Concatenates a functional routine based on the specified consumer.

Note that the created routine will be invoked in an asynchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

consumer - the bi-consumer instance.

Returns:

the concatenated functional routine.

thenAsyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenAsyncMap(@NotNull
                                                      Function<? super IN,OUT> function)

Concatenates a functional routine based on the specified function.

Note that the created routine will be invoked in an asynchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

function - the function instance.

Returns:

the concatenated functional routine.

thenAsyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenAsyncMap(@NotNull
                                                      InvocationFactory<IN,OUT> factory)

Concatenates a functional routine based on the specified factory.

Note that the created routine will be invoked in an asynchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

factory - the invocation factory.

Returns:

the concatenated functional routine.

thenAsyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenAsyncMap(@NotNull
                                                      Routine<IN,OUT> routine)

Concatenates a functional routine based on the specified instance.

Note that the passed routine will be invoked in an asynchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

routine - the routine instance.

Returns:

the concatenated functional routine.

thenAsyncReduce

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenAsyncReduce(@NotNull
                                                         BiConsumer<? super List<? extends IN>,? super ResultChannel<OUT>> consumer)

Concatenates a functional routine based on the specified reducing consumer.
The outputs will be reduced by applying the function, only when the routine invocation completes.

Note that the created routine will be invoked in an asynchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

consumer - the bi-consumer instance.

Returns:

the concatenated functional routine.

thenAsyncReduce

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenAsyncReduce(@NotNull
                                                         Function<? super List<? extends IN>,OUT> function)

Concatenates a functional routine based on the specified reducing function.
The outputs will be reduced by applying the function, only when the routine invocation completes.

Note that the created routine will be invoked in an asynchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

function - the function instance.

Returns:

the concatenated functional routine.

thenParallelFilter

@NotNull
<DATA> FunctionalRoutine<DATA,DATA> thenParallelFilter(@NotNull
                                                             Predicate<? super DATA> predicate)

Concatenates a functional routine based on the specified predicate.
The output will be filtered according to the result returned by the predicate.

Note that the created routine will be invoked in a parallel mode.

Type Parameters:

DATA - the data type.

Parameters:

predicate - the predicate instance.

Returns:

the concatenated functional routine.

thenParallelMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenParallelMap(@NotNull
                                                         BiConsumer<? super IN,? super ResultChannel<OUT>> consumer)

Concatenates a functional routine based on the specified consumer.

Note that the created routine will be invoked in a parallel mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

consumer - the bi-consumer instance.

Returns:

the concatenated functional routine.

thenParallelMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenParallelMap(@NotNull
                                                         Function<? super IN,OUT> function)

Concatenates a functional routine based on the specified function.

Note that the created routine will be invoked in a parallel mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

function - the function instance.

Returns:

the concatenated functional routine.

thenParallelMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenParallelMap(@NotNull
                                                         InvocationFactory<IN,OUT> factory)

Concatenates a functional routine based on the specified factory.

Note that the created routine will be invoked in a parallel mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

factory - the invocation factory.

Returns:

the concatenated functional routine.

thenParallelMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenParallelMap(@NotNull
                                                         Routine<IN,OUT> routine)

Concatenates a functional routine based on the specified instance.

Note that the passed routine will be invoked in a parallel mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

routine - the routine instance.

Returns:

the concatenated functional routine.

thenSyncAccumulate

@NotNull
<DATA> FunctionalRoutine<DATA,DATA> thenSyncAccumulate(@NotNull
                                                             BiFunction<? super DATA,? super DATA,DATA> function)

Concatenates a functional routine based on the specified accumulate function.
The output will be accumulated as follows:

     

         acc = function.apply(acc, input);
     
 

The accumulated value will be passed as result only when the routine invocation completes.

Note that the created routine will be invoked in a synchronous mode.

Type Parameters:

DATA - the data type.

Parameters:

function - the bi-function instance.

Returns:

the concatenated functional routine.

thenSyncFilter

@NotNull
<DATA> FunctionalRoutine<DATA,DATA> thenSyncFilter(@NotNull
                                                         Predicate<? super DATA> predicate)

Concatenates a functional routine based on the specified predicate.
The output will be filtered according to the result returned by the predicate.

Note that the created routine will be invoked in a synchronous mode.

Type Parameters:

DATA - the data type.

Parameters:

predicate - the predicate instance.

Returns:

the concatenated functional routine.

thenSyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenSyncMap(@NotNull
                                                     BiConsumer<? super IN,? super ResultChannel<OUT>> consumer)

Concatenates a functional routine based on the specified consumer.

Note that the created routine will be invoked in a synchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

consumer - the bi-consumer instance.

Returns:

the concatenated functional routine.

thenSyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenSyncMap(@NotNull
                                                     Function<? super IN,OUT> function)

Concatenates a functional routine based on the specified function.

Note that the created routine will be invoked in a synchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

function - the function instance.

Returns:

the concatenated functional routine.

thenSyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenSyncMap(@NotNull
                                                     InvocationFactory<IN,OUT> factory)

Concatenates a functional routine based on the specified factory.

Note that the created routine will be invoked in a synchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

factory - the invocation factory.

Returns:

the concatenated functional routine.

thenSyncMap

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenSyncMap(@NotNull
                                                     Routine<IN,OUT> routine)

Concatenates a functional routine based on the specified instance.

Note that the passed routine will be invoked in a synchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

routine - the routine instance.

Returns:

the concatenated functional routine.

thenSyncReduce

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenSyncReduce(@NotNull
                                                        BiConsumer<? super List<? extends IN>,? super ResultChannel<OUT>> consumer)

Concatenates a functional routine based on the specified reducing consumer.
The outputs will be reduced by applying the function, only when the routine invocation completes.

Note that the created routine will be invoked in a synchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

consumer - the bi-consumer instance.

Returns:

the concatenated functional routine.

thenSyncReduce

@NotNull
<IN,OUT> FunctionalRoutine<IN,OUT> thenSyncReduce(@NotNull
                                                        Function<? super List<? extends IN>,OUT> function)

Concatenates a functional routine based on the specified reducing function.
The outputs will be reduced by applying the function, only when the routine invocation completes.

Note that the created routine will be invoked in a synchronous mode.

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

function - the function instance.

Returns:

the concatenated functional routine.