com.github.dm.jrt.android.core

Class Channels

java.lang.Object

com.github.dm.jrt.core.Channels

com.github.dm.jrt.android.core.Channels

Direct Known Subclasses:

Channels, Channels

public class Channels
extends Channels

Utility class for handling routine channels.

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Channels.ParcelableSelectable<DATA> Data class storing information about the origin of the data.

Nested classes/interfaces inherited from class com.github.dm.jrt.core.Channels

Channels.Selectable<DATA>

Method Summary

Methods

Modifier and Type	Method and Description
static <OUT> OutputChannel<? extends Channels.ParcelableSelectable<OUT>>	mergeParcelable(int startIndex, List<? extends OutputChannel<? extends OUT>> channels) Merges the specified channels into a selectable one.
static OutputChannel<? extends Channels.ParcelableSelectable<?>>	mergeParcelable(int startIndex, OutputChannel<?>... channels) Merges the specified channels into a selectable one.
static <OUT> OutputChannel<? extends Channels.ParcelableSelectable<OUT>>	mergeParcelable(List<? extends OutputChannel<? extends OUT>> channels) Merges the specified channels into a selectable one.
static OutputChannel<? extends Channels.ParcelableSelectable<?>>	mergeParcelable(OutputChannel<?>... channels) Merges the specified channels into a selectable one.
static <DATA,IN extends DATA> TransportChannel<IN>	selectParcelable(InputChannel<? super Channels.ParcelableSelectable<DATA>> channel, int index) Returns a new channel transforming the input data into selectable ones. Note that the returned channel must be closed in order to ensure the completion of the invocation lifecycle.
static <OUT> OutputChannel<? extends Channels.ParcelableSelectable<OUT>>	toSelectable(OutputChannel<? extends OUT> channel, int index) Returns a new channel making the specified one selectable. Each output will be passed along unchanged.

Methods inherited from class com.github.dm.jrt.core.Channels

combine, combine, combine, combine, combine, distribute, distribute, distributeAndFlush, distributeAndFlush, join, join, joinAndFlush, joinAndFlush, map, map, map, map, map, map, merge, merge, merge, merge, merge, select, select, toSelectable

Methods inherited from class java.lang.Object

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

Method Detail

mergeParcelable

@Nonnull
public static <OUT> OutputChannel<? extends Channels.ParcelableSelectable<OUT>> mergeParcelable(int startIndex,
                                                                                        @Nonnull
                                                                                        List<? extends OutputChannel<? extends OUT>> channels)

Merges the specified channels into a selectable one.

Note that the channels will be bound as a result of the call.

Type Parameters:

OUT - the output data type.

Parameters:

startIndex - the selectable start index.

channels - the list of channels.

Returns:

the selectable output channel.

Throws:

IllegalArgumentException - if the specified list is empty.

mergeParcelable

@Nonnull
public static OutputChannel<? extends Channels.ParcelableSelectable<?>> mergeParcelable(int startIndex,
                                                                                @Nonnull
                                                                                OutputChannel<?>... channels)

Merges the specified channels into a selectable one.

Note that the channels will be bound as a result of the call.

Parameters:

startIndex - the selectable start index.

channels - the array of channels.

Returns:

the selectable output channel.

Throws:

IllegalArgumentException - if the specified array is empty.

mergeParcelable

@Nonnull
public static <OUT> OutputChannel<? extends Channels.ParcelableSelectable<OUT>> mergeParcelable(@Nonnull
                                                                                        List<? extends OutputChannel<? extends OUT>> channels)

Merges the specified channels into a selectable one.

Note that the channels will be bound as a result of the call.

Type Parameters:

OUT - the output data type.

Parameters:

channels - the channels to merge.

Returns:

the selectable output channel.

Throws:

IllegalArgumentException - if the specified list is empty.

mergeParcelable

@Nonnull
public static OutputChannel<? extends Channels.ParcelableSelectable<?>> mergeParcelable(@Nonnull
                                                                                OutputChannel<?>... channels)

Merges the specified channels into a selectable one.

Note that the channels will be bound as a result of the call.

Parameters:

channels - the channels to merge.

Returns:

the selectable output channel.

Throws:

IllegalArgumentException - if the specified array is empty.

selectParcelable

@Nonnull
public static <DATA,IN extends DATA> TransportChannel<IN> selectParcelable(@Nullable
                                                                   InputChannel<? super Channels.ParcelableSelectable<DATA>> channel,
                                                                   int index)

Returns a new channel transforming the input data into selectable ones.
Note that the returned channel must be closed in order to ensure the completion of the invocation lifecycle.

Type Parameters:

DATA - the channel data type.

IN - the input data type.

Parameters:

channel - the selectable channel.

index - the channel index.

Returns:

the input channel.

toSelectable

@Nonnull
public static <OUT> OutputChannel<? extends Channels.ParcelableSelectable<OUT>> toSelectable(@Nullable
                                                                                     OutputChannel<? extends OUT> channel,
                                                                                     int index)

Returns a new channel making the specified one selectable.
Each output will be passed along unchanged.

Note that the channel will be bound as a result of the call.

Type Parameters:

OUT - the output data type.

Parameters:

channel - the channel to make selectable.

index - the channel index.

Returns:

the selectable output channel.