Package com.linecorp.armeria.client

Class ClientRequestContextWrapper

java.lang.Object

com.linecorp.armeria.common.RequestContextWrapper<ClientRequestContext>

com.linecorp.armeria.client.ClientRequestContextWrapper

All Implemented Interfaces:

ClientRequestContext, RequestContext

public class ClientRequestContextWrapper
extends RequestContextWrapper<ClientRequestContext>
implements ClientRequestContext

Wraps an existing ClientRequestContext.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ClientRequestContextWrapper(ClientRequestContext delegate)	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
void	addAdditionalRequestHeader(CharSequence name, Object value)	Adds a header with the specified name and value.
HttpHeaders	additionalRequestHeaders()	Returns an HttpHeaders which will be included when a Client sends an HttpRequest.
void	clearResponseTimeout()	Clears the previously scheduled response timeout, if any.
Endpoint	endpoint()	Returns the remote Endpoint of the current Request.
EndpointGroup	endpointGroup()	Returns the EndpointGroup used for the current Request.
String	fragment()	Returns the fragment part of the URI of the current Request, as defined in the section 3.5 of RFC3986.
boolean	isTimedOut()	Returns whether this RequestContext has been timed-out (e.g., when the corresponding request passes a deadline).
long	maxResponseLength()	Returns the maximum length of the received Response.
void	mutateAdditionalRequestHeaders(Consumer<HttpHeadersBuilder> mutator)	Mutates the HttpHeaders which will be included when a Client sends an HttpRequest.
ClientRequestContext	newDerivedContext(RequestId id, HttpRequest req, RpcRequest rpcReq, Endpoint endpoint)	Creates a new ClientRequestContext whose properties and Attributes are copied from this ClientRequestContext, except having different Request, Endpoint and its own RequestLog.
ClientOptions	options()	Returns the ClientOptions of the current Request.
Runnable	responseTimeoutHandler()	Returns Response timeout handler which is executed when the Response is not completely received within the allowed ClientRequestContext.responseTimeoutMillis() or the default ClientOption.RESPONSE_TIMEOUT_MILLIS.
long	responseTimeoutMillis()	Returns the amount of time allowed until receiving the Response completely since the transfer of the Response started.
void	setAdditionalRequestHeader(CharSequence name, Object value)	Sets a header with the specified name and value.
void	setMaxResponseLength(long maxResponseLength)	Sets the maximum length of the received Response.
void	setResponseTimeoutAtMillis(long responseTimeoutAtMillis)	Deprecated.
void	setResponseTimeoutHandler(Runnable responseTimeoutHandler)	Sets a handler to run when the response times out.
void	setResponseTimeoutMillis(TimeoutMode mode, long responseTimeoutMillis)	Schedules the response timeout that is triggered when the Response is not fully received within the specified TimeoutMode and the specified responseTimeoutMillis since the Response started or Request was fully sent.
void	setWriteTimeout(Duration writeTimeout)	Returns the amount of time allowed until the initial write attempt of the current Request succeeds.
void	setWriteTimeoutMillis(long writeTimeoutMillis)	Returns the amount of time allowed until the initial write attempt of the current Request succeeds.
void	timeoutNow()	Triggers the current timeout immediately if a timeout was scheduled before.
long	writeTimeoutMillis()	Returns the amount of time allowed until the initial write attempt of the current Request succeeds.

Methods inherited from class com.linecorp.armeria.common.RequestContextWrapper

alloc, attr, attrs, computeAttrIfAbsent, decodedPath, delegate, eventLoop, id, localAddress, log, logBuilder, meterRegistry, method, ownAttr, ownAttrs, path, query, remoteAddress, request, root, rpcRequest, sessionProtocol, setAttr, setAttrIfAbsent, sslSession, toString, updateRequest, updateRpcRequest

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.linecorp.armeria.client.ClientRequestContext

extendResponseTimeout, extendResponseTimeoutMillis, newDerivedContext, push, request, rpcRequest, setResponseTimeout, setResponseTimeout, setResponseTimeoutAfter, setResponseTimeoutAfterMillis, setResponseTimeoutAt, setResponseTimeoutMillis

Methods inherited from interface com.linecorp.armeria.common.RequestContext

alloc, attr, attrs, computeAttrIfAbsent, contextAwareEventLoop, contextAwareExecutor, decodedPath, eventLoop, executor, id, localAddress, log, logBuilder, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, meterRegistry, method, ownAttr, ownAttrs, path, query, remoteAddress, replace, root, sessionProtocol, setAttr, setAttrIfAbsent, sslSession, updateRequest, updateRpcRequest

Constructor Details

ClientRequestContextWrapper

protected ClientRequestContextWrapper(ClientRequestContext delegate)

Creates a new instance.

Method Details

newDerivedContext

