public class UpgradeRequestAdapter extends Object implements UpgradeRequest
Constructor and Description |
---|
UpgradeRequestAdapter(String requestURI) |
UpgradeRequestAdapter(URI requestURI) |
Modifier and Type | Method and Description |
---|---|
void |
addExtensions(ExtensionConfig... configs)
Add WebSocket Extension Configuration(s) to Upgrade Request.
|
void |
addExtensions(String... configs)
Add WebSocket Extension Configuration(s) to request
|
void |
clearHeaders()
Remove all headers from request.
|
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
|
Object |
getSession()
Access the Servlet HTTP Session (if present)
|
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 |
isOrigin(String test)
Test if supplied Origin is the same as the Request
|
boolean |
isSecure()
Test if connection is secure.
|
void |
setCookies(List<HttpCookie> cookies)
Set the list of Cookies on the request
|
void |
setExtensions(List<ExtensionConfig> configs)
Set the list of WebSocket Extension configurations on the request.
|
void |
setHeader(String name,
List<String> values)
Set a specific header with multi-value field
|
void |
setHeader(String name,
String value)
Set a specific header value
|
void |
setHeaders(Map<String,List<String>> headers)
Sets multiple headers on the request.
|
void |
setHttpVersion(String httpVersion)
Set the HTTP Version to use.
|
void |
setMethod(String method)
Set the HTTP method to use.
|
void |
setRequestURI(URI uri)
Set the Request URI to use for this request.
|
void |
setSession(Object session)
Set the Session associated with this request.
|
void |
setSubProtocols(List<String> subProtocols)
Set the offered WebSocket Sub-Protocol list.
|
void |
setSubProtocols(String... protocols)
Set Sub Protocol request list.
|
public UpgradeRequestAdapter(String requestURI)
public UpgradeRequestAdapter(URI requestURI)
public void addExtensions(ExtensionConfig... configs)
UpgradeRequest
This is merely the list of requested Extensions to use, see UpgradeResponse.getExtensions()
for what was
negotiated
addExtensions
in interface UpgradeRequest
configs
- the configuration(s) to addpublic void addExtensions(String... configs)
UpgradeRequest
This is merely the list of requested Extensions to use, see UpgradeResponse.getExtensions()
for what was
negotiated
addExtensions
in interface UpgradeRequest
configs
- the configuration(s) to addpublic void clearHeaders()
UpgradeRequest
clearHeaders
in interface UpgradeRequest
public List<HttpCookie> getCookies()
UpgradeRequest
getCookies
in interface UpgradeRequest
public List<ExtensionConfig> getExtensions()
UpgradeRequest
This is merely the list of requested Extensions to use, see UpgradeResponse.getExtensions()
for what was
negotiated
getExtensions
in interface UpgradeRequest
public String getHeader(String name)
UpgradeRequest
getHeader
in interface UpgradeRequest
name
- the name of the headerpublic int getHeaderInt(String name)
UpgradeRequest
int
, from the Upgrade Request.getHeaderInt
in interface UpgradeRequest
name
- the name of the headerint
(-1 if header does not exist)public Map<String,List<String>> getHeaders()
UpgradeRequest
getHeaders
in interface UpgradeRequest
public List<String> getHeaders(String name)
UpgradeRequest
getHeaders
in interface UpgradeRequest
name
- the header namepublic String getHost()
UpgradeRequest
getHost
in interface UpgradeRequest
public String getHttpVersion()
UpgradeRequest
As of RFC6455 (December 2011) this is always
HTTP/1.1
getHttpVersion
in interface UpgradeRequest
public String getMethod()
UpgradeRequest
As of RFC6455 (December 2011) this is always GET
getMethod
in interface UpgradeRequest
public String getOrigin()
UpgradeRequest
See RFC6455: Section 10.2 for details.
Equivalent to UpgradeRequest.getHeader(String)
passed the "Origin" header.
getOrigin
in interface UpgradeRequest
public Map<String,List<String>> getParameterMap()
getParameterMap
in interface UpgradeRequest
public String getProtocolVersion()
UpgradeRequest
As of RFC6455, Jetty only supports version
13
getProtocolVersion
in interface UpgradeRequest
public String getQueryString()
UpgradeRequest
getQueryString
in interface UpgradeRequest
public URI getRequestURI()
UpgradeRequest
getRequestURI
in interface UpgradeRequest
public Object getSession()
Note: Never present on a Client UpgradeRequest.
getSession
in interface UpgradeRequest
public List<String> getSubProtocols()
UpgradeRequest
getSubProtocols
in interface UpgradeRequest
public Principal getUserPrincipal()
Only applicable when using UpgradeRequest from server side.
getUserPrincipal
in interface UpgradeRequest
public boolean hasSubProtocol(String test)
UpgradeRequest
hasSubProtocol
in interface UpgradeRequest
test
- the sub-protocol to test forpublic boolean isOrigin(String test)
UpgradeRequest
isOrigin
in interface UpgradeRequest
test
- the supplied originpublic boolean isSecure()
UpgradeRequest
isSecure
in interface UpgradeRequest
public void setCookies(List<HttpCookie> cookies)
UpgradeRequest
setCookies
in interface UpgradeRequest
cookies
- the cookies to usepublic void setExtensions(List<ExtensionConfig> configs)
UpgradeRequest
setExtensions
in interface UpgradeRequest
configs
- the list of extension configurationspublic void setHeader(String name, List<String> values)
UpgradeRequest
Overrides any previous value for this named header
setHeader
in interface UpgradeRequest
name
- the name of the headervalues
- the multi-value fieldpublic void setHeader(String name, String value)
UpgradeRequest
Overrides any previous value for this named header
setHeader
in interface UpgradeRequest
name
- the header to setvalue
- the value to set it topublic void setHeaders(Map<String,List<String>> headers)
UpgradeRequest
Only sets those headers provided, does not remove headers that exist on request and are not provided in the parameter for this method.
Convenience method vs calling UpgradeRequest.setHeader(String, List)
multiple times.
setHeaders
in interface UpgradeRequest
headers
- the headers to setpublic void setHttpVersion(String httpVersion)
UpgradeRequest
As of RFC6455 (December 2011) this should always be
HTTP/1.1
setHttpVersion
in interface UpgradeRequest
httpVersion
- the HTTP version to use.public void setMethod(String method)
UpgradeRequest
As of RFC6455 (December 2011) this is always GET
setMethod
in interface UpgradeRequest
method
- the HTTP method to use.public void setRequestURI(URI uri)
UpgradeRequest
Must be an absolute URI with scheme 'ws'
or 'wss'
setRequestURI
in interface UpgradeRequest
uri
- the Request URIpublic void setSession(Object session)
UpgradeRequest
Typically used to associate the Servlet HttpSession object.
setSession
in interface UpgradeRequest
session
- the session object to associate with this requestpublic void setSubProtocols(List<String> subProtocols)
UpgradeRequest
setSubProtocols
in interface UpgradeRequest
subProtocols
- the offered sub-protocol listpublic void setSubProtocols(String... protocols)
setSubProtocols
in interface UpgradeRequest
protocols
- the sub protocols desiredCopyright © 2010 - 2020 Adobe. All Rights Reserved