Package io.servicetalk.http.api

Class HttpContextKeys

java.lang.Object

io.servicetalk.http.api.HttpContextKeys

public final class HttpContextKeys
extends Object

All ContextMap.Key(s) defined for HTTP.

Field Summary

Fields

Modifier and Type	Field	Description
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.
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.
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.

Method Summary

Methods inherited from class java.lang.Object

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

Field Details

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.proxyConfig(ProxyConfig)

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)