Top Fields Constructors Methods
org.eclipse.jetty.ee10.websocket.server.internal

public Class DelegatedServerUpgradeRequest

extends Object
implements JettyServerUpgradeRequest
Class Inheritance
All Implemented Interfaces
org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest, org.eclipse.jetty.websocket.api.UpgradeRequest
Imports
java.net.HttpCookie, .SocketAddress, .URI, java.security.Principal, java.security.cert.X509Certificate, java.util.ArrayList, .Arrays, .Collections, .Enumeration, .HashMap, .List, .Locale, .Map, java.util.stream.Collectors, jakarta.servlet.http.Cookie, .HttpServletRequest, .HttpSession, org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest, org.eclipse.jetty.http.BadMessageException, .HttpHeader, org.eclipse.jetty.util.URIUtil, org.eclipse.jetty.websocket.api.ExtensionConfig, org.eclipse.jetty.websocket.common.JettyExtensionConfig, org.eclipse.jetty.websocket.core.WebSocketConstants, org.eclipse.jetty.websocket.core.server.ServerUpgradeRequest

Field Summary

Modifier and TypeField and Description
private List<HttpCookie>
cookies

private final HttpServletRequest
httpServletRequest

private Map<String, List<String>>
parameterMap

private final String
queryString

private final URI
requestURI

private final ServerUpgradeRequest
upgradeRequest

private final Principal
userPrincipal

Constructor Summary

AccessConstructor and Description
public
DelegatedServerUpgradeRequest(ServerUpgradeRequest request)

Method Summary

Modifier and TypeMethod and Description
public X509Certificate[]
getCertificates()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getCertificates.

public List<HttpCookie>
getCookies()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getCookies.

Get the list of Cookies on the Upgrade request

public List<ExtensionConfig>
getExtensions()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getExtensions.

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

public String
getHeader(String
the name of the header
name)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeader.

Get a specific Header value from Upgrade Request

public int
getHeaderInt(String
the name of the header
name)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaderInt.

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

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

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaders.

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

public List<String>
getHeaders(String
the header name
name)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaders.

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

public String
getHost()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHost.

The host of the Upgrade Request URI

public HttpServletRequest
getHttpServletRequest()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getHttpServletRequest.

public String
getHttpVersion()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHttpVersion.

The HTTP version used for this Upgrade Request

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

public Locale
getLocale()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocale.

public Enumeration<Locale>
getLocales()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocales.

public SocketAddress
getLocalSocketAddress()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocalSocketAddress.

public String
getMethod()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getMethod.

The HTTP method for this Upgrade Request.

public String
getOrigin()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getOrigin.

The WebSocket Origin of this Upgrade Request

See RFC6455: Section 10.2 for details.

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

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getParameterMap.

Returns a map of the query parameters of the request.

public String
getProtocolVersion()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getProtocolVersion.

Get the WebSocket Protocol Version

As of RFC6455, Jetty only supports version 13

public String
getQueryString()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getQueryString.

Get the Query String of the request URI.

public SocketAddress
getRemoteSocketAddress()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getRemoteSocketAddress.

public String
getRequestPath()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getRequestPath.

public URI
getRequestURI()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getRequestURI.

Get the Request URI

public ServerUpgradeRequest
getServerUpgradeRequest()

public Object
getServletAttribute(String
Attribute name
name)

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletAttribute.

public Map<String, Object>
getServletAttributes()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletAttributes.

public Map<String, List<String>>
getServletParameters()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletParameters.

public HttpSession
getSession()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getSession.

Access the Servlet HTTP Session (if present)

Note

Never present on a Client UpgradeRequest.

public List<String>
getSubProtocols()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getSubProtocols.

Get the list of offered WebSocket sub-protocols.

public Principal
getUserPrincipal()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getUserPrincipal.

Get the User Principal for this request.

public boolean
hasSubProtocol(String
the sub-protocol to test for
subprotocol)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.hasSubProtocol.

Test if a specific sub-protocol is offered

