org.atmosphere.cpr

Interface AtmosphereRequest

All Superinterfaces:

javax.servlet.http.HttpServletRequest, javax.servlet.ServletRequest

All Known Implementing Classes:

AtmosphereRequestImpl

public interface AtmosphereRequest
extends javax.servlet.http.HttpServletRequest

An Atmosphere request representation. An AtmosphereRequest is a two-way communication channel between the client and the server. If the AtmosphereRequestImpl.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.

Author:

Jeanfrancois Arcand

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	AtmosphereRequest.Builder
static class	AtmosphereRequest.LocalAttributes

Field Summary

Fields inherited from interface javax.servlet.http.HttpServletRequest

BASIC_AUTH, CLIENT_CERT_AUTH, DIGEST_AUTH, FORM_AUTH

Method Summary

Modifier and Type	Method and Description
AtmosphereRequest.LocalAttributes	attributes() Deprecated. Use localAttributes()
boolean	authenticate(javax.servlet.http.HttpServletResponse response)
AtmosphereRequestImpl.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)
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)
AtmosphereRequest.LocalAttributes	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)
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().
javax.servlet.http.HttpServletRequest	wrappedRequest()

Method Detail

destroyed

boolean destroyed()

destroyable

AtmosphereRequest destroyable(boolean destroyable)

getPathInfo

java.lang.String getPathInfo()

Specified by:

getPathInfo in interface javax.servlet.http.HttpServletRequest

getPathTranslated

java.lang.String getPathTranslated()

Specified by:

getPathTranslated in interface javax.servlet.http.HttpServletRequest

getQueryString

java.lang.String getQueryString()

Specified by:

getQueryString in interface javax.servlet.http.HttpServletRequest

getRemoteUser

java.lang.String getRemoteUser()

Specified by:

getRemoteUser in interface javax.servlet.http.HttpServletRequest

getRequestedSessionId

java.lang.String getRequestedSessionId()

Specified by:

getRequestedSessionId in interface javax.servlet.http.HttpServletRequest

getMethod

java.lang.String getMethod()

Specified by:

getMethod in interface javax.servlet.http.HttpServletRequest

getPart

javax.servlet.http.Part getPart(java.lang.String name)
                         throws java.io.IOException,
                                javax.servlet.ServletException

Specified by:

getPart in interface javax.servlet.http.HttpServletRequest

Throws:

java.io.IOException

javax.servlet.ServletException

getParts

java.util.Collection<javax.servlet.http.Part> getParts()
                                                throws java.io.IOException,
                                                       javax.servlet.ServletException

Specified by:

getParts in interface javax.servlet.http.HttpServletRequest

Throws:

java.io.IOException

javax.servlet.ServletException

getContentType

java.lang.String getContentType()

Specified by:

getContentType in interface javax.servlet.ServletRequest

getDispatcherType

javax.servlet.DispatcherType getDispatcherType()

Specified by:

getDispatcherType in interface javax.servlet.ServletRequest

getServletPath

java.lang.String getServletPath()

Specified by:

getServletPath in interface javax.servlet.http.HttpServletRequest

getRequestURI

java.lang.String getRequestURI()

Specified by:

getRequestURI in interface javax.servlet.http.HttpServletRequest

getRequestURL

java.lang.StringBuffer getRequestURL()

Specified by:

getRequestURL in interface javax.servlet.http.HttpServletRequest

getHeaders

java.util.Enumeration getHeaders(java.lang.String name)

Specified by:

getHeaders in interface javax.servlet.http.HttpServletRequest

getIntHeader

int getIntHeader(java.lang.String name)

Specified by:

getIntHeader in interface javax.servlet.http.HttpServletRequest

getHeaderNames

java.util.Enumeration<java.lang.String> getHeaderNames()

Specified by:

getHeaderNames in interface javax.servlet.http.HttpServletRequest

authenticate

boolean authenticate(javax.servlet.http.HttpServletResponse response)
              throws java.io.IOException,
                     javax.servlet.ServletException

Specified by:

authenticate in interface javax.servlet.http.HttpServletRequest

Throws:

java.io.IOException

javax.servlet.ServletException

getAuthType

java.lang.String getAuthType()

Specified by:

getAuthType in interface javax.servlet.http.HttpServletRequest

getContextPath

java.lang.String getContextPath()

Specified by:

getContextPath in interface javax.servlet.http.HttpServletRequest

getCookies

javax.servlet.http.Cookie[] getCookies()

Specified by:

getCookies in interface javax.servlet.http.HttpServletRequest

getDateHeader

long getDateHeader(java.lang.String name)

Specified by:

getDateHeader in interface javax.servlet.http.HttpServletRequest

getHeader

java.lang.String getHeader(java.lang.String s)

Specified by:

