io.servicetalk.http.api

Interface MultiAddressHttpClientFilterFactory<U>

Type Parameters:

U - the type of address before resolution (unresolved address).

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 MultiAddressHttpClientFilterFactory<U>

A factory for StreamingHttpClientFilter to filter clients for different unresolved addresses.

See Also:

StreamingHttpClientFilterFactory

Method Summary

Modifier and Type	Method and Description
default MultiAddressHttpClientFilterFactory<U>	append(MultiAddressHttpClientFilterFactory<U> before) Returns a composed function that first applies the before function to its input, and then applies this function to the result.
default StreamingHttpClientFilterFactory	asClientFilter(U address) Returns a StreamingHttpClientFilterFactory that adapts from a MultiAddressHttpClientFilterFactory.
StreamingHttpClientFilter	create(U address, FilterableStreamingHttpClient client) Create a StreamingHttpClientFilter for the passed address using the provided FilterableStreamingHttpClient.
static <U> MultiAddressHttpClientFilterFactory<U>	from(BiFunction<U,FilterableStreamingHttpClient,StreamingHttpClientFilter> function) Returns a function that adapts from the UnaryOperator<FilterableStreamingHttpClient> function type to the MultiAddressHttpClientFilterFactory.
static <U> MultiAddressHttpClientFilterFactory<U>	from(Function<FilterableStreamingHttpClient,StreamingHttpClientFilter> function) Returns a function that adapts from a Function<FilterableStreamingHttpClient, StreamingHttpClientFilter> to the StreamingHttpClientFilterFactory.

Method Detail

create

StreamingHttpClientFilter create(U address,
                                 FilterableStreamingHttpClient client)

Create a StreamingHttpClientFilter for the passed address using the provided FilterableStreamingHttpClient.

Parameters:

address - the UnresolvedAddress for the FilterableStreamingHttpClient

client - the FilterableStreamingHttpClient to filter

Returns:

the filtered FilterableStreamingHttpClient

append

default MultiAddressHttpClientFilterFactory<U> append(MultiAddressHttpClientFilterFactory<U> before)

Returns a composed function that first applies the before function to its input, and then applies this function to the result.

The order of execution of these filters are in order of append. If 3 filters are added as follows:

     filter1.append(filter2).append(filter3)
 

Making a request to a client wrapped by this filter chain the order of invocation of these filters will be:

     filter1 => filter2 => filter3 => client
 

Parameters:

before - the function to apply before this function is applied

Returns:

a composed function that first applies the before function and then applies this function

asClientFilter

default StreamingHttpClientFilterFactory asClientFilter(U address)

Returns a StreamingHttpClientFilterFactory that adapts from a MultiAddressHttpClientFilterFactory.

Parameters:

address - will be passed in all StreamingHttpClientFilterFactory applications

Returns:

a StreamingHttpClientFilterFactory function with a provided GroupKey

from

static <U> MultiAddressHttpClientFilterFactory<U> from(BiFunction<U,FilterableStreamingHttpClient,StreamingHttpClientFilter> function)

Returns a function that adapts from the UnaryOperator<FilterableStreamingHttpClient> function type to the MultiAddressHttpClientFilterFactory.

Type Parameters:

U - the type of address before resolution (unresolved address)

Parameters:

function - the function that is applied to the input GroupKey and FilterableStreamingHttpClient

Returns:

the resulting MultiAddressHttpClientFilterFactory

from

static <U> MultiAddressHttpClientFilterFactory<U> from(Function<FilterableStreamingHttpClient,StreamingHttpClientFilter> function)

Returns a function that adapts from a Function<FilterableStreamingHttpClient, StreamingHttpClientFilter> to the StreamingHttpClientFilterFactory.

Type Parameters:

U - the type of address before resolution (unresolved address)

Parameters:

function - the function that is applied to the original FilterableStreamingHttpClient

Returns:

A StreamingHttpClientFilterFactory that uses the passed filter Function.