public class AtmosphereRequest
extends javax.servlet.http.HttpServletRequestWrapper
AtmosphereRequest is a two-way communication channel between the
client and the server. If the isDestroyable() is set to false, or if its
associated AtmosphereResource has been suspended, this object can be re-used at any moment between requests.
You can use its associated AtmosphereResponse to write bytes at any moment, making this object bi-directional.
| Modifier and Type | Class and Description |
|---|---|
static class |
AtmosphereRequest.Body |
static class |
AtmosphereRequest.Builder |
| Modifier | Constructor and Description |
|---|---|
protected |
AtmosphereRequest(AtmosphereRequest.Builder b) |
| Modifier and Type | Method and Description |
|---|---|
java.util.Map<java.lang.String,java.lang.Object> |
attributes()
Deprecated.
|
boolean |
authenticate(javax.servlet.http.HttpServletResponse response) |
AtmosphereRequest.Body |
body()
Return the request's body.
|
AtmosphereRequest |
body(byte[] bytes) |
AtmosphereRequest |
body(java.io.InputStream body) |
AtmosphereRequest |
body(java.io.Reader body) |
AtmosphereRequest |
body(java.lang.String body) |
static AtmosphereRequest |
cloneRequest(javax.servlet.http.HttpServletRequest request,
boolean loadInMemory,
boolean copySession,
boolean isDestroyable,
boolean createSession)
Copy the HttpServletRequest content inside an AtmosphereRequest.
|
AtmosphereRequest |
contentType(java.lang.String m) |
AtmosphereRequest |
contextPath(java.lang.String contextPath) |
void |
destroy() |
void |
destroy(boolean force) |
AtmosphereRequest |
destroyable(boolean destroyable) |
boolean |
destroyed() |
boolean |
dispatchRequestAsynchronously()
Dispatch the request asynchronously to container.
|
javax.servlet.AsyncContext |
getAsyncContext() |
java.lang.Object |
getAttribute(java.lang.String s) |
java.util.Enumeration<java.lang.String> |
getAttributeNames() |
java.lang.String |
getAuthType() |
java.lang.String |
getCharacterEncoding() |
int |
getContentLength() |
java.lang.String |
getContentType() |
java.lang.String |
getContextPath() |
javax.servlet.http.Cookie[] |
getCookies() |
long |
getDateHeader(java.lang.String name) |
javax.servlet.DispatcherType |
getDispatcherType() |
java.lang.String |
getHeader(java.lang.String s) |
java.lang.String |
getHeader(java.lang.String s,
boolean checkCase) |
java.util.Enumeration<java.lang.String> |
getHeaderNames() |
java.util.Enumeration |
getHeaders(java.lang.String name) |
javax.servlet.ServletInputStream |
getInputStream() |
int |
getIntHeader(java.lang.String name) |
java.lang.String |
getLocalAddr() |
java.util.Locale |
getLocale() |
java.util.Enumeration<java.util.Locale> |
getLocales() |
java.lang.String |
getLocalName() |
int |
getLocalPort() |
java.lang.String |
getMethod() |
java.lang.String |
getParameter(java.lang.String s) |
java.util.Map<java.lang.String,java.lang.String[]> |
getParameterMap() |
java.util.Enumeration<java.lang.String> |
getParameterNames() |
java.lang.String[] |
getParameterValues(java.lang.String s) |
javax.servlet.http.Part |
getPart(java.lang.String name) |
java.util.Collection<javax.servlet.http.Part> |
getParts() |
java.lang.String |
getPathInfo() |
java.lang.String |
getPathTranslated() |
java.lang.String |
getProtocol() |
java.lang.String |
getQueryString() |
java.io.BufferedReader |
getReader() |
java.lang.String |
getRealPath(java.lang.String path) |
java.lang.String |
getRemoteAddr() |
java.lang.String |
getRemoteHost() |
int |
getRemotePort() |
java.lang.String |
getRemoteUser() |
javax.servlet.RequestDispatcher |
getRequestDispatcher(java.lang.String path) |
java.lang.String |
getRequestedSessionId() |
java.lang.String |
getRequestURI() |
java.lang.StringBuffer |
getRequestURL() |
java.lang.String |
getScheme() |
java.lang.String |
getServerName() |
int |
getServerPort() |
javax.servlet.ServletContext |
getServletContext() |
java.lang.String |
getServletPath() |
javax.servlet.http.HttpSession |
getSession() |
javax.servlet.http.HttpSession |
getSession(boolean create) |
java.security.Principal |
getUserPrincipal() |
AtmosphereRequest |
header(java.lang.String name,
java.lang.String value)
Add a header.
|
AtmosphereRequest |
headers(java.util.Map<java.lang.String,java.lang.String> headers)
Add all headers contained within the Map.
|
java.util.Map<java.lang.String,java.lang.String> |
headersMap() |
boolean |
isAsyncStarted() |
boolean |
isAsyncSupported() |
boolean |
isDestroyable()
Cjeck if this object can be destroyed.
|
boolean |
isRequestedSessionIdFromCookie() |
boolean |
isRequestedSessionIdFromUrl() |
boolean |
isRequestedSessionIdFromURL() |
boolean |
isRequestedSessionIdValid() |
boolean |
isSecure() |
boolean |
isUserInRole(java.lang.String role) |
java.util.Map<java.lang.String,java.lang.Object> |
localAttributes()
Return a subset of the attributes set on this AtmosphereRequest, set locally by the framework or by an application.
|
void |
login(java.lang.String username,
java.lang.String password) |
void |
logout() |
AtmosphereRequest |
method(java.lang.String m) |
static AtmosphereRequest |
newInstance()
Create an instance of this class without an associated
HttpServletRequest. |
AtmosphereRequest |
pathInfo(java.lang.String pathInfo) |
AtmosphereRequest |
queryString(java.lang.String qs)
Set the query string.
|
java.util.Map<java.lang.String,java.lang.String[]> |
queryStringsMap() |
void |
removeAttribute(java.lang.String name) |
AtmosphereRequest |
requestURI(java.lang.String requestURI) |
java.lang.String |
requestURL() |
AtmosphereResource |
resource()
The
AtmosphereResource associated with this request. |
AtmosphereRequest |
servletPath(java.lang.String servletPath) |
void |
setAttribute(java.lang.String s,
java.lang.Object o) |
void |
setCharacterEncoding(java.lang.String env) |
void |
setRequest(javax.servlet.ServletRequest request) |
javax.servlet.AsyncContext |
startAsync() |
javax.servlet.AsyncContext |
startAsync(javax.servlet.ServletRequest request,
javax.servlet.ServletResponse response) |
java.lang.String |
toString() |
java.lang.String |
uuid()
Return the underlying
AtmosphereResource.uuid(). |
static AtmosphereRequest |
wrap(javax.servlet.http.HttpServletRequest request)
Wrap an
HttpServletRequest. |
javax.servlet.http.HttpServletRequest |
wrappedRequest() |
protected AtmosphereRequest(AtmosphereRequest.Builder b)
public boolean destroyed()
public AtmosphereRequest destroyable(boolean destroyable)
public java.lang.String getPathInfo()
getPathInfo in interface javax.servlet.http.HttpServletRequestgetPathInfo in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getPathTranslated()
getPathTranslated in interface javax.servlet.http.HttpServletRequestgetPathTranslated in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getQueryString()
getQueryString in interface javax.servlet.http.HttpServletRequestgetQueryString in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getRemoteUser()
getRemoteUser in interface javax.servlet.http.HttpServletRequestgetRemoteUser in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getRequestedSessionId()
getRequestedSessionId in interface javax.servlet.http.HttpServletRequestgetRequestedSessionId in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getMethod()
getMethod in interface javax.servlet.http.HttpServletRequestgetMethod in class javax.servlet.http.HttpServletRequestWrapperpublic javax.servlet.http.Part getPart(java.lang.String name)
throws java.io.IOException,
javax.servlet.ServletException
getPart in interface javax.servlet.http.HttpServletRequestgetPart in class javax.servlet.http.HttpServletRequestWrapperjava.io.IOExceptionjavax.servlet.ServletExceptionpublic java.util.Collection<javax.servlet.http.Part> getParts()
throws java.io.IOException,
javax.servlet.ServletException
getParts in interface javax.servlet.http.HttpServletRequestgetParts in class javax.servlet.http.HttpServletRequestWrapperjava.io.IOExceptionjavax.servlet.ServletExceptionpublic java.lang.String getContentType()
getContentType in interface javax.servlet.ServletRequestgetContentType in class javax.servlet.ServletRequestWrapperpublic javax.servlet.DispatcherType getDispatcherType()
getDispatcherType in interface javax.servlet.ServletRequestgetDispatcherType in class javax.servlet.ServletRequestWrapperpublic java.lang.String getServletPath()
getServletPath in interface javax.servlet.http.HttpServletRequestgetServletPath in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getRequestURI()
getRequestURI in interface javax.servlet.http.HttpServletRequestgetRequestURI in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.StringBuffer getRequestURL()
getRequestURL in interface javax.servlet.http.HttpServletRequestgetRequestURL in class javax.servlet.http.HttpServletRequestWrapperpublic java.util.Enumeration getHeaders(java.lang.String name)
getHeaders in interface javax.servlet.http.HttpServletRequestgetHeaders in class javax.servlet.http.HttpServletRequestWrapperpublic int getIntHeader(java.lang.String name)
getIntHeader in interface javax.servlet.http.HttpServletRequestgetIntHeader in class javax.servlet.http.HttpServletRequestWrapperpublic java.util.Enumeration<java.lang.String> getHeaderNames()
getHeaderNames in interface javax.servlet.http.HttpServletRequestgetHeaderNames in class javax.servlet.http.HttpServletRequestWrapperpublic boolean authenticate(javax.servlet.http.HttpServletResponse response)
throws java.io.IOException,
javax.servlet.ServletException
authenticate in interface javax.servlet.http.HttpServletRequestauthenticate in class javax.servlet.http.HttpServletRequestWrapperjava.io.IOExceptionjavax.servlet.ServletExceptionpublic java.lang.String getAuthType()
getAuthType in interface javax.servlet.http.HttpServletRequestgetAuthType in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getContextPath()
getContextPath in interface javax.servlet.http.HttpServletRequestgetContextPath in class javax.servlet.http.HttpServletRequestWrapperpublic javax.servlet.http.Cookie[] getCookies()
getCookies in interface javax.servlet.http.HttpServletRequestgetCookies in class javax.servlet.http.HttpServletRequestWrapperpublic long getDateHeader(java.lang.String name)
getDateHeader in interface javax.servlet.http.HttpServletRequestgetDateHeader in class javax.servlet.http.HttpServletRequestWrapperpublic java.lang.String getHeader(java.lang.String s)
getHeader in interface javax.servlet.http.HttpServletRequestgetHeader in class javax.servlet.http.HttpServletRequestWrapperpublic javax.servlet.http.HttpServletRequest wrappedRequest()
public java.lang.String getHeader(java.lang.String s,
boolean checkCase)
public java.lang.String getParameter(java.lang.String s)
getParameter in interface javax.servlet.ServletRequestgetParameter in class javax.servlet.ServletRequestWrapperpublic java.util.Map<java.lang.String,java.lang.String[]> getParameterMap()
getParameterMap in interface javax.servlet.ServletRequestgetParameterMap in class javax.servlet.ServletRequestWrapperpublic java.util.Enumeration<java.lang.String> getParameterNames()
getParameterNames in interface javax.servlet.ServletRequestgetParameterNames in class javax.servlet.ServletRequestWrapperpublic java.lang.String[] getParameterValues(java.lang.String s)
getParameterValues in interface javax.servlet.ServletRequestgetParameterValues in class javax.servlet.ServletRequestWrapperpublic java.lang.String getProtocol()
getProtocol in interface javax.servlet.ServletRequestgetProtocol in class javax.servlet.ServletRequestWrapperpublic javax.servlet.ServletInputStream getInputStream()
throws java.io.IOException
getInputStream in interface javax.servlet.ServletRequestgetInputStream in class javax.servlet.ServletRequestWrapperjava.io.IOExceptionpublic java.io.BufferedReader getReader()
throws java.io.IOException
getReader in interface javax.servlet.ServletRequestgetReader in class javax.servlet.ServletRequestWrapperjava.io.IOExceptionpublic java.lang.String getRealPath(java.lang.String path)
getRealPath in interface javax.servlet.ServletRequestgetRealPath in class javax.servlet.ServletRequestWrapperpublic AtmosphereRequest headers(java.util.Map<java.lang.String,java.lang.String> headers)
headers - public AtmosphereRequest header(java.lang.String name, java.lang.String value)
name - value - public AtmosphereRequest queryString(java.lang.String qs)
qs - public java.util.Map<java.lang.String,java.lang.String> headersMap()
public java.util.Map<java.lang.String,java.lang.String[]> queryStringsMap()
public AtmosphereRequest method(java.lang.String m)
public AtmosphereRequest contentType(java.lang.String m)
public AtmosphereRequest body(java.lang.String body)
public AtmosphereRequest body(byte[] bytes)
public AtmosphereRequest body(java.io.InputStream body)
public AtmosphereRequest body(java.io.Reader body)
public AtmosphereRequest.Body body()
public AtmosphereRequest servletPath(java.lang.String servletPath)
public AtmosphereRequest contextPath(java.lang.String contextPath)
public AtmosphereRequest requestURI(java.lang.String requestURI)
public void setAttribute(java.lang.String s,
java.lang.Object o)
setAttribute in interface javax.servlet.ServletRequestsetAttribute in class javax.servlet.ServletRequestWrapperpublic void setCharacterEncoding(java.lang.String env)
throws java.io.UnsupportedEncodingException
setCharacterEncoding in interface javax.servlet.ServletRequestsetCharacterEncoding in class javax.servlet.ServletRequestWrapperjava.io.UnsupportedEncodingExceptionpublic javax.servlet.AsyncContext startAsync()
startAsync in interface javax.servlet.ServletRequeststartAsync in class javax.servlet.ServletRequestWrapperpublic javax.servlet.AsyncContext startAsync(javax.servlet.ServletRequest request,
javax.servlet.ServletResponse response)
startAsync in interface javax.servlet.ServletRequeststartAsync in class javax.servlet.ServletRequestWrapperpublic javax.servlet.AsyncContext getAsyncContext()
getAsyncContext in interface javax.servlet.ServletRequestgetAsyncContext in class javax.servlet.ServletRequestWrapperpublic java.lang.Object getAttribute(java.lang.String s)
getAttribute in interface javax.servlet.ServletRequestgetAttribute in class javax.servlet.ServletRequestWrapperpublic void removeAttribute(java.lang.String name)
removeAttribute in interface javax.servlet.ServletRequestremoveAttribute in class javax.servlet.ServletRequestWrapperpublic java.util.Map<java.lang.String,java.lang.Object> attributes()
localAttributes()public javax.servlet.http.HttpSession getSession()
getSession in interface javax.servlet.http.HttpServletRequestgetSession in class javax.servlet.http.HttpServletRequestWrapperpublic javax.servlet.http.HttpSession getSession(boolean create)
getSession in interface javax.servlet.http.HttpServletRequestgetSession in class javax.servlet.http.HttpServletRequestWrapperpublic java.security.Principal getUserPrincipal()
getUserPrincipal in interface javax.servlet.http.HttpServletRequestgetUserPrincipal in class javax.servlet.http.HttpServletRequestWrapperpublic boolean isRequestedSessionIdFromCookie()
isRequestedSessionIdFromCookie in interface javax.servlet.http.HttpServletRequestisRequestedSessionIdFromCookie in class javax.servlet.http.HttpServletRequestWrapperpublic boolean isRequestedSessionIdFromUrl()
isRequestedSessionIdFromUrl in interface javax.servlet.http.HttpServletRequestisRequestedSessionIdFromUrl in class javax.servlet.http.HttpServletRequestWrapperpublic boolean isRequestedSessionIdFromURL()
isRequestedSessionIdFromURL in interface javax.servlet.http.HttpServletRequestisRequestedSessionIdFromURL in class javax.servlet.http.HttpServletRequestWrapperpublic boolean isRequestedSessionIdValid()
isRequestedSessionIdValid in interface javax.servlet.http.HttpServletRequestisRequestedSessionIdValid in class javax.servlet.http.HttpServletRequestWrapperpublic boolean isUserInRole(java.lang.String role)
isUserInRole in interface javax.servlet.http.HttpServletRequestisUserInRole in class javax.servlet.http.HttpServletRequestWrapperpublic void login(java.lang.String username,
java.lang.String password)
throws javax.servlet.ServletException
login in interface javax.servlet.http.HttpServletRequestlogin in class javax.servlet.http.HttpServletRequestWrapperjavax.servlet.ServletExceptionpublic void logout()
throws javax.servlet.ServletException
logout in interface javax.servlet.http.HttpServletRequestlogout in class javax.servlet.http.HttpServletRequestWrapperjavax.servlet.ServletExceptionpublic java.lang.String getRemoteAddr()
getRemoteAddr in interface javax.servlet.ServletRequestgetRemoteAddr in class javax.servlet.ServletRequestWrapperpublic java.lang.String getRemoteHost()
getRemoteHost in interface javax.servlet.ServletRequestgetRemoteHost in class javax.servlet.ServletRequestWrapperpublic int getRemotePort()
getRemotePort in interface javax.servlet.ServletRequestgetRemotePort in class javax.servlet.ServletRequestWrapperpublic javax.servlet.RequestDispatcher getRequestDispatcher(java.lang.String path)
getRequestDispatcher in interface javax.servlet.ServletRequestgetRequestDispatcher in class javax.servlet.ServletRequestWrapperpublic java.lang.String getScheme()
getScheme in interface javax.servlet.ServletRequestgetScheme in class javax.servlet.ServletRequestWrapperpublic java.lang.String getServerName()
getServerName in interface javax.servlet.ServletRequestgetServerName in class javax.servlet.ServletRequestWrapperpublic int getServerPort()
getServerPort in interface javax.servlet.ServletRequestgetServerPort in class javax.servlet.ServletRequestWrapperpublic javax.servlet.ServletContext getServletContext()
getServletContext in interface javax.servlet.ServletRequestgetServletContext in class javax.servlet.ServletRequestWrapperpublic boolean isAsyncStarted()
isAsyncStarted in interface javax.servlet.ServletRequestisAsyncStarted in class javax.servlet.ServletRequestWrapperpublic boolean isAsyncSupported()
isAsyncSupported in interface javax.servlet.ServletRequestisAsyncSupported in class javax.servlet.ServletRequestWrapperpublic boolean isSecure()
isSecure in interface javax.servlet.ServletRequestisSecure in class javax.servlet.ServletRequestWrapperpublic java.lang.String getLocalName()
getLocalName in interface javax.servlet.ServletRequestgetLocalName in class javax.servlet.ServletRequestWrapperpublic int getLocalPort()
getLocalPort in interface javax.servlet.ServletRequestgetLocalPort in class javax.servlet.ServletRequestWrapperpublic java.lang.String getLocalAddr()
getLocalAddr in interface javax.servlet.ServletRequestgetLocalAddr in class javax.servlet.ServletRequestWrapperpublic java.util.Locale getLocale()
getLocale in interface javax.servlet.ServletRequestgetLocale in class javax.servlet.ServletRequestWrapperpublic AtmosphereResource resource()
AtmosphereResource associated with this request.AtmosphereResourcepublic java.util.Enumeration<java.util.Locale> getLocales()
getLocales in interface javax.servlet.ServletRequestgetLocales in class javax.servlet.ServletRequestWrapperpublic boolean dispatchRequestAsynchronously()
public boolean isDestroyable()
public AtmosphereRequest pathInfo(java.lang.String pathInfo)
public java.util.Enumeration<java.lang.String> getAttributeNames()
getAttributeNames in interface javax.servlet.ServletRequestgetAttributeNames in class javax.servlet.ServletRequestWrapperpublic java.util.Map<java.lang.String,java.lang.Object> localAttributes()
Mappublic java.lang.String getCharacterEncoding()
getCharacterEncoding in interface javax.servlet.ServletRequestgetCharacterEncoding in class javax.servlet.ServletRequestWrapperpublic int getContentLength()
getContentLength in interface javax.servlet.ServletRequestgetContentLength in class javax.servlet.ServletRequestWrapperpublic java.lang.String uuid()
AtmosphereResource.uuid(). May return "0" if no AtmosphereResource
is associated with this object.AtmosphereResource.uuid()public void destroy()
public void destroy(boolean force)
public void setRequest(javax.servlet.ServletRequest request)
setRequest in class javax.servlet.ServletRequestWrapperpublic static final AtmosphereRequest newInstance()
HttpServletRequest.HttpServletRequestpublic static final AtmosphereRequest wrap(javax.servlet.http.HttpServletRequest request)
HttpServletRequest.request - HttpServletRequestAtmosphereRequestpublic static final AtmosphereRequest cloneRequest(javax.servlet.http.HttpServletRequest request, boolean loadInMemory, boolean copySession, boolean isDestroyable, boolean createSession)
request - HttpServletRequestAtmosphereRequestpublic java.lang.String toString()
toString in class java.lang.Objectpublic java.lang.String requestURL()
Copyright © 2018. All Rights Reserved.