Package hu.akarnokd.asyncenum

Interface AsyncEnumerable<T>

Type Parameters:

T - the value type.

All Known Subinterfaces:

GroupedAsyncEnumerable<T,K>

All Known Implementing Classes:

AsyncRepeatWhen, AsyncRetryWhen

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface AsyncEnumerable<T>

Represents an possibly asynchronous, cold-deferred, source of zero or more items optionally followed by a Throwable.

Field Summary

Fields

Modifier and Type	Field	Description
static CompletionStage<Boolean>	CANCELLED
static CompletionStage<Boolean>	FALSE	Constant and already completed CompletionStage signalling false.
static CompletionStage<Boolean>	TRUE	Constant and already completed CompletionStage signalling true.

Method Summary

Modifier and Type	Method	Description
default T	blockingFirst()
default Optional<T>	blockingFirstOptional()
default Iterable<T>	blockingIterable()
default T	blockingLast()
default Optional<T>	blockingLastOptional()
default Stream<T>	blockingStream()
default AsyncEnumerable<T>	cache()
static AsyncEnumerable<Integer>	characters(CharSequence chars)
default <C> AsyncEnumerable<C>	collect(Supplier<C> collection, BiConsumer<C,T> collector)
default <A,R> AsyncEnumerable<R>	collect(Collector<T,A,R> collector)
default <R> AsyncEnumerable<R>	compose(Function<? super AsyncEnumerable<T>,? extends AsyncEnumerable<R>> composer)
static <T> AsyncEnumerable<T>	concatArray(AsyncEnumerable<T>... sources)
default <R> AsyncEnumerable<R>	concatMap(Function<? super T,? extends AsyncEnumerable<? extends R>> mapper)
default AsyncEnumerable<T>	concatWith(AsyncEnumerable<T> other)
static <T> AsyncEnumerable<T>	create(Consumer<AsyncEmitter<T>> emitter)
static <T> AsyncEnumerable<T>	defer(Supplier<? extends AsyncEnumerable<? extends T>> supplier)
default AsyncEnumerable<T>	distinct()
default <K> AsyncEnumerable<T>	distinct(Function<? super T,? extends K> keySelector)
default <K> AsyncEnumerable<T>	distinct(Function<? super T,? extends K> keySelector, Supplier<? extends Collection<? super K>> setSupplier)
default AsyncEnumerable<T>	distinctUntilChanged()
default <K> AsyncEnumerable<T>	distinctUntilChanged(Function<? super T,? extends K> keySelector)
default <K> AsyncEnumerable<T>	distinctUntilChanged(Function<? super T,? extends K> keySelector, BiPredicate<? super K,? super K> comparer)
default AsyncEnumerable<T>	doFinally(Runnable onFinally)
default AsyncEnumerable<T>	doOnCancel(Runnable onCancel)
default AsyncEnumerable<T>	doOnComplete(Runnable onComplete)
default AsyncEnumerable<T>	doOnError(Consumer<? super Throwable> onError)
default AsyncEnumerable<T>	doOnNext(Consumer<? super T> onNext)
static <T> AsyncEnumerable<T>	empty()
AsyncEnumerator<T>	enumerator()	Returns an AsyncEnumerator that can be iterated over to receive the next item, the end-of-sequence indicator or a Throwable.
static <T> AsyncEnumerable<T>	error(Throwable error)
default AsyncEnumerable<T>	filter(Predicate<? super T> predicate)
default AsyncEnumerable<T>	first()
default <R> AsyncEnumerable<R>	flatMap(Function<? super T,? extends AsyncEnumerable<? extends R>> mapper)
default CompletionStage<Boolean>	forEach(Consumer<? super T> consumer)
static <T> AsyncEnumerable<T>	fromArray(T... array)
static <T> AsyncEnumerable<T>	fromCallable(Callable<? extends T> callable)
static <T> AsyncEnumerable<T>	fromCompletionStage(CompletionStage<T> stage)
static <T> AsyncEnumerable<T>	fromFlowPublisher(Flow.Publisher<T> source)
static <T> AsyncEnumerable<T>	fromIterable(Iterable<T> iterable)
static <T> AsyncEnumerable<T>	fromStream(Stream<T> stream)
static <T> AsyncEnumerable<T>	generate(Consumer<SyncEmitter<T>> generator)
static <T,S> AsyncEnumerable<T>	generate(Supplier<S> state, BiFunction<S,SyncEmitter<T>,S> generator)
static <T,S> AsyncEnumerable<T>	generate(Supplier<S> state, BiFunction<S,SyncEmitter<T>,S> generator, Consumer<? super S> releaseState)
default <K> AsyncEnumerable<GroupedAsyncEnumerable<T,K>>	groupBy(Function<? super T,? extends K> keySelector)
default <K,V> AsyncEnumerable<GroupedAsyncEnumerable<V,K>>	groupBy(Function<? super T,? extends K> keySelector, Function<? super T,? extends V> valueSelector)
default AsyncEnumerable<T>	ignoreElements()
static AsyncEnumerable<Long>	interval(long initialDelay, long period, TimeUnit unit, ScheduledExecutorService executor)
static AsyncEnumerable<Long>	interval(long period, TimeUnit unit, ScheduledExecutorService executor)
static <T> AsyncEnumerable<T>	just(T item)
default AsyncEnumerable<T>	last()
default <R> AsyncEnumerable<R>	map(Function<? super T,? extends R> mapper)
default AsyncEnumerable<T>	max(Comparator<? super T> comparator)
static <T> AsyncEnumerable<T>	mergeArray(AsyncEnumerable<? extends T>... sources)
default AsyncEnumerable<T>	mergeWith(AsyncEnumerable<T> other)
default AsyncEnumerable<T>	min(Comparator<? super T> comparator)
static <T> AsyncEnumerable<T>	never()
default AsyncEnumerable<T>	observeOn(Executor executor)
default AsyncEnumerable<T>	onErrorResume(Function<? super Throwable,? extends AsyncEnumerable<? extends T>> resumeMapper)
default <R> AsyncEnumerable<R>	publish(Function<? super AsyncEnumerable<T>,? extends AsyncEnumerable<R>> handler)
static AsyncEnumerable<Integer>	range(int start, int count)
default AsyncEnumerable<T>	reduce(BiFunction<T,T,T> reducer)
default <R> AsyncEnumerable<R>	reduce(Supplier<R> initial, BiFunction<R,T,R> reducer)
default AsyncEnumerable<T>	repeat(long times)
default AsyncEnumerable<T>	repeat(long times, BooleanSupplier stop)
default AsyncEnumerable<T>	repeat(BooleanSupplier stop)
static <T> AsyncEnumerable<T>	repeatCallable(Callable<? extends T> callable)
static <T> AsyncEnumerable<T>	repeatItem(T item)
default AsyncEnumerable<T>	repeatWhen(Supplier<? extends CompletionStage<Boolean>> completer)
default <S> AsyncEnumerable<T>	repeatWhen(Supplier<S> stateSupplier, Function<? super S,? extends CompletionStage<Boolean>> completer)
default AsyncEnumerable<T>	retry(long times)
default AsyncEnumerable<T>	retry(long times, Predicate<? super Throwable> predicate)
default AsyncEnumerable<T>	retry(Predicate<? super Throwable> predicate)
default <S> AsyncEnumerable<T>	retryWhen(Function<? super Throwable,? extends CompletionStage<Boolean>> completer)
default <S> AsyncEnumerable<T>	retryWhen(Supplier<S> stateSupplier, BiFunction<? super S,? super Throwable,? extends CompletionStage<Boolean>> completer)
default AsyncEnumerable<T>	skip(long n)
default AsyncEnumerable<T>	skipLast(int n)
default AsyncEnumerable<T>	skipWhile(Predicate<? super T> predicate)
default AsyncEnumerable<T>	startWith(AsyncEnumerable<T> other)
default AsyncEnumerable<T>	subscribeOn(Executor executor)
default AsyncEnumerable<Integer>	sumInt(Function<? super T,? extends Number> selector)
default AsyncEnumerable<Long>	sumLong(Function<? super T,? extends Number> selector)
default AsyncEnumerable<T>	switchIfEmpty(AsyncEnumerable<T> fallback)
default AsyncEnumerable<T>	take(long n)
default AsyncEnumerable<T>	takeLast(int n)
default <U> AsyncEnumerable<T>	takeUntil(AsyncEnumerable<U> other)
default AsyncEnumerable<T>	takeUntil(Predicate<? super T> stopPredicate)
default AsyncEnumerable<T>	takeWhile(Predicate<? super T> predicate)
default AsyncEnumerable<T>	timeout(long timeout, TimeUnit unit, ScheduledExecutorService executor)
default AsyncEnumerable<T>	timeout(long timeout, TimeUnit unit, ScheduledExecutorService executor, AsyncEnumerable<T> fallback)
static AsyncEnumerable<Long>	timer(long time, TimeUnit unit, ScheduledExecutorService executor)
default <R> R	to(Function<? super AsyncEnumerable<T>,R> converter)
default Flow.Publisher<T>	toFlowPublisher()
default AsyncEnumerable<List<T>>	toList()
static <T,U> AsyncEnumerable<T>	using(Supplier<U> resource, Function<? super U,? extends AsyncEnumerable<T>> handler, Consumer<? super U> releaseResource)
static <T,R> AsyncEnumerable<R>	zipArray(Function<? super Object[],? extends R> zipper, AsyncEnumerable<? extends T>... sources)
default <U,R> AsyncEnumerable<R>	zipWith(AsyncEnumerable<U> other, BiFunction<? super T,? super U,? extends R> zipper)

