reactor.netty.http.client

Class HttpClientConfig

java.lang.Object

reactor.netty.transport.TransportConfig

reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

reactor.netty.http.client.HttpClientConfig

public final class HttpClientConfig
extends reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

Encapsulate all necessary configuration for HTTP client transport. The public API is read-only.

Author:

Stephane Maldini, Violeta Georgieva

Method Summary

Modifier and Type	Method and Description
String	baseUrl() Return the configured base URL to use for this request/response or null.
protected void	bindAddress(Supplier<? extends SocketAddress> bindAddressSupplier)
int	channelHash()
ChannelInitializer<Channel>	channelInitializer(reactor.netty.ConnectionObserver connectionObserver, SocketAddress remoteAddress, boolean onServer)
reactor.netty.channel.ChannelOperations.OnSetup	channelOperationsProvider()
protected Class<? extends Channel>	channelType(boolean isDomainSocket)
reactor.netty.resources.ConnectionProvider	connectionProvider()
ClientCookieDecoder	cookieDecoder() Deprecated. as of 1.1.0. This will be removed in 2.0.0 as Netty 5 supports only strict validation.
ClientCookieEncoder	cookieEncoder() Deprecated. as of 1.1.0. This will be removed in 2.0.0 as Netty 5 supports only strict validation.
HttpResponseDecoderSpec	decoder() Return the configured HTTP response decoder options or the default.
AddressResolverGroup<?>	defaultAddressResolverGroup() Provides a global AddressResolverGroup from HttpResources that is shared amongst all HTTP clients.
protected reactor.netty.ConnectionObserver	defaultConnectionObserver()
protected LoggingHandler	defaultLoggingHandler()
protected reactor.netty.resources.LoopResources	defaultLoopResources()
protected reactor.netty.channel.ChannelMetricsRecorder	defaultMetricsRecorder()
protected reactor.netty.ChannelPipelineConfigurer	defaultOnChannelInit()
BiPredicate<HttpClientRequest,HttpClientResponse>	followRedirectPredicate() Return the configured follow redirect predicate or null.
HttpHeaders	headers() Return a copy of the request headers.
Http2SettingsSpec	http2SettingsSpec() Return the HTTP/2 configuration.
Http3SettingsSpec	http3SettingsSpec() Return the HTTP/3 configuration.
boolean	isAcceptBrotli() Return whether Brotli compression is enabled.
boolean	isAcceptGzip() Return whether GZip compression is enabled.
boolean	isRetryDisabled() Return true if retry once is disabled, false otherwise.
boolean	isSecure() Returns true if that HttpClient secured via SSL transport.
protected void	loggingHandler(LoggingHandler loggingHandler)
HttpMethod	method() Return the configured request method.
protected void	metricsRecorder(Supplier<? extends reactor.netty.channel.ChannelMetricsRecorder> metricsRecorder)
HttpProtocol[]	protocols() Return the HTTP protocol to support.
protected void	proxyProvider(reactor.netty.transport.ProxyProvider proxyProvider)
protected void	proxyProviderSupplier(Supplier<reactor.netty.transport.ProxyProvider> proxyProviderSupplier)
BiConsumer<HttpHeaders,HttpClientRequest>	redirectRequestBiConsumer() Return the configured redirect request BiConsumer or null.
Consumer<HttpClientRequest>	redirectRequestConsumer() Return the configured redirect request consumer or null.
protected AddressResolverGroup<?>	resolverInternal()
Duration	responseTimeout() Return the configured response timeout or null.
reactor.netty.tcp.SslProvider	sslProvider() Returns the current SslProvider if that HttpClient secured via SSL transport or null.
String	uri() Return the configured request uri.
Function<String,String>	uriTagValue() Returns the configured function that receives the actual uri and returns the uri tag value that will be used for the metrics with Metrics.URI tag.
WebsocketClientSpec	websocketClientSpec() Return the configured websocket client configuration.

