Interface AtmosphereResponse

  • All Superinterfaces:
    jakarta.servlet.http.HttpServletResponse, jakarta.servlet.ServletResponse
    All Known Implementing Classes:
    AtmosphereResponseImpl

    public interface AtmosphereResponse
    extends jakarta.servlet.http.HttpServletResponse
    An Atmosphere's response representation. An AtmosphereResponse can be used to construct a bi-directional asynchronous application. If the underlying transport is a WebSocket or if its associated AtmosphereResource has been suspended, this object can be used to write message back to the client at any moment.
    This object can delegate the write operation to AsyncIOWriter.
    Author:
    Jeanfrancois Arcand
    • Method Detail

      • destroy

        void destroy()
      • destroy

        void destroy​(boolean force)
      • destroyed

        boolean destroyed()
      • addCookie

        void addCookie​(jakarta.servlet.http.Cookie cookie)
        Specified by:
        addCookie in interface jakarta.servlet.http.HttpServletResponse
      • containsHeader

        boolean containsHeader​(java.lang.String name)
        Specified by:
        containsHeader in interface jakarta.servlet.http.HttpServletResponse
      • encodeURL

        java.lang.String encodeURL​(java.lang.String url)
        Specified by:
        encodeURL in interface jakarta.servlet.http.HttpServletResponse
      • encodeRedirectURL

        java.lang.String encodeRedirectURL​(java.lang.String url)
        Specified by:
        encodeRedirectURL in interface jakarta.servlet.http.HttpServletResponse
      • encodeUrl

        java.lang.String encodeUrl​(java.lang.String url)
        Specified by:
        encodeUrl in interface jakarta.servlet.http.HttpServletResponse
      • encodeRedirectUrl

        java.lang.String encodeRedirectUrl​(java.lang.String url)
        Specified by:
        encodeRedirectUrl in interface jakarta.servlet.http.HttpServletResponse
      • delegateToNativeResponse

        AtmosphereResponse delegateToNativeResponse​(boolean delegateToNativeResponse)
      • sendError

        void sendError​(int sc,
                       java.lang.String msg)
                throws java.io.IOException
        Specified by:
        sendError in interface jakarta.servlet.http.HttpServletResponse
        Throws:
        java.io.IOException
      • sendError

        void sendError​(int sc)
                throws java.io.IOException
        Specified by:
        sendError in interface jakarta.servlet.http.HttpServletResponse
        Throws:
        java.io.IOException
      • sendRedirect

        void sendRedirect​(java.lang.String location)
                   throws java.io.IOException
        Specified by:
        sendRedirect in interface jakarta.servlet.http.HttpServletResponse
        Throws:
        java.io.IOException
      • setDateHeader

        void setDateHeader​(java.lang.String name,
                           long date)
        Specified by:
        setDateHeader in interface jakarta.servlet.http.HttpServletResponse
      • addDateHeader

        void addDateHeader​(java.lang.String name,
                           long date)
        Specified by:
        addDateHeader in interface jakarta.servlet.http.HttpServletResponse
      • setHeader

        void setHeader​(java.lang.String name,
                       java.lang.String value)
        Specified by:
        setHeader in interface jakarta.servlet.http.HttpServletResponse
      • addHeader

        void addHeader​(java.lang.String name,
                       java.lang.String value)
        Specified by:
        addHeader in interface jakarta.servlet.http.HttpServletResponse
      • setIntHeader

        void setIntHeader​(java.lang.String name,
                          int value)
        Specified by:
        setIntHeader in interface jakarta.servlet.http.HttpServletResponse
      • addIntHeader

        void addIntHeader​(java.lang.String name,
                          int value)
        Specified by:
        addIntHeader in interface jakarta.servlet.http.HttpServletResponse
      • setStatus

        void setStatus​(int status)
        Specified by:
        setStatus in interface jakarta.servlet.http.HttpServletResponse
      • setStatus

        void setStatus​(int status,
                       java.lang.String statusMessage)
        Specified by:
        setStatus in interface jakarta.servlet.http.HttpServletResponse
      • getStatus

        int getStatus()
        Specified by:
        getStatus in interface jakarta.servlet.http.HttpServletResponse
      • getResponse

        jakarta.servlet.ServletResponse getResponse()
      • getStatusMessage

        java.lang.String getStatusMessage()
      • headers

        java.util.Map<java.lang.String,​java.lang.String> headers()
      • getHeader

        java.lang.String getHeader​(java.lang.String name)
        Specified by:
        getHeader in interface jakarta.servlet.http.HttpServletResponse
      • getHeaders

        java.util.Collection<java.lang.String> getHeaders​(java.lang.String name)
        Specified by:
        getHeaders in interface jakarta.servlet.http.HttpServletResponse
      • getHeaderNames

        java.util.Collection<java.lang.String> getHeaderNames()
        Specified by:
        getHeaderNames in interface jakarta.servlet.http.HttpServletResponse
      • setCharacterEncoding

        void setCharacterEncoding​(java.lang.String charSet)
        Specified by:
        setCharacterEncoding in interface jakarta.servlet.ServletResponse
      • flushBuffer

        void flushBuffer()
                  throws java.io.IOException
        Specified by:
        flushBuffer in interface jakarta.servlet.ServletResponse
        Throws:
        java.io.IOException
      • getBufferSize

        int getBufferSize()
        Specified by:
        getBufferSize in interface jakarta.servlet.ServletResponse
      • getCharacterEncoding

        java.lang.String getCharacterEncoding()
        Specified by:
        getCharacterEncoding in interface jakarta.servlet.ServletResponse
      • isDestroyable

        boolean isDestroyable()
        Check if this object can be destroyed. Default is true.
      • getOutputStream

        jakarta.servlet.ServletOutputStream getOutputStream()
                                                     throws java.io.IOException
        Specified by:
        getOutputStream in interface jakarta.servlet.ServletResponse
        Throws:
        java.io.IOException
      • getWriter

        java.io.PrintWriter getWriter()
                               throws java.io.IOException
        Specified by:
        getWriter in interface jakarta.servlet.ServletResponse
        Throws:
        java.io.IOException
      • setContentLength

        void setContentLength​(int len)
        Specified by:
        setContentLength in interface jakarta.servlet.ServletResponse
      • setContentType

        void setContentType​(java.lang.String contentType)
        Specified by:
        setContentType in interface jakarta.servlet.ServletResponse
      • getContentType

        java.lang.String getContentType()
        Specified by:
        getContentType in interface jakarta.servlet.ServletResponse
      • isCommitted

        boolean isCommitted()
        Specified by:
        isCommitted in interface jakarta.servlet.ServletResponse
      • reset

        void reset()
        Specified by:
        reset in interface jakarta.servlet.ServletResponse
      • resetBuffer

        void resetBuffer()
        Specified by:
        resetBuffer in interface jakarta.servlet.ServletResponse
      • setBufferSize

        void setBufferSize​(int size)
        Specified by:
        setBufferSize in interface jakarta.servlet.ServletResponse
      • setLocale

        void setLocale​(java.util.Locale locale)
        Specified by:
        setLocale in interface jakarta.servlet.ServletResponse
      • getLocale

        java.util.Locale getLocale()
        Specified by:
        getLocale in interface jakarta.servlet.ServletResponse
      • close

        void close()
            throws java.io.IOException
        Close the associated AsyncIOWriter.
        Throws:
        java.io.IOException
      • closeStreamOrWriter

        void closeStreamOrWriter()
        Close the associated PrintWriter or OutputStream
      • write

        AtmosphereResponse write​(java.lang.String data,
                                 boolean writeUsingOriginalResponse)
        Write the String by either using the PrintWriter or OutputStream. The decision is based on the request attribute ApplicationConfig.PROPERTY_USE_STREAM. If writeUsingOriginalResponse is set to true, execute the write without invoking the defined AsyncIOWriter.
        Parameters:
        data - the String to write
        writeUsingOriginalResponse - if true, execute the write without invoking the AsyncIOWriter
      • write

        AtmosphereResponse write​(byte[] data,
                                 boolean writeUsingOriginalResponse)
        Write the String by either using the PrintWriter or OutputStream. The decision is based on the request attribute ApplicationConfig.PROPERTY_USE_STREAM. If writeUsingOriginalResponse is set to true, execute the write without invoking the defined AsyncIOWriter.
        Parameters:
        data - the bytes to write
        writeUsingOriginalResponse - if true, execute the write without invoking the AsyncIOWriter
      • write

        AtmosphereResponse write​(byte[] data,
                                 int offset,
                                 int length)
        Write the bytes by either using the PrintWriter or OutputStream. The decision is based on the request attribute ApplicationConfig.PROPERTY_USE_STREAM.
        Parameters:
        data - the bytes to write
        offset - the first byte position to write
        length - the data length
      • write

        AtmosphereResponse write​(byte[] data,
                                 int offset,
                                 int length,
                                 boolean writeUsingOriginalResponse)
        Write the String by either using the PrintWriter or OutputStream. The decision is based on the request attribute ApplicationConfig.PROPERTY_USE_STREAM. If writeUsingOriginalResponse is set to true, execute the write without invoking the defined AsyncIOWriter.
        Parameters:
        data - the bytes to write
        offset - the first byte position to write
        length - the data length
        writeUsingOriginalResponse - if true, execute the write without invoking the AsyncIOWriter
      • setResponse

        void setResponse​(jakarta.servlet.ServletResponse response)
      • toString

        java.lang.String toString()
        Overrides:
        toString in class java.lang.Object