Package 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

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method 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.