org.apache.coyote

Class Response

java.lang.Object

org.apache.coyote.Response

public final class Response
extends Object

Response object.

Author:

James Duncan Davidson [duncan@eng.sun.com], Jason Hunter [jch@eng.sun.com], James Todd [gonzo@eng.sun.com], Harish Prabandham, Hans Bergsten , Remy Maucherat

Field Summary

Fields

Modifier and Type	Field and Description
protected String	characterEncoding
protected boolean	charsetSet Has the charset been explicitly set.
protected boolean	commited Committed flag.
protected String	contentLanguage
protected int	contentLength
protected String	contentType HTTP specific fields.
protected Exception	errorException Holds request error exception.
protected String	errorURI Request error URI.
protected MimeHeaders	headers Response headers.
ActionHook	hook Action hook.
protected String	message Status message.
protected OutputBuffer	outputBuffer Associated output buffer.
protected Request	req
protected int	status Status code.

Constructor Summary

Constructors

Constructor and Description
Response()

Method Summary

Modifier and Type	Method and Description
void	acknowledge()
void	action(ActionCode actionCode, Object param)
void	addHeader(String name, String value)
boolean	containsHeader(String name)
void	doWrite(ByteChunk chunk) Write a chunk of bytes.
void	finish()
long	getBytesWritten()
String	getCharacterEncoding()
String	getContentLanguage() Return the content language.
int	getContentLength()
long	getContentLengthLong()
String	getContentType()
Exception	getErrorException() Get the Exception that occurred during request processing.
String	getErrorURI() Get the request URI that caused the original error.
ActionHook	getHook()
Locale	getLocale()
String	getMessage() Get the status message.
MimeHeaders	getMimeHeaders()
Object	getNote(int pos)
NotesManagerImpl	getNotesManager()
OutputBuffer	getOutputBuffer()
Request	getRequest()
int	getStatus()
boolean	isCommitted()
boolean	isExceptionPresent()
void	recycle()
void	removeSessionCookies() Removes any Set-Cookie response headers whose value contains the string JSESSIONID
void	reset()
void	sendHeaders() Signal that we're done with the headers, and body will follow.
void	setBytesWritten(long bytesWritten)
void	setCharacterEncoding(String charset)
void	setCommitted(boolean v)
void	setContentLength(int contentLength)
void	setContentType(String type) Sets the content type.
void	setErrorException(Exception ex) Set the error Exception that occurred during request processing.
void	setErrorURI(String uri) Set request URI that caused an error during request processing.
void	setHeader(String name, String value)
void	setHook(ActionHook hook)
void	setLocale(Locale locale) Called explicitely by user to set the Content-Language and the default encoding
void	setMessage(String message) Set the status message.
void	setNote(int pos, Object value)
void	setNotesManager(NotesManagerImpl notesManager)
void	setOutputBuffer(OutputBuffer outputBuffer)
void	setRequest(Request req)
void	setStatus(int status) Set the response status

Methods inherited from class java.lang.Object

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

Field Detail

status

protected int status

Status code.

message

protected String message

Status message.

headers

protected MimeHeaders headers

Response headers.

outputBuffer

protected OutputBuffer outputBuffer

Associated output buffer.

commited

protected boolean commited

Committed flag.

hook

public ActionHook hook

Action hook.

contentType

protected String contentType

HTTP specific fields.

contentLanguage

protected String contentLanguage

characterEncoding

protected String characterEncoding

contentLength

protected int contentLength

errorException

protected Exception errorException

Holds request error exception.

charsetSet

protected boolean charsetSet

Has the charset been explicitly set.

errorURI

protected String errorURI

Request error URI.

req

protected Request req

Constructor Detail

Response

public Response()

Method Detail

getRequest

public Request getRequest()

setRequest

public void setRequest(Request req)

getOutputBuffer

public OutputBuffer getOutputBuffer()

setOutputBuffer

public void setOutputBuffer(OutputBuffer outputBuffer)

getMimeHeaders

public MimeHeaders getMimeHeaders()

getHook

public ActionHook getHook()

setHook

public void setHook(ActionHook hook)

setNote

public final void setNote(int pos,
                          Object value)

getNote

public final Object getNote(int pos)

getNotesManager

public NotesManagerImpl getNotesManager()

setNotesManager

public void setNotesManager(NotesManagerImpl notesManager)

action

public void action(ActionCode actionCode,
                   Object param)

getStatus

public int getStatus()

setStatus

public void setStatus(int status)

Set the response status

getMessage

public String getMessage()

Get the status message.

setMessage

public void setMessage(String message)

Set the status message.

isCommitted

public boolean isCommitted()

setCommitted

public void setCommitted(boolean v)

setErrorException

public void setErrorException(Exception ex)

Set the error Exception that occurred during request processing.

getErrorException

public Exception getErrorException()

Get the Exception that occurred during request processing.

isExceptionPresent

public boolean isExceptionPresent()

setErrorURI

public void setErrorURI(String uri)

Set request URI that caused an error during request processing.

getErrorURI

public String getErrorURI()

Get the request URI that caused the original error.

reset

public void reset()
           throws IllegalStateException

Throws:

IllegalStateException

finish

public void finish()
            throws IOException

Throws:

IOException

acknowledge

public void acknowledge()
                 throws IOException

Throws:

IOException

containsHeader

public boolean containsHeader(String name)

setHeader

public void setHeader(String name,
                      String value)

addHeader

public void addHeader(String name,
                      String value)

sendHeaders

public void sendHeaders()
                 throws IOException

Signal that we're done with the headers, and body will follow. Any implementation needs to notify ContextManager, to allow interceptors to fix headers.

Throws:

IOException

getLocale

public Locale getLocale()

setLocale

public void setLocale(Locale locale)

Called explicitely by user to set the Content-Language and the default encoding

getContentLanguage

public String getContentLanguage()

Return the content language.

setCharacterEncoding

public void setCharacterEncoding(String charset)

getCharacterEncoding

public String getCharacterEncoding()

setContentType

public void setContentType(String type)

Sets the content type. This method must preserve any response charset that may already have been set via a call to response.setContentType(), response.setLocale(), or response.setCharacterEncoding().

Parameters:

type - the content type

getContentType

public String getContentType()

setContentLength

public void setContentLength(int contentLength)

getContentLength

public int getContentLength()

getContentLengthLong

public long getContentLengthLong()

doWrite

public void doWrite(ByteChunk chunk)
             throws IOException

Write a chunk of bytes.

Throws:

IOException

recycle

public void recycle()

getBytesWritten

public long getBytesWritten()

setBytesWritten

public void setBytesWritten(long bytesWritten)

removeSessionCookies

public void removeSessionCookies()

Removes any Set-Cookie response headers whose value contains the string JSESSIONID