org.apache.http.protocol
Interface HttpContext

All Known Implementing Classes:

BasicHttpContext, DefaultedHttpContext, SyncBasicHttpContext

public interface HttpContext

HttpContext represents execution state of an HTTP process. It is a structure that can be used to map an attribute name to an attribute value. Internally HTTP context implementations are usually backed by a HashMap.

The primary purpose of the HTTP context is to facilitate information sharing among various logically related components. HTTP context can be used to store a processing state for one message or several consecutive messages. Multiple logically related messages can participate in a logical session if the same context is reused between consecutive messages.

Since:

4.0

Field Summary

static java.lang.String

RESERVED_PREFIX The prefix reserved for use by HTTP components.

Method Summary

java.lang.Object	getAttribute(java.lang.String id) Obtains attribute with the given name.
java.lang.Object	removeAttribute(java.lang.String id) Removes attribute with the given name from the context.
void	setAttribute(java.lang.String id, java.lang.Object obj) Sets value of the attribute with the given name.

Field Detail

RESERVED_PREFIX

static final java.lang.String RESERVED_PREFIX

The prefix reserved for use by HTTP components. "http."

See Also:

Constant Field Values

Method Detail

getAttribute

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

Obtains attribute with the given name.

Parameters:

id - the attribute name.

Returns:

attribute value, or null if not set.

setAttribute

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

Sets value of the attribute with the given name.

Parameters:

id - the attribute name.

obj - the attribute value.

removeAttribute

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

Removes attribute with the given name from the context.

Parameters:

id - the attribute name.

Returns:

attribute value, or null if not set.