Package org.eclipse.jetty.websocket.api

Interface UpgradeRequest

All Known Subinterfaces:

JettyServerUpgradeRequest

All Known Implementing Classes:

ClientUpgradeRequest, DelegatedJettyClientUpgradeRequest, DelegatedServerUpgradeRequest

public interface UpgradeRequest

The HTTP Upgrade to WebSocket Request

Method Summary

Modifier and Type	Method	Description
List<HttpCookie>	getCookies()	Get the list of Cookies on the Upgrade request
List<ExtensionConfig>	getExtensions()	Get the list of WebSocket Extension Configurations for this Upgrade Request.
String	getHeader(String name)	Get a specific Header value from Upgrade Request
int	getHeaderInt(String name)	Get the specific Header value, as an int, from the Upgrade Request.
Map<String,List<String>>	getHeaders()	Get the headers as a Map of keys to value lists.
List<String>	getHeaders(String name)	Get the specific header values (for multi-value headers)
String	getHost()	The host of the Upgrade Request URI
String	getHttpVersion()	The HTTP version used for this Upgrade Request
String	getMethod()	The HTTP method for this Upgrade Request.
String	getOrigin()	The WebSocket Origin of this Upgrade Request
Map<String,List<String>>	getParameterMap()	Returns a map of the query parameters of the request.
String	getProtocolVersion()	Get the WebSocket Protocol Version
String	getQueryString()	Get the Query String of the request URI.
URI	getRequestURI()	Get the Request URI
List<String>	getSubProtocols()	Get the list of offered WebSocket sub-protocols.
Principal	getUserPrincipal()	Get the User Principal for this request.
boolean	hasSubProtocol(String test)	Test if a specific sub-protocol is offered
boolean	isSecure()	Test if connection is secure.

Method Details

getCookies

List<HttpCookie> getCookies()

Get the list of Cookies on the Upgrade request

Returns:

the list of Cookies

getExtensions

List<ExtensionConfig> getExtensions()

Get the list of WebSocket Extension Configurations for this Upgrade Request.

This is merely the list of requested Extensions to use, see UpgradeResponse.getExtensions() for what was negotiated

Returns:

the list of Extension configurations (in the order they were specified)

getHeader

String getHeader(String name)

Get a specific Header value from Upgrade Request

Parameters:

name - the name of the header

Returns:

the value of the header (null if header does not exist)

getHeaderInt

int getHeaderInt(String name)

Get the specific Header value, as an int, from the Upgrade Request.

Parameters:

name - the name of the header

Returns:

the value of the header as an int (-1 if header does not exist)

Throws:

NumberFormatException - if unable to parse value as an int.

getHeaders

Map<String,List<String>> getHeaders()

Get the headers as a Map of keys to value lists.

Returns:

the headers

getHeaders

List<String> getHeaders(String name)

Get the specific header values (for multi-value headers)

Parameters:

name - the header name

Returns:

the value list (null if no header exists)

getHost

String getHost()

The host of the Upgrade Request URI

Returns:

host of the request URI

getHttpVersion

String getHttpVersion()

The HTTP version used for this Upgrade Request

As of RFC6455 (December 2011) this is always HTTP/1.1

Returns:

the HTTP Version used

getMethod

String getMethod()

The HTTP method for this Upgrade Request.

As of RFC6455 (December 2011) this is always GET

Returns:

the HTTP method used

getOrigin

String getOrigin()

The WebSocket Origin of this Upgrade Request

See RFC6455: Section 10.2 for details.

Equivalent to getHeader(String) passed the "Origin" header.

Returns:

the Origin header

getParameterMap

Map<String,List<String>> getParameterMap()

Returns a map of the query parameters of the request.

Returns:

a unmodifiable map of query parameters of the request.

getProtocolVersion

String getProtocolVersion()

Get the WebSocket Protocol Version

As of RFC6455, Jetty only supports version 13

Returns:

the WebSocket protocol version

getQueryString

String getQueryString()

Get the Query String of the request URI.

Returns:

the request uri query string

getRequestURI

URI getRequestURI()

Get the Request URI

Returns:

the request URI

getSubProtocols

List<String> getSubProtocols()

Get the list of offered WebSocket sub-protocols.

Returns:

the list of offered sub-protocols

getUserPrincipal

Principal getUserPrincipal()

Get the User Principal for this request.

Only applicable when using UpgradeRequest from server side.

Returns:

the user principal

hasSubProtocol

boolean hasSubProtocol(String test)

Test if a specific sub-protocol is offered

Parameters:

test - the sub-protocol to test for

Returns:

true if sub-protocol exists on request

isSecure

boolean isSecure()

Test if connection is secure.

Returns:

true if connection is secure.