org.springframework.mock.web
Class MockHttpServletResponse

java.lang.Object
  org.springframework.mock.web.MockHttpServletResponse

public class MockHttpServletResponse
extends java.lang.Object

Mock implementation of the javax.servlet.http.HttpServletResponse interface. Supports the Servlet 2.5 API level.

Used for testing the web framework; also useful for testing application controllers.

Since:

1.0.2

Author:

Juergen Hoeller, Rod Johnson

Nested Class Summary

private class	MockHttpServletResponse.ResponsePrintWriter Inner class that adapts the PrintWriter to mark the response as committed once the buffer size is exceeded.
private class	MockHttpServletResponse.ResponseServletOutputStream Inner class that adapts the ServletOutputStream to mark the response as committed once the buffer size is exceeded.

Field Summary

private int	bufferSize
private java.lang.String	characterEncoding
private static java.lang.String	CHARSET_PREFIX
private boolean	committed
private java.io.ByteArrayOutputStream	content
private int	contentLength
private java.lang.String	contentType
private java.util.List<Cookie>	cookies
static int	DEFAULT_SERVER_PORT
private java.lang.String	errorMessage
private java.lang.String	forwardedUrl
private java.util.Map<java.lang.String,HeaderValueHolder>	headers
private java.util.List<java.lang.String>	includedUrls
private java.util.Locale	locale
private ServletOutputStream	outputStream
private boolean	outputStreamAccessAllowed
private java.lang.String	redirectedUrl
private int	status
private java.io.PrintWriter	writer
private boolean	writerAccessAllowed

Constructor Summary

MockHttpServletResponse()

Method Summary

void	addCookie(Cookie cookie)
void	addDateHeader(java.lang.String name, long value)
void	addHeader(java.lang.String name, java.lang.String value)
private void	addHeaderValue(java.lang.String name, java.lang.Object value)
void	addIncludedUrl(java.lang.String includedUrl)
void	addIntHeader(java.lang.String name, int value)
boolean	containsHeader(java.lang.String name)
private void	doAddHeaderValue(java.lang.String name, java.lang.Object value, boolean replace)
java.lang.String	encodeRedirectUrl(java.lang.String url)
java.lang.String	encodeRedirectURL(java.lang.String url) The default implementation delegates to encodeURL(java.lang.String), returning the given URL String as-is.
java.lang.String	encodeUrl(java.lang.String url)
java.lang.String	encodeURL(java.lang.String url) The default implementation returns the given URL String as-is.
void	flushBuffer()
int	getBufferSize()
java.lang.String	getCharacterEncoding()
byte[]	getContentAsByteArray()
java.lang.String	getContentAsString()
int	getContentLength()
java.lang.String	getContentType()
Cookie	getCookie(java.lang.String name)
Cookie[]	getCookies()
java.lang.String	getErrorMessage()
java.lang.String	getForwardedUrl()
java.lang.Object	getHeader(java.lang.String name) Return the primary value for the given header, if any.
java.util.Set<java.lang.String>	getHeaderNames() Return the names of all specified headers as a Set of Strings.
java.util.List<java.lang.Object>	getHeaders(java.lang.String name) Return all values for the given header as a List of value objects.
java.lang.String	getIncludedUrl()
java.util.List<java.lang.String>	getIncludedUrls()
java.util.Locale	getLocale()
ServletOutputStream	getOutputStream()
java.lang.String	getRedirectedUrl()
int	getStatus()
java.io.PrintWriter	getWriter()
boolean	isCommitted()
boolean	isOutputStreamAccessAllowed() Return whether getOutputStream() access is allowed.
boolean	isWriterAccessAllowed() Return whether getOutputStream() access is allowed.
void	reset()
void	resetBuffer()
void	sendError(int status)
void	sendError(int status, java.lang.String errorMessage)
void	sendRedirect(java.lang.String url)
void	setBufferSize(int bufferSize)
void	setCharacterEncoding(java.lang.String characterEncoding)
void	setCommitted(boolean committed)
private void	setCommittedIfBufferSizeExceeded()
void	setContentLength(int contentLength)
void	setContentType(java.lang.String contentType)
void	setDateHeader(java.lang.String name, long value)
void	setForwardedUrl(java.lang.String forwardedUrl)
void	setHeader(java.lang.String name, java.lang.String value)
private void	setHeaderValue(java.lang.String name, java.lang.Object value)
void	setIncludedUrl(java.lang.String includedUrl)
void	setIntHeader(java.lang.String name, int value)
void	setLocale(java.util.Locale locale)
void	setOutputStreamAccessAllowed(boolean outputStreamAccessAllowed) Set whether getOutputStream() access is allowed.
void	setStatus(int status)
void	setStatus(int status, java.lang.String errorMessage)
void	setWriterAccessAllowed(boolean writerAccessAllowed) Set whether getWriter() access is allowed.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SERVER_PORT

public static final int DEFAULT_SERVER_PORT

See Also:

Constant Field Values

CHARSET_PREFIX

private static final java.lang.String CHARSET_PREFIX

See Also:

Constant Field Values

outputStreamAccessAllowed

private boolean outputStreamAccessAllowed

writerAccessAllowed

private boolean writerAccessAllowed

characterEncoding

private java.lang.String characterEncoding

content

private final java.io.ByteArrayOutputStream content

outputStream

private final ServletOutputStream outputStream

writer

private java.io.PrintWriter writer

contentLength

private int contentLength

contentType

private java.lang.String contentType

bufferSize

private int bufferSize

committed

private boolean committed

locale

private java.util.Locale locale

cookies

private final java.util.List<Cookie> cookies

headers

private final java.util.Map<java.lang.String,HeaderValueHolder> headers