public ClientRequestContext newDerivedContext(RequestId id, @Nullable HttpRequest req, @Nullable RpcRequest rpcReq, @Nullable Endpoint endpoint)

Description copied from interface: ClientRequestContext

Creates a new ClientRequestContext whose properties and Attributes are copied from this ClientRequestContext, except having different Request, Endpoint and its own RequestLog.

Note that this method does not copy the RequestLog properties to the derived context.

Specified by:

newDerivedContext in interface ClientRequestContext

endpointGroup

public EndpointGroup endpointGroup()

Description copied from interface: ClientRequestContext

Returns the EndpointGroup used for the current Request.

Specified by:

endpointGroup in interface ClientRequestContext

Returns:

the EndpointGroup if a user specified an EndpointGroup when initiating a Request. null if a user specified an Endpoint.

endpoint

public Endpoint endpoint()

Description copied from interface: ClientRequestContext

Returns the remote Endpoint of the current Request.

Specified by:

endpoint in interface ClientRequestContext

Returns:

the remote Endpoint, or null if the Request has failed because its remote Endpoint couldn't be determined.

fragment

public String fragment()

Description copied from interface: ClientRequestContext

Returns the fragment part of the URI of the current Request, as defined in the section 3.5 of RFC3986.

Specified by:

fragment in interface ClientRequestContext

Returns:

the fragment part of the request URI, or null if no fragment was specified

options

public ClientOptions options()

Description copied from interface: ClientRequestContext

Returns the ClientOptions of the current Request.

Specified by:

options in interface ClientRequestContext

writeTimeoutMillis

public long writeTimeoutMillis()

Description copied from interface: ClientRequestContext

Returns the amount of time allowed until the initial write attempt of the current Request succeeds. This value is initially set from ClientOption.WRITE_TIMEOUT_MILLIS.

Specified by:

writeTimeoutMillis in interface ClientRequestContext

setWriteTimeoutMillis

public void setWriteTimeoutMillis(long writeTimeoutMillis)

Description copied from interface: ClientRequestContext

Returns the amount of time allowed until the initial write attempt of the current Request succeeds. This value is initially set from ClientOption.WRITE_TIMEOUT_MILLIS.

Specified by:

setWriteTimeoutMillis in interface ClientRequestContext

setWriteTimeout

public void setWriteTimeout(Duration writeTimeout)

Description copied from interface: ClientRequestContext

Returns the amount of time allowed until the initial write attempt of the current Request succeeds. This value is initially set from ClientOption.WRITE_TIMEOUT_MILLIS.

Specified by:

setWriteTimeout in interface ClientRequestContext

responseTimeoutMillis

public long responseTimeoutMillis()

Description copied from interface: ClientRequestContext

Returns the amount of time allowed until receiving the Response completely since the transfer of the Response started. This value is initially set from ClientOption.RESPONSE_TIMEOUT_MILLIS.

Specified by:

responseTimeoutMillis in interface ClientRequestContext

clearResponseTimeout

public void clearResponseTimeout()

Description copied from interface: ClientRequestContext

Clears the previously scheduled response timeout, if any. Note that calling this will prevent the response from ever being timed out.

Specified by:

clearResponseTimeout in interface ClientRequestContext

setResponseTimeoutMillis

public void setResponseTimeoutMillis(TimeoutMode mode, long responseTimeoutMillis)

Description copied from interface: ClientRequestContext

Schedules the response timeout that is triggered when the Response is not fully received within the specified TimeoutMode and the specified responseTimeoutMillis since the Response started or Request was fully sent. This value is initially set from ClientOption.RESPONSE_TIMEOUT_MILLIS.

Timeout mode	description
TimeoutMode.SET_FROM_NOW	Sets a given amount of timeout from the current time.
TimeoutMode.SET_FROM_START	Sets a given amount of timeout since the current Response began processing.
TimeoutMode.EXTEND	Extends the previously scheduled timeout by the given amount of timeout.

For example:

 ClientRequestContext ctx = ...;
 // Schedules a timeout from the start time of the response
 ctx.setResponseTimeoutMillis(TimeoutMode.SET_FROM_START, 2000);
 assert ctx.responseTimeoutMillis() == 2000;
 ctx.setResponseTimeoutMillis(TimeoutMode.SET_FROM_START, 1000);
 assert ctx.responseTimeoutMillis() == 1000;

 // Schedules timeout after 3 seconds from now.
 ctx.setResponseTimeoutMillis(TimeoutMode.SET_FROM_NOW, 3000);

 // Extends the previously scheduled timeout.
 long oldResponseTimeoutMillis = ctx.responseTimeoutMillis();
 ctx.setResponseTimeoutMillis(TimeoutMode.EXTEND, 1000);
 assert ctx.responseTimeoutMillis() == oldResponseTimeoutMillis + 1000;
 ctx.extendResponseTimeoutMillis(TimeoutMode.EXTEND, -500);
 assert ctx.responseTimeoutMillis() == oldResponseTimeoutMillis + 500;
 