Methods inherited from class reactor.netty.transport.ClientTransportConfig

doOnConnect, doOnConnected, doOnDisconnected, eventLoopGroup, getNameResolverProvider, hasProxy, proxyProvider, proxyProviderSupplier, remoteAddress, resolver

Methods inherited from class reactor.netty.transport.TransportConfig

attributes, bindAddress, channelGroup, connectionFactory, connectionObserver, doOnChannelInit, isPreferNative, loggingHandler, loopResources, metricsRecorder, metricsRecorderInternal, options, updateMap

Methods inherited from class java.lang.Object

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

Method Detail

baseUrl

@Nullable
public String baseUrl()

Return the configured base URL to use for this request/response or null.

Returns:

the configured base URL to use for this request/response or null

channelHash

public int channelHash()

Overrides:

channelHash in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

channelOperationsProvider

public reactor.netty.channel.ChannelOperations.OnSetup channelOperationsProvider()

Overrides:

channelOperationsProvider in class reactor.netty.transport.TransportConfig

connectionProvider

public reactor.netty.resources.ConnectionProvider connectionProvider()

Overrides:

connectionProvider in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

cookieDecoder

@Deprecated
public ClientCookieDecoder cookieDecoder()

Deprecated. as of 1.1.0. This will be removed in 2.0.0 as Netty 5 supports only strict validation.

Return the configured ClientCookieDecoder or the default ClientCookieDecoder.STRICT.

Returns:

the configured ClientCookieDecoder or the default ClientCookieDecoder.STRICT

cookieEncoder

@Deprecated
public ClientCookieEncoder cookieEncoder()

Deprecated. as of 1.1.0. This will be removed in 2.0.0 as Netty 5 supports only strict validation.

Return the configured ClientCookieEncoder or the default ClientCookieEncoder.STRICT.

Returns:

the configured ClientCookieEncoder or the default ClientCookieEncoder.STRICT

decoder

public HttpResponseDecoderSpec decoder()

Return the configured HTTP response decoder options or the default.

Returns:

the configured HTTP request decoder options or the default

followRedirectPredicate

@Nullable
public BiPredicate<HttpClientRequest,HttpClientResponse> followRedirectPredicate()

Return the configured follow redirect predicate or null.

Returns:

the configured follow redirect predicate or null

headers

public HttpHeaders headers()

Return a copy of the request headers.

Returns:

a copy of the request headers

http2SettingsSpec

@Nullable
public Http2SettingsSpec http2SettingsSpec()

Return the HTTP/2 configuration.

Returns:

the HTTP/2 configuration

http3SettingsSpec

@Incubating
 @Nullable
public Http3SettingsSpec http3SettingsSpec()

Return the HTTP/3 configuration.

Returns:

the HTTP/3 configuration

Since:

1.2.0

isAcceptBrotli

public boolean isAcceptBrotli()

Return whether Brotli compression is enabled.

Returns:

whether Brotli compression is enabled

isAcceptGzip

public boolean isAcceptGzip()

Return whether GZip compression is enabled.

Returns:

whether GZip compression is enabled

isRetryDisabled

public boolean isRetryDisabled()

Return true if retry once is disabled, false otherwise.

Returns:

true if retry once is disabled, false otherwise

isSecure

public boolean isSecure()

Returns true if that HttpClient secured via SSL transport.

Returns:

true if that HttpClient secured via SSL transport

method

public HttpMethod method()

Return the configured request method.

Returns:

the configured request method

protocols

public HttpProtocol[] protocols()

Return the HTTP protocol to support. Default is HttpProtocol.HTTP11.

Returns:

the HTTP protocol to support

redirectRequestBiConsumer

@Nullable
public BiConsumer<HttpHeaders,HttpClientRequest> redirectRequestBiConsumer()

Return the configured redirect request BiConsumer or null.

Returns:

the configured redirect request BiConsumer or null