Field Detail

TRUE

static final CompletionStage<Boolean> TRUE

Constant and already completed CompletionStage signalling true.

FALSE

static final CompletionStage<Boolean> FALSE

Constant and already completed CompletionStage signalling false.

CANCELLED

static final CompletionStage<Boolean> CANCELLED

Method Detail

enumerator

AsyncEnumerator<T> enumerator()

Returns an AsyncEnumerator that can be iterated over to receive the next item, the end-of-sequence indicator or a Throwable.

Returns:

the new AsyncEnumerator instance

range

static AsyncEnumerable<Integer> range(int start,
                                      int count)

empty

static <T> AsyncEnumerable<T> empty()

fromArray

@SafeVarargs
static <T> AsyncEnumerable<T> fromArray(T... array)

fromIterable

static <T> AsyncEnumerable<T> fromIterable(Iterable<T> iterable)

concatArray

@SafeVarargs
static <T> AsyncEnumerable<T> concatArray(AsyncEnumerable<T>... sources)

characters

static AsyncEnumerable<Integer> characters(CharSequence chars)

fromCompletionStage

static <T> AsyncEnumerable<T> fromCompletionStage(CompletionStage<T> stage)

timer

static AsyncEnumerable<Long> timer(long time,
                                   TimeUnit unit,
                                   ScheduledExecutorService executor)

