Module org.apache.wicket.core

Package org.apache.wicket.protocol.http

Class BufferedWebResponse

java.lang.Object

org.apache.wicket.request.Response

org.apache.wicket.request.http.WebResponse

org.apache.wicket.protocol.http.BufferedWebResponse

All Implemented Interfaces:

IMetaDataBufferingWebResponse

public class BufferedWebResponse
extends WebResponse
implements IMetaDataBufferingWebResponse

Subclass of WebResponse that buffers the actions and performs those on another response.

Author:

Matej Knopp

See Also:

• writeTo(WebResponse)

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.wicket.request.http.WebResponse

WebResponse.CacheScope

Field Summary

Fields inherited from class org.apache.wicket.request.http.WebResponse

MAX_CACHE_DURATION

Constructor Summary

Constructors

Constructor	Description
BufferedWebResponse(WebResponse originalResponse)	Construct.

Method Summary

Modifier and Type	Method	Description
void	addCookie(jakarta.servlet.http.Cookie cookie)	Add a cookie to the web response
void	addHeader(String name, String value)	Add a value to the servlet response stream.
void	clearCookie(jakarta.servlet.http.Cookie cookie)	Convenience method for clearing a cookie.
void	disableCaching()	Make this response non-cacheable
String	encodeRedirectURL(CharSequence url)	Encodes urls used to redirect.
String	encodeURL(CharSequence url)	Encodes the specified URL by including the session ID in it, or, if encoding is not needed, returns the URL unchanged.
void	flush()	Flushes the response.
Object	getContainerResponse()	Provides access to the low-level container response object that implementaion of this Response delegate to.
CharSequence	getText()	Returns the text already written to this response.
boolean	isHeaderSupported()	Indicates if the response supports setting headers.
boolean	isRedirect()
void	reset()	Called when the Response needs to reset itself.
void	sendError(int sc, String msg)	Send error status code with optional message.
void	sendRedirect(String url)	Redirects the response to specified URL.
void	setContentLength(long length)	Set the content length on the response, if appropriate in the subclass.
void	setContentType(String mimeType)	Set the content type on the response, if appropriate in the subclass.
void	setDateHeader(String name, Instant date)	Set a header to the date value in the servlet response stream.
void	setHeader(String name, String value)	Set a header to the string value in the servlet response stream.
void	setStatus(int sc)	Sets the status code for this response.
void	setText(CharSequence text)	Replaces the text in this response
String	toString()
void	write(byte[] array)	Writes the buffer to output.
void	write(byte[] array, int offset, int length)	Writes the buffer to output.
void	write(CharSequence sequence)	Writes the CharSequence to output.
void	writeMetaData(WebResponse response)	transfer cookie operations (add, clear) to given web response
void	writeTo(WebResponse response)	Writes the content of the buffer to the specified response.

Methods inherited from class org.apache.wicket.request.http.WebResponse

enableCaching, setAcceptRange, setAttachmentHeader, setContentRange, setInlineHeader, setLastModifiedTime

Methods inherited from class org.apache.wicket.request.Response

close, getOutputStream

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

BufferedWebResponse

public BufferedWebResponse(WebResponse originalResponse)

Construct.

Parameters:

originalResponse -

Method Details

writeMetaData

public void writeMetaData(WebResponse response)

transfer cookie operations (add, clear) to given web response

Specified by:

writeMetaData in interface IMetaDataBufferingWebResponse

Parameters:

response - web response that should receive the current cookie operation

encodeURL

public String encodeURL(CharSequence url)

Description copied from class: Response

Encodes the specified URL by including the session ID in it, or, if encoding is not needed, returns the URL unchanged.

Specified by:

encodeURL in class Response

Returns:

encoded URL

encodeRedirectURL

public String encodeRedirectURL(CharSequence url)

Description copied from class: WebResponse

Encodes urls used to redirect. Sometimes rules for encoding URLs for redirecting differ from encoding URLs for links, so this method is broken out away form Response.encodeURL(CharSequence).

Specified by:

encodeRedirectURL in class WebResponse

Returns:

encoded URL

reset

public void reset()

Description copied from class: Response

Called when the Response needs to reset itself. Subclasses can empty there buffer or build up state.

