org.glassfish.tyrus.spi

Class UpgradeRequest

java.lang.Object

org.glassfish.tyrus.spi.UpgradeRequest

All Implemented Interfaces:

javax.websocket.server.HandshakeRequest

public abstract class UpgradeRequest
extends Object
implements javax.websocket.server.HandshakeRequest

Abstraction for a HTTP upgrade request. A transport creates an implementation for this and uses WebSocketEngine.upgrade(org.glassfish.tyrus.spi.UpgradeRequest, org.glassfish.tyrus.spi.UpgradeResponse) method to upgrade the request.

Author:

Danny Coward (danny.coward at oracle.com), Pavel Bucek (pavel.bucek at oracle.com)

Field Summary

Fields

Modifier and Type	Field and Description
static String	AUTHORIZATION HTTP "Authorization" header name.
static String	CLUSTER_CONNECTION_ID_HEADER Tyrus cluster connection ID header name.
static String	CONNECTION HTTP "Connection" header name.
static String	HOST HTTP "Host" header name.
static String	ORIGIN_HEADER HTTP "Origin" header name.
static String	RESPONSE_CODE_MESSAGE HTTP reason phrase for successful handshake response.
static String	SEC_WS_ORIGIN_HEADER WebSocket origin header name from previous versions.
static String	SERVER_KEY_HASH Server key hash used to compute "Sec-WebSocket-Accept" header value.
static String	UPGRADE HTTP "Upgrade" header name and "Connection" header expected value.
static String	WEBSOCKET Expected value in HTTP handshake "Upgrade" header.

Fields inherited from interface javax.websocket.server.HandshakeRequest

SEC_WEBSOCKET_EXTENSIONS, SEC_WEBSOCKET_KEY, SEC_WEBSOCKET_PROTOCOL, SEC_WEBSOCKET_VERSION

Constructor Summary

Constructors

Constructor and Description
UpgradeRequest()

Method Summary

Methods

Modifier and Type	Method and Description
abstract String	getHeader(String name) Returns the value of the specified request header name.
abstract String	getRequestUri() Get the undecoded request uri (up to the query string) of underlying HTTP handshake request.
abstract boolean	isSecure() Indicates whether this request was made using a secure channel (such as HTTPS).

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.websocket.server.HandshakeRequest

getHeaders, getHttpSession, getParameterMap, getQueryString, getRequestURI, getUserPrincipal, isUserInRole

Field Detail

WEBSOCKET

public static final String WEBSOCKET

Expected value in HTTP handshake "Upgrade" header.

(Registered in RFC 6455).

See Also:

Constant Field Values

RESPONSE_CODE_MESSAGE

public static final String RESPONSE_CODE_MESSAGE

HTTP reason phrase for successful handshake response.

See Also:

Constant Field Values

UPGRADE

public static final String UPGRADE

HTTP "Upgrade" header name and "Connection" header expected value.

See Also:

Constant Field Values

CONNECTION

public static final String CONNECTION

HTTP "Connection" header name.

See Also:

Constant Field Values

HOST

public static final String HOST

HTTP "Host" header name.

See Also:

Constant Field Values

SEC_WS_ORIGIN_HEADER

public static final String SEC_WS_ORIGIN_HEADER

WebSocket origin header name from previous versions.

Keeping here only for backwards compatibility, not used anymore.

See Also:

Constant Field Values

ORIGIN_HEADER

public static final String ORIGIN_HEADER

HTTP "Origin" header name.

See Also:

Constant Field Values

CLUSTER_CONNECTION_ID_HEADER

public static final String CLUSTER_CONNECTION_ID_HEADER

Tyrus cluster connection ID header name.

See Also:

Constant Field Values

SERVER_KEY_HASH

public static final String SERVER_KEY_HASH

Server key hash used to compute "Sec-WebSocket-Accept" header value.

Defined in RFC 6455.

See Also:

Constant Field Values

AUTHORIZATION

public static final String AUTHORIZATION

HTTP "Authorization" header name.

See Also:

Constant Field Values

Constructor Detail

UpgradeRequest

public UpgradeRequest()

Method Detail

getHeader

public abstract String getHeader(String name)

Returns the value of the specified request header name. If there are multiple headers with the same name, this method returns the first header in the request. The header name is case insensitive.

Parameters:

name - a header name.

Returns:

value of the specified header name, null if the request doesn't have a header of that name.

getRequestUri

public abstract String getRequestUri()

Get the undecoded request uri (up to the query string) of underlying HTTP handshake request.

Returns:

request uri.

isSecure

public abstract boolean isSecure()

Indicates whether this request was made using a secure channel (such as HTTPS).

Returns:

true if the request was made using secure channel, false otherwise.