reactor.netty.http.client

Interface HttpClientRequest

All Superinterfaces:

HttpClientInfos, HttpInfos

public interface HttpClientRequest
extends HttpClientInfos

An Http Reactive client metadata contract for outgoing requests. It inherits several accessor related to HTTP flow : headers, params, URI, method, websocket...

Author:

Stephane Maldini, Simon Baslé

Method Summary

Modifier and Type	Method and Description
HttpClientRequest	addCookie(Cookie cookie) Add an outbound cookie
HttpClientRequest	addHeader(CharSequence name, CharSequence value) Add an outbound http header, appending the value if the header is already set.
HttpClientRequest	header(CharSequence name, CharSequence value) Set an outbound header, replacing any pre-existing value.
HttpClientRequest	headers(HttpHeaders headers) Set outbound headers from the passed headers.
boolean	isFollowRedirect() Return true if redirected will be followed
HttpClientRequest	responseTimeout(java.time.Duration timeout) Specifies the response timeout duration in milliseconds.

Methods inherited from interface reactor.netty.http.client.HttpClientInfos

currentContext, redirectedFrom, requestHeaders, resourceUrl

Methods inherited from interface reactor.netty.http.HttpInfos

cookies, fullPath, isKeepAlive, isWebsocket, method, path, uri, version

Method Detail

addCookie

HttpClientRequest addCookie(Cookie cookie)

Add an outbound cookie

Returns:

this outbound

addHeader

HttpClientRequest addHeader(CharSequence name,
                            CharSequence value)

Add an outbound http header, appending the value if the header is already set.

Parameters:

name - header name

value - header value

Returns:

this outbound

header

HttpClientRequest header(CharSequence name,
                         CharSequence value)

Set an outbound header, replacing any pre-existing value.

Parameters:

name - headers key

value - header value

Returns:

this outbound

headers

HttpClientRequest headers(HttpHeaders headers)

Set outbound headers from the passed headers. It will however ignore HOST header key. Any pre-existing value for the passed headers will be replaced.

Parameters:

headers - a netty headers map

Returns:

this outbound

isFollowRedirect

boolean isFollowRedirect()

Return true if redirected will be followed

Returns:

true if redirected will be followed

responseTimeout

HttpClientRequest responseTimeout(java.time.Duration timeout)

Specifies the response timeout duration in milliseconds. This is time that takes to receive a response after sending a request. If the timeout is null, any previous setting will be removed and no response timeout will be applied. If the timeout is less than 1ms, then 1ms will be the response timeout. The response timeout setting on HttpClientRequest level overrides any response timeout setting on HttpClient level.

Parameters:

timeout - the response timeout duration

Returns:

this outbound

Since:

0.9.11