Overrides:

reset in class Response

addCookie

public void addCookie(jakarta.servlet.http.Cookie cookie)

Description copied from class: WebResponse

Add a cookie to the web response

Specified by:

addCookie in class WebResponse

clearCookie

public void clearCookie(jakarta.servlet.http.Cookie cookie)

Description copied from class: WebResponse

Convenience method for clearing a cookie.

Specified by:

clearCookie in class WebResponse

Parameters:

cookie - The cookie to set

See Also:

• WebResponse.addCookie(Cookie)

setContentLength

public void setContentLength(long length)

Description copied from class: WebResponse

Set the content length on the response, if appropriate in the subclass. This default implementation does nothing.

Specified by:

setContentLength in class WebResponse

Parameters:

length - The length of the content

setContentType

public void setContentType(String mimeType)

Description copied from class: WebResponse

Set the content type on the response, if appropriate in the subclass. This default implementation does nothing.

Specified by:

setContentType in class WebResponse

Parameters:

mimeType - The mime type

setDateHeader

public void setDateHeader(String name,
 Instant date)

Description copied from class: WebResponse

Set a header to the date value in the servlet response stream.

Specified by:

setDateHeader in class WebResponse

isHeaderSupported

public boolean isHeaderSupported()

Description copied from class: WebResponse

Indicates if the response supports setting headers. When this method returns false, WebResponse.setHeader(String, String) and its variations will thrown an UnsupportedOperationException.

Specified by:

isHeaderSupported in class WebResponse

Returns:

True when this WebResponse supports setting headers.

setHeader

public void setHeader(String name,
 String value)

Description copied from class: WebResponse

Set a header to the string value in the servlet response stream.

Specified by:

setHeader in class WebResponse

addHeader

public void addHeader(String name,
 String value)

Description copied from class: WebResponse

Add a value to the servlet response stream.

Specified by:

addHeader in class WebResponse

disableCaching

public void disableCaching()

Description copied from class: WebResponse

Make this response non-cacheable

Overrides:

disableCaching in class WebResponse

write

public void write(CharSequence sequence)

Description copied from class: Response

Writes the CharSequence to output.

Specified by:

write in class Response

getText

public CharSequence getText()

Returns the text already written to this response.

Returns:

text

setText

public void setText(CharSequence text)

Replaces the text in this response

Parameters:

text -

write

public void write(byte[] array)

Description copied from class: Response

Writes the buffer to output.

Specified by:

write in class Response

Parameters:

array - the data.

write

public void write(byte[] array,
 int offset,
 int length)

Description copied from class: Response

Writes the buffer to output.

Specified by:

write in class Response

Parameters:

array - the data.

offset - the start offset in the data.

length - the number of bytes to write.

sendRedirect

public void sendRedirect(String url)

Description copied from class: WebResponse

Redirects the response to specified URL. The implementation is responsible for properly encoding the URL. Implementations of this method should run passed in url parameters through the WebResponse.encodeRedirectURL(CharSequence) method.

Specified by:

sendRedirect in class WebResponse

setStatus

public void setStatus(int sc)

Description copied from class: WebResponse

Sets the status code for this response.

Specified by:

setStatus in class WebResponse

Parameters:

sc - status code

sendError

public void sendError(int sc,
 String msg)

Description copied from class: WebResponse

Send error status code with optional message.

Specified by:

sendError in class WebResponse

writeTo

public void writeTo(WebResponse response)

Writes the content of the buffer to the specified response. Also sets the properties and and headers.

Parameters:

response -

isRedirect

public boolean isRedirect()

Specified by:

isRedirect in class WebResponse

Returns:

true is WebResponse.sendRedirect(String) was called, false otherwise.

flush

public void flush()

Description copied from class: WebResponse

Flushes the response.

Specified by:

flush in class WebResponse

toString

public String toString()

Overrides:

toString in class Object

See Also:

• Object.toString()

getContainerResponse

public Object getContainerResponse()

Description copied from class: Response

Provides access to the low-level container response object that implementaion of this Response delegate to. This allows users to access features provided by the container response but not by generalized Wicket Response objects.

Specified by:

getContainerResponse in class Response

Returns:

low-level container response object, or null if none