Specified by:

setResponseTimeoutMillis in interface ClientRequestContext

setResponseTimeoutAtMillis

@Deprecated public void setResponseTimeoutAtMillis(long responseTimeoutAtMillis)

Deprecated.

Description copied from interface: ClientRequestContext

Schedules the response timeout that is triggered at the specified time represented as the number since the epoch (1970-01-01T00:00:00Z). Note that the response will be timed out immediately if the specified time is before now. The initial timeout is set from ClientOption.RESPONSE_TIMEOUT_MILLIS.

For example:

 ClientRequestContext ctx = ...;
 // Schedules timeout after 1 seconds from now.
 long responseTimeoutAt = Instant.now().plus(1, ChronoUnit.SECONDS).toEpochMilli();
 ctx.setResponseTimeoutAtMillis(responseTimeoutAt);
 

Specified by:

setResponseTimeoutAtMillis in interface ClientRequestContext

Parameters:

responseTimeoutAtMillis - the response timeout represented as the number of milliseconds since the epoch (1970-01-01T00:00:00Z)

responseTimeoutHandler

@Nullable public Runnable responseTimeoutHandler()

Description copied from interface: ClientRequestContext

Returns Response timeout handler which is executed when the Response is not completely received within the allowed ClientRequestContext.responseTimeoutMillis() or the default ClientOption.RESPONSE_TIMEOUT_MILLIS.

Specified by:

responseTimeoutHandler in interface ClientRequestContext

setResponseTimeoutHandler

public void setResponseTimeoutHandler(Runnable responseTimeoutHandler)

Description copied from interface: ClientRequestContext

Sets a handler to run when the response times out. responseTimeoutHandler must abort the response, e.g., by calling StreamMessage.abort(Throwable). If not set, the response will be closed with ResponseTimeoutException.

For example,

 HttpResponseWriter res = HttpResponse.streaming();
 ctx.setResponseTimeoutHandler(() -> {
    res.abort(new IllegalStateException("Server is in a bad state."));
 });
 ...
 

Specified by:

setResponseTimeoutHandler in interface ClientRequestContext

maxResponseLength

public long maxResponseLength()

Description copied from interface: ClientRequestContext

Returns the maximum length of the received Response. This value is initially set from ClientOption.MAX_RESPONSE_LENGTH.

Specified by:

maxResponseLength in interface ClientRequestContext

Returns:

the maximum length of the response. 0 if unlimited.

See Also:

ContentTooLargeException

setMaxResponseLength

public void setMaxResponseLength(long maxResponseLength)

Description copied from interface: ClientRequestContext

Sets the maximum length of the received Response. This value is initially set from ClientOption.MAX_RESPONSE_LENGTH. Specify 0 to disable the limit of the length of a response.

Specified by:

setMaxResponseLength in interface ClientRequestContext

See Also:

ContentTooLargeException

additionalRequestHeaders

public HttpHeaders additionalRequestHeaders()

Description copied from interface: ClientRequestContext

Returns an HttpHeaders which will be included when a Client sends an HttpRequest.

Specified by:

additionalRequestHeaders in interface ClientRequestContext

setAdditionalRequestHeader

public void setAdditionalRequestHeader(CharSequence name, Object value)

Description copied from interface: ClientRequestContext

Sets a header with the specified name and value. This will remove all previous values associated with the specified name. The header will be included when a Client sends an HttpRequest.

Specified by:

setAdditionalRequestHeader in interface ClientRequestContext

addAdditionalRequestHeader

public void addAdditionalRequestHeader(CharSequence name, Object value)

Description copied from interface: ClientRequestContext

Adds a header with the specified name and value. The header will be included when a Client sends an HttpRequest.

Specified by:

addAdditionalRequestHeader in interface ClientRequestContext

mutateAdditionalRequestHeaders

public void mutateAdditionalRequestHeaders(Consumer<HttpHeadersBuilder> mutator)

Description copied from interface: ClientRequestContext

Mutates the HttpHeaders which will be included when a Client sends an HttpRequest.

Specified by:

mutateAdditionalRequestHeaders in interface ClientRequestContext

Parameters:

mutator - the Consumer that mutates the additional request headers

timeoutNow

public void timeoutNow()

Description copied from interface: RequestContext

Triggers the current timeout immediately if a timeout was scheduled before. Otherwise, the current Request will be timed-out immediately after a timeout scheduler is initialized.

Specified by:

timeoutNow in interface RequestContext

isTimedOut

public boolean isTimedOut()

Description copied from interface: RequestContext

Returns whether this RequestContext has been timed-out (e.g., when the corresponding request passes a deadline).

Specified by:

isTimedOut in interface RequestContext