io.servicetalk.http.api

Class HttpContextKeys

Object

HttpContextKeys

public final class HttpContextKeys
extends Object

All ContextMap.Key(s) defined for HTTP.

Field Summary

Fields

Modifier and Type	Field and Description
static ContextMap.Key<HttpExecutionStrategy>	HTTP_EXECUTION_STRATEGY_KEY Allows using a custom HttpExecutionStrategy for the HTTP message execution, when present in the meta-data context.
static ContextMap.Key<Boolean>	HTTP_FORCE_NEW_CONNECTION If set to true, forces creating a new connection versus potentially selecting an already established one.
static ContextMap.Key<Object>	HTTP_TARGET_ADDRESS_BEHIND_PROXY Deprecated. Use TransportObserverConnectionFactoryFilter to configure TransportObserver and then listen ConnectionObserver.onProxyConnect(Object) callback to distinguish between a regular connection and a connection to the secure HTTP proxy tunnel. For clear text HTTP proxies, consider installing a custom client filter that will populate HttpMetaData.context() with a similar key or reach out to the ServiceTalk developers to discuss ideas.

Method Summary

Methods inherited from class Object

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

Field Detail

HTTP_EXECUTION_STRATEGY_KEY

public static final ContextMap.Key<HttpExecutionStrategy> HTTP_EXECUTION_STRATEGY_KEY

Allows using a custom HttpExecutionStrategy for the HTTP message execution, when present in the meta-data context. Otherwise, an automatically inferred strategy will be used by a client or server.

HTTP_TARGET_ADDRESS_BEHIND_PROXY

@Deprecated
public static final ContextMap.Key<Object> HTTP_TARGET_ADDRESS_BEHIND_PROXY

Deprecated. Use TransportObserverConnectionFactoryFilter to configure TransportObserver and then listen ConnectionObserver.onProxyConnect(Object) callback to distinguish between a regular connection and a connection to the secure HTTP proxy tunnel. For clear text HTTP proxies, consider installing a custom client filter that will populate HttpMetaData.context() with a similar key or reach out to the ServiceTalk developers to discuss ideas.

When opening a connection to a proxy, this key tells what is the actual (unresolved) target address behind the proxy this connection will be established to.

To distinguish between a secure HTTP proxy tunneling and a clear text HTTP proxy, check presence of ConnectionInfo.sslConfig().

See Also:

SingleAddressHttpClientBuilder.proxyAddress(Object)

HTTP_FORCE_NEW_CONNECTION

public static final ContextMap.Key<Boolean> HTTP_FORCE_NEW_CONNECTION

If set to true, forces creating a new connection versus potentially selecting an already established one.

This key is only available when reserving a connection and will be ignored when performing a regular request on the client (for example through HttpRequester.request(HttpRequest)).

See Also:

HttpClient.reserveConnection(HttpRequestMetaData)