Package io.helidon.common.http

Interface Reader<R>

Type Parameters:

R - the requested type

All Superinterfaces:

java.util.function.BiFunction<Flow.Publisher<DataChunk>,java.lang.Class<? super R>,java.util.concurrent.CompletionStage<? extends R>>

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 Reader<R>
extends java.util.function.BiFunction<Flow.Publisher<DataChunk>,java.lang.Class<? super R>,java.util.concurrent.CompletionStage<? extends R>>

The Reader transforms a DataChunk publisher into a completion stage of the associated type.

Method Summary

Modifier and Type	Method and Description
default java.util.concurrent.CompletionStage<? extends R>	apply(Flow.Publisher<DataChunk> publisher) Transforms a publisher into a completion stage.
java.util.concurrent.CompletionStage<? extends R>	apply(Flow.Publisher<DataChunk> publisher, java.lang.Class<? super R> clazz) Transforms a publisher into a completion stage.
default <T extends R> java.util.concurrent.CompletionStage<? extends T>	applyAndCast(Flow.Publisher<DataChunk> publisher, java.lang.Class<T> type) Transforms a publisher into a completion stage.

Methods inherited from interface java.util.function.BiFunction

andThen

Method Detail

apply

java.util.concurrent.CompletionStage<? extends R> apply(Flow.Publisher<DataChunk> publisher,
                                                        java.lang.Class<? super R> clazz)

Transforms a publisher into a completion stage. If an exception is thrown, the resulting completion stage of Content.as(Class) method call ends exceptionally.

Specified by:

apply in interface java.util.function.BiFunction<Flow.Publisher<DataChunk>,java.lang.Class<? super R>,java.util.concurrent.CompletionStage<? extends R>>

Parameters:

publisher - the publisher to transform

clazz - the requested type to be returned as a completion stage. The purpose of this parameter is to know what the user of this Reader actually requested.

Returns:

the result as a completion stage

apply

default java.util.concurrent.CompletionStage<? extends R> apply(Flow.Publisher<DataChunk> publisher)

Transforms a publisher into a completion stage. If an exception is thrown, the resulting completion stage of Content.as(Class) method call ends exceptionally.

The default implementation calls apply(Flow.Publisher, Class) with Object as the class parameter.

Parameters:

publisher - the publisher to transform

Returns:

the result as a completion stage

applyAndCast

default <T extends R> java.util.concurrent.CompletionStage<? extends T> applyAndCast(Flow.Publisher<DataChunk> publisher,
                                                                                     java.lang.Class<T> type)

Transforms a publisher into a completion stage. If an exception is thrown, the resulting completion stage of Content.as(Class) method call ends exceptionally.

The default implementation calls apply(Flow.Publisher, Class) with Object as the class parameter.

Type Parameters:

T - the desired type to cast the guarantied R type to

Parameters:

publisher - the publisher to transform

type - the desired type to cast the guarantied R type to

Returns:

the result as a completion stage which might end exceptionally with ClassCastException if the R type wasn't possible to cast to T