public boolean
isSecure()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.isSecure.

Test if connection is secure.

public boolean
isUserInRole(String
The user role
role)

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.isUserInRole.

public void
setServletAttribute(String
Attribute name
name, Object
Attribute value to set
value)

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.setServletAttribute.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

cookiesback to summary
private List<HttpCookie> cookies
httpServletRequestback to summary
private final HttpServletRequest httpServletRequest
parameterMapback to summary
private Map<String, List<String>> parameterMap
queryStringback to summary
private final String queryString
requestURIback to summary
private final URI requestURI
upgradeRequestback to summary
private final ServerUpgradeRequest upgradeRequest
userPrincipalback to summary
private final Principal userPrincipal

Constructor Detail

DelegatedServerUpgradeRequestback to summary
public DelegatedServerUpgradeRequest(ServerUpgradeRequest request)

Method Detail

getCertificatesback to summary
public X509Certificate[] getCertificates()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getCertificates.

Returns:X509Certificate[]

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getCertificates.

The X509Certificate instance at request attribute "jakarta.servlet.request.X509Certificate" or null.

Annotations
@Override
getCookiesback to summary
public List<HttpCookie> getCookies()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getCookies.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getCookies.

Get the list of Cookies on the Upgrade request

Returns:List<HttpCookie>

the list of Cookies

Annotations
@Override
getExtensionsback to summary
public List<ExtensionConfig> getExtensions()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getExtensions.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.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:List<ExtensionConfig>

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

Annotations
@Override
getHeaderback to summary
public String getHeader(String name)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeader.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getHeader.

Get a specific Header value from Upgrade Request

Parameters
name:String

the name of the header

Returns:String

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

Annotations
@Override
getHeaderIntback to summary
public int getHeaderInt(String name)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaderInt.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaderInt.

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

Parameters
name:String

the name of the header

Returns:int

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

Annotations
@Override
getHeadersback to summary
public Map<String, List<String>> getHeaders()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaders.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaders.

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

Returns:Map<String, List<String>>

the headers

Annotations
@Override
getHeadersback to summary
public List<String> getHeaders(String name)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaders.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getHeaders.

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

Parameters
name:String

the header name

Returns:List<String>

the value list (null if no header exists)

Annotations
@Override
getHostback to summary
public String getHost()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHost.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getHost.

The host of the Upgrade Request URI

Returns:String

host of the request URI

Annotations
@Override
getHttpServletRequestback to summary
public HttpServletRequest getHttpServletRequest()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getHttpServletRequest.

Returns:HttpServletRequest

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getHttpServletRequest.

Immutable version of HttpServletRequest

Annotations
@Override
getHttpVersionback to summary
public String getHttpVersion()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getHttpVersion.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getHttpVersion.

The HTTP version used for this Upgrade Request

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

Returns:String

the HTTP Version used

Annotations
@Override
getLocaleback to summary
public Locale getLocale()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocale.

Returns:Locale

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocale.

The requested Locale

Annotations
@Override
getLocalesback to summary
public Enumeration<Locale> getLocales()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocales.

Returns:Enumeration<Locale>

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocales.

The requested Locales

Annotations
@Override
getLocalSocketAddressback to summary
public SocketAddress getLocalSocketAddress()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocalSocketAddress.

Returns:SocketAddress

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getLocalSocketAddress.

The local requested address, which is typically an InetSocketAddress, but may be another derivation of SocketAddress

Annotations
@Override
getMethodback to summary
public String getMethod()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getMethod.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getMethod.

The HTTP method for this Upgrade Request.

As of RFC6455 (December 2011) this is always GET

Returns:String

the HTTP method used

Annotations
@Override
getOriginback to summary
public String getOrigin()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getOrigin.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getOrigin.

The WebSocket Origin of this Upgrade Request

See RFC6455: Section 10.2 for details.

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

Returns:String

the Origin header

Annotations
@Override
getParameterMapback to summary
public Map<String, List<String>> getParameterMap()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getParameterMap.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getParameterMap.

