Module methanol

Package com.github.mizosoft.methanol

Interface Methanol.Interceptor.Chain<T>

Type Parameters:

T - the response body type

Enclosing interface:

Methanol.Interceptor

public static interface Methanol.Interceptor.Chain<T>

An object that gives interceptors the ability to relay requests to sibling interceptors, till eventually being sent by the client's backend.

Method Summary

Modifier and Type	Method	Description
HttpResponse.BodyHandler<T>	bodyHandler()	Returns the BodyHandler this chain uses for handling the response.
HttpResponse<T>	forward(HttpRequest request)	Forwards the request to the next interceptor, or to the client's backend if called by the last interceptor.
CompletableFuture<HttpResponse<T>>	forwardAsync(HttpRequest request)	Forwards the request to the next interceptor, or asynchronously to the client's backend if called by the last interceptor.
Optional<HttpResponse.PushPromiseHandler<T>>	pushPromiseHandler()	Returns the PushPromiseHandler this chain uses for handling push promises.
default <U> Methanol.Interceptor.Chain<U>	with(HttpResponse.BodyHandler<U> bodyHandler, @Nullable HttpResponse.PushPromiseHandler<U> pushPromiseHandler)	Returns a new chain that uses given handlers, possibly targeting another response type.
default Methanol.Interceptor.Chain<T>	with(UnaryOperator<HttpResponse.BodyHandler<T>> bodyHandlerTransformer)	Returns a new chain after applying the given function to this chain's body handler.
default Methanol.Interceptor.Chain<T>	with(UnaryOperator<HttpResponse.BodyHandler<T>> bodyHandlerTransformer, UnaryOperator<HttpResponse.PushPromiseHandler<T>> pushPromiseHandlerTransformer)	Returns a new chain after applying the given functions to this chain's body and push promise handlers, and only to the latter if a push promise handler is present.
Methanol.Interceptor.Chain<T>	withBodyHandler(HttpResponse.BodyHandler<T> bodyHandler)	Returns a new chain that uses the given BodyHandler.
Methanol.Interceptor.Chain<T>	withPushPromiseHandler(@Nullable HttpResponse.PushPromiseHandler<T> pushPromiseHandler)	Returns a new chain that uses the given PushPromiseHandler.

Method Details

bodyHandler

HttpResponse.BodyHandler<T> bodyHandler()

Returns the BodyHandler this chain uses for handling the response.

pushPromiseHandler

Optional<HttpResponse.PushPromiseHandler<T>> pushPromiseHandler()

Returns the PushPromiseHandler this chain uses for handling push promises.

withBodyHandler

Methanol.Interceptor.Chain<T> withBodyHandler(HttpResponse.BodyHandler<T> bodyHandler)

Returns a new chain that uses the given BodyHandler.

withPushPromiseHandler

Methanol.Interceptor.Chain<T> withPushPromiseHandler(@Nullable HttpResponse.PushPromiseHandler<T> pushPromiseHandler)

Returns a new chain that uses the given PushPromiseHandler.

with

default <U> Methanol.Interceptor.Chain<U> with(HttpResponse.BodyHandler<U> bodyHandler,
 @Nullable HttpResponse.PushPromiseHandler<U> pushPromiseHandler)

Returns a new chain that uses given handlers, possibly targeting another response type.

with

default Methanol.Interceptor.Chain<T> with(UnaryOperator<HttpResponse.BodyHandler<T>> bodyHandlerTransformer)

Returns a new chain after applying the given function to this chain's body handler.

with

default Methanol.Interceptor.Chain<T> with(UnaryOperator<HttpResponse.BodyHandler<T>> bodyHandlerTransformer,
 UnaryOperator<HttpResponse.PushPromiseHandler<T>> pushPromiseHandlerTransformer)

Returns a new chain after applying the given functions to this chain's body and push promise handlers, and only to the latter if a push promise handler is present.

forward

HttpResponse<T> forward(HttpRequest request)
                 throws IOException,
InterruptedException

Forwards the request to the next interceptor, or to the client's backend if called by the last interceptor.

Throws:

IOException

InterruptedException

forwardAsync

CompletableFuture<HttpResponse<T>> forwardAsync(HttpRequest request)

Forwards the request to the next interceptor, or asynchronously to the client's backend if called by the last interceptor.