getHeader in interface javax.servlet.http.HttpServletRequest

wrappedRequest

javax.servlet.http.HttpServletRequest wrappedRequest()

getHeader

java.lang.String getHeader(java.lang.String s,
                           boolean checkCase)

getParameter

java.lang.String getParameter(java.lang.String s)

Specified by:

getParameter in interface javax.servlet.ServletRequest

getParameterMap

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

Specified by:

getParameterMap in interface javax.servlet.ServletRequest

getParameterNames

java.util.Enumeration<java.lang.String> getParameterNames()

Specified by:

getParameterNames in interface javax.servlet.ServletRequest

getParameterValues

java.lang.String[] getParameterValues(java.lang.String s)

Specified by:

getParameterValues in interface javax.servlet.ServletRequest

getProtocol

java.lang.String getProtocol()

Specified by:

getProtocol in interface javax.servlet.ServletRequest

getInputStream

javax.servlet.ServletInputStream getInputStream()
                                         throws java.io.IOException

Specified by:

getInputStream in interface javax.servlet.ServletRequest

Throws:

java.io.IOException

getReader

java.io.BufferedReader getReader()
                          throws java.io.IOException

Specified by:

getReader in interface javax.servlet.ServletRequest

Throws:

java.io.IOException

getRealPath

java.lang.String getRealPath(java.lang.String path)

Specified by:

getRealPath in interface javax.servlet.ServletRequest

headers

AtmosphereRequest headers(java.util.Map<java.lang.String,java.lang.String> headers)

Add all headers contained within the Map.

Parameters:

headers -

Returns:

this;

header

AtmosphereRequest header(java.lang.String name,
                         java.lang.String value)

Add a header.

Parameters:

name -

value -

Returns:

this

queryString

AtmosphereRequest queryString(java.lang.String qs)

Set the query string.

Parameters:

qs -

Returns:

this

headersMap

java.util.Map<java.lang.String,java.lang.String> headersMap()

queryStringsMap

java.util.Map<java.lang.String,java.lang.String[]> queryStringsMap()

method

AtmosphereRequest method(java.lang.String m)

contentType

AtmosphereRequest contentType(java.lang.String m)

body

AtmosphereRequest body(java.lang.String body)

body

AtmosphereRequest body(byte[] bytes)

body

AtmosphereRequest body(java.io.InputStream body)

body

AtmosphereRequest body(java.io.Reader body)

body

AtmosphereRequestImpl.Body body()

Return the request's body. This method will return an empty Body if the underlying container or framework is using InputStream or Reader.

Returns:

the request body;

servletPath

AtmosphereRequest servletPath(java.lang.String servletPath)

contextPath

AtmosphereRequest contextPath(java.lang.String contextPath)

requestURI

AtmosphereRequest requestURI(java.lang.String requestURI)

setAttribute

void setAttribute(java.lang.String s,
                  java.lang.Object o)

Specified by:

setAttribute in interface javax.servlet.ServletRequest

setCharacterEncoding

void setCharacterEncoding(java.lang.String env)
                   throws java.io.UnsupportedEncodingException

Specified by:

setCharacterEncoding in interface javax.servlet.ServletRequest

Throws:

java.io.UnsupportedEncodingException

startAsync

javax.servlet.AsyncContext startAsync()

Specified by:

startAsync in interface javax.servlet.ServletRequest

startAsync

javax.servlet.AsyncContext startAsync(javax.servlet.ServletRequest request,
                                      javax.servlet.ServletResponse response)

Specified by:

startAsync in interface javax.servlet.ServletRequest

getAsyncContext

javax.servlet.AsyncContext getAsyncContext()

Specified by:

getAsyncContext in interface javax.servlet.ServletRequest

getAttribute

java.lang.Object getAttribute(java.lang.String s)

Specified by:

getAttribute in interface javax.servlet.ServletRequest

removeAttribute

void removeAttribute(java.lang.String name)

Specified by:

removeAttribute in interface javax.servlet.ServletRequest

attributes

AtmosphereRequest.LocalAttributes attributes()

Deprecated. Use localAttributes()

Return the locally added attributes.

Returns:

the locally added attributes

getSession

javax.servlet.http.HttpSession getSession()

Specified by:

getSession in interface javax.servlet.http.HttpServletRequest

getSession

javax.servlet.http.HttpSession getSession(boolean create)

Specified by:

getSession in interface javax.servlet.http.HttpServletRequest

getUserPrincipal

java.security.Principal getUserPrincipal()

Specified by:

getUserPrincipal in interface javax.servlet.http.HttpServletRequest

isRequestedSessionIdFromCookie

boolean isRequestedSessionIdFromCookie()

Specified by:

isRequestedSessionIdFromCookie in interface javax.servlet.http.HttpServletRequest