Returns a map of the query parameters of the request.

Returns:Map<String, List<String>>

a unmodifiable map of query parameters of the request.

Annotations
@Override
getProtocolVersionback to summary
public String getProtocolVersion()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getProtocolVersion.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getProtocolVersion.

Get the WebSocket Protocol Version

As of RFC6455, Jetty only supports version 13

Returns:String

the WebSocket protocol version

Annotations
@Override
getQueryStringback to summary
public String getQueryString()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getQueryString.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getQueryString.

Get the Query String of the request URI.

Returns:String

the request uri query string

Annotations
@Override
getRemoteSocketAddressback to summary
public SocketAddress getRemoteSocketAddress()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getRemoteSocketAddress.

Returns:SocketAddress

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getRemoteSocketAddress.

The remote request address, which is typically an InetSocketAddress, but may be another derivation of SocketAddress

Annotations
@Override
getRequestPathback to summary
public String getRequestPath()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getRequestPath.

Returns:String

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getRequestPath.

The request URI path within the context

Annotations
@Override
getRequestURIback to summary
public URI getRequestURI()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getRequestURI.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getRequestURI.

Get the Request URI

Returns:URI

the request URI

Annotations
@Override
getServerUpgradeRequestback to summary
public ServerUpgradeRequest getServerUpgradeRequest()
getServletAttributeback to summary
public Object getServletAttribute(String name)

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletAttribute.

Parameters
name:String

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletAttribute.

Attribute name

Returns:Object

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletAttribute.

Attribute value or null

Annotations
@Override
getServletAttributesback to summary
public Map<String, Object> getServletAttributes()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletAttributes.

Returns:Map<String, Object>

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletAttributes.

Request attribute map

Annotations
@Override
getServletParametersback to summary
public Map<String, List<String>> getServletParameters()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletParameters.

Returns:Map<String, List<String>>

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getServletParameters.

Request parameters

Annotations
@Override
getSessionback to summary
public HttpSession getSession()

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getSession.

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.getSession.

Access the Servlet HTTP Session (if present)

Note

Never present on a Client UpgradeRequest.

Returns:HttpSession

the Servlet HTTPSession on server side UpgradeRequests

Annotations
@Override
getSubProtocolsback to summary
public List<String> getSubProtocols()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getSubProtocols.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getSubProtocols.

Get the list of offered WebSocket sub-protocols.

Returns:List<String>

the list of offered sub-protocols

Annotations
@Override
getUserPrincipalback to summary
public Principal getUserPrincipal()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.getUserPrincipal.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.getUserPrincipal.

Get the User Principal for this request.

Only applicable when using UpgradeRequest from server side.

Returns:Principal

the user principal

Annotations
@Override
hasSubProtocolback to summary
public boolean hasSubProtocol(String subprotocol)

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.hasSubProtocol.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.hasSubProtocol.

Test if a specific sub-protocol is offered

Parameters
subprotocol:String

the sub-protocol to test for

Returns:boolean

true if sub-protocol exists on request

Annotations
@Override
isSecureback to summary
public boolean isSecure()

Implements org.eclipse.jetty.websocket.api.UpgradeRequest.isSecure.

Doc from org.eclipse.jetty.websocket.api.UpgradeRequest.isSecure.

Test if connection is secure.

Returns:boolean

true if connection is secure.

Annotations
@Override
isUserInRoleback to summary
public boolean isUserInRole(String role)

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.isUserInRole.

Parameters
role:String

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.isUserInRole.

The user role

Returns:boolean

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.isUserInRole.

True if the requests user has the role

Annotations
@Override
setServletAttributeback to summary
public void setServletAttribute(String name, Object value)

Implements org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.setServletAttribute.

Parameters
name:String

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.setServletAttribute.

Attribute name

value:Object

Doc from org.eclipse.jetty.ee10.websocket.server.JettyServerUpgradeRequest.setServletAttribute.

Attribute value to set

Annotations
@Override