just

static <T> AsyncEnumerable<T> just(T item)

fromFlowPublisher

static <T> AsyncEnumerable<T> fromFlowPublisher(Flow.Publisher<T> source)

never

static <T> AsyncEnumerable<T> never()

error

static <T> AsyncEnumerable<T> error(Throwable error)

defer

static <T> AsyncEnumerable<T> defer(Supplier<? extends AsyncEnumerable<? extends T>> supplier)

zipArray

@SafeVarargs
static <T,R> AsyncEnumerable<R> zipArray(Function<? super Object[],? extends R> zipper,
                                         AsyncEnumerable<? extends T>... sources)

mergeArray

@SafeVarargs
static <T> AsyncEnumerable<T> mergeArray(AsyncEnumerable<? extends T>... sources)

interval

static AsyncEnumerable<Long> interval(long period,
                                      TimeUnit unit,
                                      ScheduledExecutorService executor)

interval

static AsyncEnumerable<Long> interval(long initialDelay,
                                      long period,
                                      TimeUnit unit,
                                      ScheduledExecutorService executor)

fromCallable

static <T> AsyncEnumerable<T> fromCallable(Callable<? extends T> callable)

repeatItem

static <T> AsyncEnumerable<T> repeatItem(T item)

repeatCallable

static <T> AsyncEnumerable<T> repeatCallable(Callable<? extends T> callable)

