Package org.apache.hc.core5.http.protocol

Class HttpCoreContext

java.lang.Object

org.apache.hc.core5.http.protocol.HttpCoreContext

All Implemented Interfaces:

HttpContext

Direct Known Subclasses:

HttpCoreContext.Delegate

public class HttpCoreContext
extends java.lang.Object
implements HttpContext

Core execution HttpContext.

IMPORTANT: This class is NOT thread-safe and MUST NOT be used concurrently by multiple message exchanges.

Since:

4.3

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	HttpCoreContext.Delegate	Internal adaptor class that delegates all its method calls to a plain HttpContext.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	CONNECTION_ENDPOINT	Deprecated. Use getter methods
private EndpointDetails	endpointDetails
static java.lang.String	HTTP_REQUEST	Deprecated. Use getter methods
static java.lang.String	HTTP_RESPONSE	Deprecated. Use getter methods
private java.util.Map<java.lang.String,java.lang.Object>	map
private HttpContext	parentContext
private HttpRequest	request
private HttpResponse	response
static java.lang.String	SSL_SESSION	Deprecated. Use getter methods
private javax.net.ssl.SSLSession	sslSession
private ProtocolVersion	version

Fields inherited from interface org.apache.hc.core5.http.protocol.HttpContext

RESERVED_PREFIX

Constructor Summary

Constructors

Constructor	Description
HttpCoreContext()
HttpCoreContext(HttpContext parentContext)

Method Summary

Modifier and Type	Method	Description
static HttpCoreContext	adapt(HttpContext context)	Deprecated. Use cast(HttpContext).
static HttpCoreContext	cast(HttpContext context)	Casts the given generic HttpContext as HttpCoreContext.
static HttpCoreContext	castOrCreate(HttpContext context)	Casts the given generic HttpContext as HttpCoreContext or creates new HttpCoreContext if the given context is null.
static HttpCoreContext	create()
java.lang.Object	getAttribute(java.lang.String id)	Obtains attribute with the given name.
<T> T	getAttribute(java.lang.String id, java.lang.Class<T> clazz)
EndpointDetails	getEndpointDetails()	Represents current connection endpoint details.
ProtocolVersion	getProtocolVersion()	Represents the protocol version used by the message exchange.
HttpRequest	getRequest()	Represents current request message head.
HttpResponse	getResponse()	Represents current response message head.
javax.net.ssl.SSLSession	getSSLSession()	Represents current TLS session details.
java.lang.Object	removeAttribute(java.lang.String id)	Removes attribute with the given name from the context.
java.lang.Object	setAttribute(java.lang.String id, java.lang.Object obj)	Sets value of the attribute with the given name.
void	setEndpointDetails(EndpointDetails endpointDetails)
void	setProtocolVersion(ProtocolVersion version)	Sets protocol version used in this context.
void	setRequest(HttpRequest request)
void	setResponse(HttpResponse response)
void	setSSLSession(javax.net.ssl.SSLSession sslSession)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

CONNECTION_ENDPOINT

@Deprecated
public static final java.lang.String CONNECTION_ENDPOINT

Deprecated.

Use getter methods

See Also:

Constant Field Values

SSL_SESSION

@Deprecated
public static final java.lang.String SSL_SESSION

Deprecated.

Use getter methods

See Also:

Constant Field Values

HTTP_REQUEST

@Deprecated
public static final java.lang.String HTTP_REQUEST

Deprecated.

Use getter methods

See Also:

Constant Field Values

HTTP_RESPONSE

@Deprecated
public static final java.lang.String HTTP_RESPONSE

Deprecated.

Use getter methods

See Also:

Constant Field Values

parentContext

private final HttpContext parentContext

map

private java.util.Map<java.lang.String,java.lang.Object> map

version

private ProtocolVersion version

request

private HttpRequest request

response

private HttpResponse response

endpointDetails

private EndpointDetails endpointDetails

sslSession

private javax.net.ssl.SSLSession sslSession

Constructor Detail

HttpCoreContext

public HttpCoreContext(HttpContext parentContext)

HttpCoreContext

public HttpCoreContext()

Method Detail

create

public static HttpCoreContext create()

adapt

@Deprecated
public static HttpCoreContext adapt(HttpContext context)

Deprecated.

Use cast(HttpContext).

cast

public static HttpCoreContext cast(HttpContext context)

Casts the given generic HttpContext as HttpCoreContext.

Since:

5.3

castOrCreate

public static HttpCoreContext castOrCreate(HttpContext context)

Casts the given generic HttpContext as HttpCoreContext or creates new HttpCoreContext if the given context is null.

Since:

5.4

getProtocolVersion

public ProtocolVersion getProtocolVersion()

Represents the protocol version used by the message exchange.

This context attribute is expected to be populated by the protocol handler in the course of request execution.

Specified by:

getProtocolVersion in interface HttpContext

Since:

5.0

setProtocolVersion

public void setProtocolVersion(ProtocolVersion version)

Description copied from interface: HttpContext

Sets protocol version used in this context.

Specified by:

setProtocolVersion in interface HttpContext

Since:

5.0

getAttribute

public java.lang.Object getAttribute(java.lang.String id)

Description copied from interface: HttpContext

Obtains attribute with the given name.

Specified by:

getAttribute in interface HttpContext

Parameters:

id - the attribute name.

Returns:

attribute value, or null if not set.

setAttribute

public java.lang.Object setAttribute(java.lang.String id,
                                     java.lang.Object obj)

Description copied from interface: HttpContext

Sets value of the attribute with the given name.

Specified by:

setAttribute in interface HttpContext

Parameters:

id - the attribute name.

obj - the attribute value.

Returns:

the previous value associated with id, or null if there was no mapping for id.

removeAttribute

public java.lang.Object removeAttribute(java.lang.String id)

Description copied from interface: HttpContext

Removes attribute with the given name from the context.

Specified by:

removeAttribute in interface HttpContext

Parameters:

id - the attribute name.

Returns:

attribute value, or null if not set.

getAttribute

public <T> T getAttribute(java.lang.String id,
                          java.lang.Class<T> clazz)

getRequest

public HttpRequest getRequest()

Represents current request message head.

This context attribute is expected to be populated by the protocol handler in the course of request execution.

setRequest

@Internal
public void setRequest(HttpRequest request)

Since:

5.3

getResponse

public HttpResponse getResponse()

Represents current response message head.

This context attribute is expected to be populated by the protocol handler in the course of request execution.

setResponse

@Internal
public void setResponse(HttpResponse response)

Since:

5.3

getEndpointDetails

public EndpointDetails getEndpointDetails()

Represents current connection endpoint details.

This context attribute is expected to be populated by the protocol handler in the course of request execution.

Since:

5.0

setEndpointDetails

@Internal
public void setEndpointDetails(EndpointDetails endpointDetails)

Since:

5.3

getSSLSession

public javax.net.ssl.SSLSession getSSLSession()

Represents current TLS session details.

This context attribute is expected to be populated by the protocol handler in the course of request execution.

Since:

5.0

setSSLSession

@Internal
public void setSSLSession(javax.net.ssl.SSLSession sslSession)

Since:

5.3

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object