org.apache.juneau.http

Class Connection

java.lang.Object

org.apache.juneau.http.HeaderString

org.apache.juneau.http.Connection

public final class Connection
extends HeaderString

Represents a parsed Connection HTTP request header.

Control options for the current connection and list of hop-by-hop request fields.

Example

Connection: keep-alive Connection: Upgrade

RFC2616 Specification

The Connection general-header field allows the sender to specify options that are desired for that particular connection and MUST NOT be communicated by proxies over further connections.

The Connection header has the following grammar:

Connection = "Connection" ":" 1#(connection-token) connection-token = token

HTTP/1.1 proxies MUST parse the Connection header field before a message is forwarded and, for each connection-token in this field, remove any header field(s) from the message with the same name as the connection-token. Connection options are signaled by the presence of a connection-token in the Connection header field, not by any corresponding additional header field(s), since the additional header field may not be sent if there are no parameters associated with that connection option.

Message headers listed in the Connection header MUST NOT include end-to-end headers, such as Cache-Control.

HTTP/1.1 defines the "close" connection option for the sender to signal that the connection will be closed after completion of the response. For example...

Connection: close

...in either the request or the response header fields indicates that the connection SHOULD NOT be considered `persistent' (section 8.1) after the current request/response is complete.

HTTP/1.1 applications that do not support persistent connections MUST include the "close" connection option in every message.

A system receiving an HTTP/1.0 (or lower-version) message that includes a Connection header MUST, for each connection-token in this field, remove and ignore any header field(s) from the message with the same name as the connection-token. This protects against mistaken forwarding of such header fields by pre-HTTP/1.1 proxies. See section 19.6.2.

See Also:

• Hypertext Transfer Protocol -- HTTP/1.1

Method Summary

Modifier and Type	Method and Description
static Connection	forString(String value) Returns a parsed Connection header.
boolean	isClose() Returns true if the header value is close.
boolean	isKeepAlive() Returns true if the header value is keep-alive.
boolean	isUpgrade() Returns true if the header value is upgrade.

Methods inherited from class org.apache.juneau.http.HeaderString

asString, eq, eqIC, toString

Methods inherited from class java.lang.Object

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

Method Detail

forString

public static Connection forString(String value)

Returns a parsed Connection header.

Parameters:

value - The Connection header string.

Returns:

The parsed Connection header, or null if the string was null.

isClose

public boolean isClose()

Returns true if the header value is close.

Returns:

true if the header value is close.

isKeepAlive

public boolean isKeepAlive()

Returns true if the header value is keep-alive.

Returns:

true if the header value is keep-alive.

isUpgrade

public boolean isUpgrade()

Returns true if the header value is upgrade.

Returns:

true if the header value is upgrade.