jakarta.websocket.server

Interface HandshakeRequest

All Known Implementing Classes:

RequestContext, UpgradeRequest

public interface HandshakeRequest

The handshake request represents the WebSocket defined HTTP GET request for the opening handshake of a WebSocket session.

Author:

dannycoward

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	SEC_WEBSOCKET_EXTENSIONS The Sec-WebSocket-Extensions header name
static java.lang.String	SEC_WEBSOCKET_KEY The Sec-WebSocket-Key header name
static java.lang.String	SEC_WEBSOCKET_PROTOCOL The Sec-WebSocket-Protocol header name
static java.lang.String	SEC_WEBSOCKET_VERSION The Sec-WebSocket-Version header name

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getHeaders() Return the read only map of HTTP headers to header values that came with the handshake request.
java.lang.Object	getHttpSession() Return a reference to the HttpSession that the web socket handshake that started this conversation was part of, if the implementation is part of a Java EE web container.
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getParameterMap() Return the request parameters associated with the request.
java.lang.String	getQueryString() Return the query string associated with the request.
java.net.URI	getRequestURI() Return the request URI of the handshake request.
java.security.Principal	getUserPrincipal() Return the authenticated user or null if no user is authenticated for this handshake.
boolean	isUserInRole(java.lang.String role) Checks whether the current user is in the given role.

Field Detail

SEC_WEBSOCKET_KEY

static final java.lang.String SEC_WEBSOCKET_KEY

The Sec-WebSocket-Key header name

See Also:

Constant Field Values

SEC_WEBSOCKET_PROTOCOL

static final java.lang.String SEC_WEBSOCKET_PROTOCOL

The Sec-WebSocket-Protocol header name

See Also:

Constant Field Values

SEC_WEBSOCKET_VERSION

static final java.lang.String SEC_WEBSOCKET_VERSION

The Sec-WebSocket-Version header name

See Also:

Constant Field Values

SEC_WEBSOCKET_EXTENSIONS

static final java.lang.String SEC_WEBSOCKET_EXTENSIONS

The Sec-WebSocket-Extensions header name

See Also:

Constant Field Values

Method Detail

getHeaders

java.util.Map<java.lang.String,java.util.List<java.lang.String>> getHeaders()

Return the read only map of HTTP headers to header values that came with the handshake request. Note that the lookup of header names will be performed in a case insensitive manner.

Returns:

the list of headers.

getUserPrincipal

java.security.Principal getUserPrincipal()

Return the authenticated user or null if no user is authenticated for this handshake.

Returns:

the user principal.

getRequestURI

java.net.URI getRequestURI()

Return the request URI of the handshake request.

Returns:

the request uri of the handshake request.

isUserInRole

boolean isUserInRole(java.lang.String role)

Checks whether the current user is in the given role. Roles and role membership can be defined using deployment descriptors of the containing WAR file, if running in a Java EE web container. If the user has not been authenticated, the method returns false.

Parameters:

role - the role being checked.

Returns:

whether the authenticated user is in the role, or false if the user has not been authenticated.

getHttpSession

java.lang.Object getHttpSession()

Return a reference to the HttpSession that the web socket handshake that started this conversation was part of, if the implementation is part of a Java EE web container.

Returns:

the http session or null if either the websocket implementation is not part of a Java EE web container, or there is no HttpSession associated with the opening handshake request.

getParameterMap

java.util.Map<java.lang.String,java.util.List<java.lang.String>> getParameterMap()

Return the request parameters associated with the request.

Returns:

the unmodifiable map of the request parameters.

getQueryString

java.lang.String getQueryString()

Return the query string associated with the request.

Returns:

the query string.