fromStream

static <T> AsyncEnumerable<T> fromStream(Stream<T> stream)

generate

static <T> AsyncEnumerable<T> generate(Consumer<SyncEmitter<T>> generator)

generate

static <T,S> AsyncEnumerable<T> generate(Supplier<S> state,
                                         BiFunction<S,SyncEmitter<T>,S> generator)

generate

static <T,S> AsyncEnumerable<T> generate(Supplier<S> state,
                                         BiFunction<S,SyncEmitter<T>,S> generator,
                                         Consumer<? super S> releaseState)

using

static <T,U> AsyncEnumerable<T> using(Supplier<U> resource,
                                      Function<? super U,? extends AsyncEnumerable<T>> handler,
                                      Consumer<? super U> releaseResource)

create

static <T> AsyncEnumerable<T> create(Consumer<AsyncEmitter<T>> emitter)

flatMap

default <R> AsyncEnumerable<R> flatMap(Function<? super T,? extends AsyncEnumerable<? extends R>> mapper)

take

default AsyncEnumerable<T> take(long n)

skip

default AsyncEnumerable<T> skip(long n)

map

default <R> AsyncEnumerable<R> map(Function<? super T,? extends R> mapper)

filter

default AsyncEnumerable<T> filter(Predicate<? super T> predicate)

collect

default <C> AsyncEnumerable<C> collect(Supplier<C> collection,
                                       BiConsumer<C,T> collector)

sumLong

default AsyncEnumerable<Long> sumLong(Function<? super T,? extends Number> selector)

sumInt

default AsyncEnumerable<Integer> sumInt(Function<? super T,? extends Number> selector)

min

default AsyncEnumerable<T> min(Comparator<? super T> comparator)

max

default AsyncEnumerable<T> max(Comparator<? super T> comparator)

toList

default AsyncEnumerable<List<T>> toList()

subscribeOn

default AsyncEnumerable<T> subscribeOn(Executor executor)

observeOn

default AsyncEnumerable<T> observeOn(Executor executor)

takeUntil

default <U> AsyncEnumerable<T> takeUntil(AsyncEnumerable<U> other)

concatMap

default <R> AsyncEnumerable<R> concatMap(Function<? super T,? extends AsyncEnumerable<? extends R>> mapper)

toFlowPublisher

default Flow.Publisher<T> toFlowPublisher()

timeout

default AsyncEnumerable<T> timeout(long timeout,
                                   TimeUnit unit,
                                   ScheduledExecutorService executor)

timeout

default AsyncEnumerable<T> timeout(long timeout,
                                   TimeUnit unit,
                                   ScheduledExecutorService executor,
                                   AsyncEnumerable<T> fallback)

onErrorResume

default AsyncEnumerable<T> onErrorResume(Function<? super Throwable,? extends AsyncEnumerable<? extends T>> resumeMapper)

to

default <R> R to(Function<? super AsyncEnumerable<T>,R> converter)

compose

default <R> AsyncEnumerable<R> compose(Function<? super AsyncEnumerable<T>,? extends AsyncEnumerable<R>> composer)

concatWith

default AsyncEnumerable<T> concatWith(AsyncEnumerable<T> other)

startWith

default AsyncEnumerable<T> startWith(AsyncEnumerable<T> other)

zipWith

default <U,R> AsyncEnumerable<R> zipWith(AsyncEnumerable<U> other,
                                         BiFunction<? super T,? super U,? extends R> zipper)

mergeWith

default AsyncEnumerable<T> mergeWith(AsyncEnumerable<T> other)

doOnNext

default AsyncEnumerable<T> doOnNext(Consumer<? super T> onNext)

doOnError

default AsyncEnumerable<T> doOnError(Consumer<? super Throwable> onError)

doOnComplete

default AsyncEnumerable<T> doOnComplete(Runnable onComplete)

doFinally

default AsyncEnumerable<T> doFinally(Runnable onFinally)