redirectRequestConsumer

@Nullable
public Consumer<HttpClientRequest> redirectRequestConsumer()

Return the configured redirect request consumer or null.

Returns:

the configured redirect request consumer or null

responseTimeout

@Nullable
public Duration responseTimeout()

Return the configured response timeout or null.

Returns:

the configured response timeout or null

sslProvider

@Nullable
public reactor.netty.tcp.SslProvider sslProvider()

Returns the current SslProvider if that HttpClient secured via SSL transport or null.

Returns:

the current SslProvider if that HttpClient secured via SSL transport or null

uri

public String uri()

Return the configured request uri.

Returns:

the configured request uri

uriTagValue

@Nullable
public Function<String,String> uriTagValue()

Returns the configured function that receives the actual uri and returns the uri tag value that will be used for the metrics with Metrics.URI tag.

Returns:

the configured function that receives the actual uri and returns the uri tag value that will be used for the metrics with Metrics.URI tag

websocketClientSpec

@Nullable
public WebsocketClientSpec websocketClientSpec()

Return the configured websocket client configuration.

Returns:

the configured websocket client configuration

channelInitializer

public ChannelInitializer<Channel> channelInitializer(reactor.netty.ConnectionObserver connectionObserver,
                                                      @Nullable
                                                      SocketAddress remoteAddress,
                                                      boolean onServer)

Overrides:

channelInitializer in class reactor.netty.transport.TransportConfig

defaultAddressResolverGroup

public AddressResolverGroup<?> defaultAddressResolverGroup()

Provides a global AddressResolverGroup from HttpResources that is shared amongst all HTTP clients. AddressResolverGroup uses the global LoopResources from HttpResources.

Specified by:

defaultAddressResolverGroup in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

Returns:

the global AddressResolverGroup

bindAddress

protected void bindAddress(Supplier<? extends SocketAddress> bindAddressSupplier)

Overrides:

bindAddress in class reactor.netty.transport.TransportConfig

channelType

protected Class<? extends Channel> channelType(boolean isDomainSocket)

Overrides:

channelType in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

defaultConnectionObserver

protected reactor.netty.ConnectionObserver defaultConnectionObserver()

Overrides:

defaultConnectionObserver in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

defaultLoggingHandler

protected LoggingHandler defaultLoggingHandler()

Specified by:

defaultLoggingHandler in class reactor.netty.transport.TransportConfig

defaultLoopResources

protected reactor.netty.resources.LoopResources defaultLoopResources()

Specified by:

defaultLoopResources in class reactor.netty.transport.TransportConfig

defaultMetricsRecorder

protected reactor.netty.channel.ChannelMetricsRecorder defaultMetricsRecorder()

Specified by:

defaultMetricsRecorder in class reactor.netty.transport.TransportConfig

defaultOnChannelInit

protected reactor.netty.ChannelPipelineConfigurer defaultOnChannelInit()

Overrides:

defaultOnChannelInit in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

loggingHandler

protected void loggingHandler(LoggingHandler loggingHandler)

Overrides:

loggingHandler in class reactor.netty.transport.TransportConfig

metricsRecorder

protected void metricsRecorder(@Nullable
                               Supplier<? extends reactor.netty.channel.ChannelMetricsRecorder> metricsRecorder)

Overrides:

metricsRecorder in class reactor.netty.transport.TransportConfig

proxyProvider

protected void proxyProvider(reactor.netty.transport.ProxyProvider proxyProvider)

Overrides:

proxyProvider in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

proxyProviderSupplier

protected void proxyProviderSupplier(Supplier<reactor.netty.transport.ProxyProvider> proxyProviderSupplier)

Overrides:

proxyProviderSupplier in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>

resolverInternal

protected AddressResolverGroup<?> resolverInternal()

Overrides:

resolverInternal in class reactor.netty.transport.ClientTransportConfig<HttpClientConfig>