isRequestedSessionIdFromUrl

boolean isRequestedSessionIdFromUrl()

Specified by:

isRequestedSessionIdFromUrl in interface javax.servlet.http.HttpServletRequest

isRequestedSessionIdFromURL

boolean isRequestedSessionIdFromURL()

Specified by:

isRequestedSessionIdFromURL in interface javax.servlet.http.HttpServletRequest

isRequestedSessionIdValid

boolean isRequestedSessionIdValid()

Specified by:

isRequestedSessionIdValid in interface javax.servlet.http.HttpServletRequest

isUserInRole

boolean isUserInRole(java.lang.String role)

Specified by:

isUserInRole in interface javax.servlet.http.HttpServletRequest

login

void login(java.lang.String username,
           java.lang.String password)
    throws javax.servlet.ServletException

Specified by:

login in interface javax.servlet.http.HttpServletRequest

Throws:

javax.servlet.ServletException

logout

void logout()
     throws javax.servlet.ServletException

Specified by:

logout in interface javax.servlet.http.HttpServletRequest

Throws:

javax.servlet.ServletException

getRemoteAddr

java.lang.String getRemoteAddr()

Specified by:

getRemoteAddr in interface javax.servlet.ServletRequest

getRemoteHost

java.lang.String getRemoteHost()

Specified by:

getRemoteHost in interface javax.servlet.ServletRequest

getRemotePort

int getRemotePort()

Specified by:

getRemotePort in interface javax.servlet.ServletRequest

getRequestDispatcher

javax.servlet.RequestDispatcher getRequestDispatcher(java.lang.String path)

Specified by:

getRequestDispatcher in interface javax.servlet.ServletRequest

getScheme

java.lang.String getScheme()

Specified by:

getScheme in interface javax.servlet.ServletRequest

getServerName

java.lang.String getServerName()

Specified by:

getServerName in interface javax.servlet.ServletRequest

getServerPort

int getServerPort()

Specified by:

getServerPort in interface javax.servlet.ServletRequest

getServletContext

javax.servlet.ServletContext getServletContext()

Specified by:

getServletContext in interface javax.servlet.ServletRequest

isAsyncStarted

boolean isAsyncStarted()

Specified by:

isAsyncStarted in interface javax.servlet.ServletRequest

isAsyncSupported

boolean isAsyncSupported()

Specified by:

isAsyncSupported in interface javax.servlet.ServletRequest

isSecure

boolean isSecure()

Specified by:

isSecure in interface javax.servlet.ServletRequest

getLocalName

java.lang.String getLocalName()

Specified by:

getLocalName in interface javax.servlet.ServletRequest

getLocalPort

int getLocalPort()

Specified by:

getLocalPort in interface javax.servlet.ServletRequest

getLocalAddr

java.lang.String getLocalAddr()

Specified by:

getLocalAddr in interface javax.servlet.ServletRequest

getLocale

java.util.Locale getLocale()

Specified by:

getLocale in interface javax.servlet.ServletRequest

resource

AtmosphereResource resource()

The AtmosphereResource associated with this request.

Returns:

an AtmosphereResource

getLocales

java.util.Enumeration<java.util.Locale> getLocales()

Specified by:

getLocales in interface javax.servlet.ServletRequest

dispatchRequestAsynchronously

boolean dispatchRequestAsynchronously()

Dispatch the request asynchronously to container. The default is false.

Returns:

true to dispatch the request asynchronously to container.

isDestroyable

boolean isDestroyable()

Cjeck if this object can be destroyed. Default is true.

pathInfo

AtmosphereRequest pathInfo(java.lang.String pathInfo)

getAttributeNames

java.util.Enumeration<java.lang.String> getAttributeNames()

Specified by:

getAttributeNames in interface javax.servlet.ServletRequest

localAttributes

AtmosphereRequest.LocalAttributes localAttributes()

Return a subset of the attributes set on this AtmosphereRequest, set locally by the framework or by an application. Attributes added using this method won't be propagated to the original, container-only, native request object.

Returns:

a

getCharacterEncoding

java.lang.String getCharacterEncoding()

Specified by:

getCharacterEncoding in interface javax.servlet.ServletRequest

getContentLength

int getContentLength()

Specified by:

getContentLength in interface javax.servlet.ServletRequest

uuid

java.lang.String uuid()

Return the underlying AtmosphereResource.uuid(). May return "0" if no AtmosphereResource is associated with this object.

Returns:

the underlying AtmosphereResource.uuid()

destroy

void destroy()

destroy

void destroy(boolean force)

setRequest

void setRequest(javax.servlet.ServletRequest request)

toString

java.lang.String toString()

Overrides:

toString in class java.lang.Object

requestURL

java.lang.String requestURL()