ignoreElements

default AsyncEnumerable<T> ignoreElements()

doOnCancel

default AsyncEnumerable<T> doOnCancel(Runnable onCancel)

repeat

default AsyncEnumerable<T> repeat(long times)

repeat

default AsyncEnumerable<T> repeat(BooleanSupplier stop)

repeat

default AsyncEnumerable<T> repeat(long times,
                                  BooleanSupplier stop)

retry

default AsyncEnumerable<T> retry(long times)

retry

default AsyncEnumerable<T> retry(Predicate<? super Throwable> predicate)

retry

default AsyncEnumerable<T> retry(long times,
                                 Predicate<? super Throwable> predicate)

repeatWhen

default AsyncEnumerable<T> repeatWhen(Supplier<? extends CompletionStage<Boolean>> completer)

repeatWhen

default <S> AsyncEnumerable<T> repeatWhen(Supplier<S> stateSupplier,
                                          Function<? super S,? extends CompletionStage<Boolean>> completer)

retryWhen

default <S> AsyncEnumerable<T> retryWhen(Function<? super Throwable,? extends CompletionStage<Boolean>> completer)

retryWhen

default <S> AsyncEnumerable<T> retryWhen(Supplier<S> stateSupplier,
                                         BiFunction<? super S,? super Throwable,? extends CompletionStage<Boolean>> completer)

groupBy

default <K> AsyncEnumerable<GroupedAsyncEnumerable<T,K>> groupBy(Function<? super T,? extends K> keySelector)

groupBy

default <K,V> AsyncEnumerable<GroupedAsyncEnumerable<V,K>> groupBy(Function<? super T,? extends K> keySelector,
                                                                   Function<? super T,? extends V> valueSelector)

skipWhile

default AsyncEnumerable<T> skipWhile(Predicate<? super T> predicate)

takeWhile

default AsyncEnumerable<T> takeWhile(Predicate<? super T> predicate)

takeUntil

default AsyncEnumerable<T> takeUntil(Predicate<? super T> stopPredicate)

collect

default <A,R> AsyncEnumerable<R> collect(Collector<T,A,R> collector)

cache

default AsyncEnumerable<T> cache()

distinct

default AsyncEnumerable<T> distinct()

distinct

default <K> AsyncEnumerable<T> distinct(Function<? super T,? extends K> keySelector)

distinct

default <K> AsyncEnumerable<T> distinct(Function<? super T,? extends K> keySelector,
                                        Supplier<? extends Collection<? super K>> setSupplier)

distinctUntilChanged

default AsyncEnumerable<T> distinctUntilChanged()

distinctUntilChanged

default <K> AsyncEnumerable<T> distinctUntilChanged(Function<? super T,? extends K> keySelector)

distinctUntilChanged

default <K> AsyncEnumerable<T> distinctUntilChanged(Function<? super T,? extends K> keySelector,
                                                    BiPredicate<? super K,? super K> comparer)

reduce

default AsyncEnumerable<T> reduce(BiFunction<T,T,T> reducer)

reduce

default <R> AsyncEnumerable<R> reduce(Supplier<R> initial,
                                      BiFunction<R,T,R> reducer)

skipLast

default AsyncEnumerable<T> skipLast(int n)

takeLast

default AsyncEnumerable<T> takeLast(int n)

publish

default <R> AsyncEnumerable<R> publish(Function<? super AsyncEnumerable<T>,? extends AsyncEnumerable<R>> handler)

switchIfEmpty

default AsyncEnumerable<T> switchIfEmpty(AsyncEnumerable<T> fallback)

first

default AsyncEnumerable<T> first()

last

default AsyncEnumerable<T> last()

forEach

default CompletionStage<Boolean> forEach(Consumer<? super T> consumer)

blockingFirst

default T blockingFirst()

blockingLast

default T blockingLast()

blockingIterable

default Iterable<T> blockingIterable()

blockingStream

default Stream<T> blockingStream()

blockingFirstOptional

default Optional<T> blockingFirstOptional()

blockingLastOptional

default Optional<T> blockingLastOptional()