Package 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

    • Method Detail

      • destroyed

        boolean destroyed()

      • 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()

      • 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;

      • 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

      • 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

      • 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.

      • 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

      • 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()