status

private int status

errorMessage

private java.lang.String errorMessage

redirectedUrl

private java.lang.String redirectedUrl

forwardedUrl

private java.lang.String forwardedUrl

includedUrls

private final java.util.List<java.lang.String> includedUrls

Constructor Detail

MockHttpServletResponse

public MockHttpServletResponse()

Method Detail

setOutputStreamAccessAllowed

public void setOutputStreamAccessAllowed(boolean outputStreamAccessAllowed)

Set whether getOutputStream() access is allowed.

Default is true.

isOutputStreamAccessAllowed

public boolean isOutputStreamAccessAllowed()

Return whether getOutputStream() access is allowed.

setWriterAccessAllowed

public void setWriterAccessAllowed(boolean writerAccessAllowed)

Set whether getWriter() access is allowed.

Default is true.

isWriterAccessAllowed

public boolean isWriterAccessAllowed()

Return whether getOutputStream() access is allowed.

setCharacterEncoding

public void setCharacterEncoding(java.lang.String characterEncoding)

getCharacterEncoding

public java.lang.String getCharacterEncoding()

getOutputStream

public ServletOutputStream getOutputStream()

getWriter

public java.io.PrintWriter getWriter()
                              throws java.io.UnsupportedEncodingException

Throws:

java.io.UnsupportedEncodingException

getContentAsByteArray

public byte[] getContentAsByteArray()

getContentAsString

public java.lang.String getContentAsString()
                                    throws java.io.UnsupportedEncodingException

Throws:

java.io.UnsupportedEncodingException

setContentLength

public void setContentLength(int contentLength)

getContentLength

public int getContentLength()

setContentType

public void setContentType(java.lang.String contentType)

getContentType

public java.lang.String getContentType()

setBufferSize

public void setBufferSize(int bufferSize)

getBufferSize

public int getBufferSize()

flushBuffer

public void flushBuffer()

resetBuffer

public void resetBuffer()

setCommittedIfBufferSizeExceeded

private void setCommittedIfBufferSizeExceeded()

setCommitted

public void setCommitted(boolean committed)

isCommitted

public boolean isCommitted()

reset

public void reset()

setLocale

public void setLocale(java.util.Locale locale)

getLocale

public java.util.Locale getLocale()

addCookie

public void addCookie(Cookie cookie)

getCookies

public Cookie[] getCookies()

getCookie

public Cookie getCookie(java.lang.String name)

containsHeader

public boolean containsHeader(java.lang.String name)

getHeaderNames

public java.util.Set<java.lang.String> getHeaderNames()

Return the names of all specified headers as a Set of Strings.

Returns:

the Set of header name Strings, or an empty Set if none

getHeader

public java.lang.Object getHeader(java.lang.String name)

Return the primary value for the given header, if any.

Will return the first value in case of multiple values.

Parameters:

name - the name of the header

Returns:

the associated header value, or null if none

getHeaders

public java.util.List<java.lang.Object> getHeaders(java.lang.String name)

Return all values for the given header as a List of value objects.

Parameters:

name - the name of the header

Returns:

the associated header values, or an empty List if none

encodeURL

public java.lang.String encodeURL(java.lang.String url)

The default implementation returns the given URL String as-is.

Can be overridden in subclasses, appending a session id or the like.

encodeRedirectURL

public java.lang.String encodeRedirectURL(java.lang.String url)

The default implementation delegates to encodeURL(java.lang.String), returning the given URL String as-is.

Can be overridden in subclasses, appending a session id or the like in a redirect-specific fashion. For general URL encoding rules, override the common encodeURL(java.lang.String) method instead, appyling to redirect URLs as well as to general URLs.

encodeUrl

public java.lang.String encodeUrl(java.lang.String url)

encodeRedirectUrl

public java.lang.String encodeRedirectUrl(java.lang.String url)

sendError

public void sendError(int status,
                      java.lang.String errorMessage)
               throws java.io.IOException

Throws:

java.io.IOException

sendError

public void sendError(int status)
               throws java.io.IOException

Throws:

java.io.IOException

sendRedirect

public void sendRedirect(java.lang.String url)
                  throws java.io.IOException

Throws:

java.io.IOException

getRedirectedUrl

public java.lang.String getRedirectedUrl()

setDateHeader

public void setDateHeader(java.lang.String name,
                          long value)

addDateHeader

public void addDateHeader(java.lang.String name,
                          long value)

setHeader

public void setHeader(java.lang.String name,
                      java.lang.String value)

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String value)

setIntHeader

public void setIntHeader(java.lang.String name,
                         int value)

addIntHeader

public void addIntHeader(java.lang.String name,
                         int value)

setHeaderValue

private void setHeaderValue(java.lang.String name,
                            java.lang.Object value)

addHeaderValue

private void addHeaderValue(java.lang.String name,
                            java.lang.Object value)

doAddHeaderValue

private void doAddHeaderValue(java.lang.String name,
                              java.lang.Object value,
                              boolean replace)

setStatus

public void setStatus(int status)

setStatus

public void setStatus(int status,
                      java.lang.String errorMessage)

getStatus

public int getStatus()

getErrorMessage

public java.lang.String getErrorMessage()

setForwardedUrl

public void setForwardedUrl(java.lang.String forwardedUrl)

getForwardedUrl

public java.lang.String getForwardedUrl()

setIncludedUrl

public void setIncludedUrl(java.lang.String includedUrl)

getIncludedUrl

public java.lang.String getIncludedUrl()

addIncludedUrl

public void addIncludedUrl(java.lang.String includedUrl)

getIncludedUrls

public java.util.List<java.lang.String> getIncludedUrls()