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	CLUSTER_CONNECTION_ID_HEADER
static String	CONNECTION
static String	HOST
static String	ORIGIN_HEADER
static String	RESPONSE_CODE_MESSAGE
static String	SEC_WS_ORIGIN_HEADER
static String	SERVER_KEY_HASH
static String	UPGRADE
static String	WEBSOCKET

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

See Also:

Constant Field Values

RESPONSE_CODE_MESSAGE

public static final String RESPONSE_CODE_MESSAGE

See Also:

Constant Field Values

UPGRADE

public static final String UPGRADE

See Also:

Constant Field Values

CONNECTION

public static final String CONNECTION

See Also:

Constant Field Values

HOST

public static final String HOST

See Also:

Constant Field Values

SERVER_KEY_HASH

public static final String SERVER_KEY_HASH

See Also:

Constant Field Values

SEC_WS_ORIGIN_HEADER

public static final String SEC_WS_ORIGIN_HEADER

See Also:

Constant Field Values

ORIGIN_HEADER

public static final String ORIGIN_HEADER

See Also:

Constant Field Values

CLUSTER_CONNECTION_ID_HEADER

public static final String CLUSTER_CONNECTION_ID_HEADER

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.