SC_NOT_ACCEPTABLE
Status code (406) indicating that the resource identified by the
request is only capable of generating response entities which have
content characteristics not acceptable according to the accept
headerssent in the request.

static int

SC_NOT_FOUND
Status code (404) indicating that the requested resource is not
available.

static int

SC_NOT_IMPLEMENTED
Status code (501) indicating the HTTP server does not support
the functionality needed to fulfill the request.

static int

SC_NOT_MODIFIED
Status code (304) indicating that a conditional GET operation
found that the resource was available and not modified.

SC_UNSUPPORTED_MEDIA_TYPE
Status code (415) indicating that the server is refusing to service
the request because the entity of the request is in a format not
supported by the requested resource for the requested method.

static int

SC_USE_PROXY
Status code (305) indicating that the requested resource
MUST be accessed through the proxy given by the
Location field.

setStatus(int sc,
java.lang.String sm)Deprecated.As of version 2.1, due to ambiguous meaning of the
message parameter. To set a status code
use setStatus(int), to send an error with a description
use sendError(int, String).
Sets the status code and message for this response.

SC_NOT_ACCEPTABLE

public static final int SC_NOT_ACCEPTABLE

Status code (406) indicating that the resource identified by the
request is only capable of generating response entities which have
content characteristics not acceptable according to the accept
headerssent in the request.

addCookie

Adds the specified cookie to the response. This method can be called
multiple times to set more than one cookie.

Parameters:

cookie - the Cookie to return to the client

containsHeader

public boolean containsHeader(java.lang.String name)

Returns a boolean indicating whether the named response header
has already been set.

Parameters:

name - the header name

Returns:

true if the named response header
has already been set;
false otherwise

encodeURL

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

Encodes the specified URL by including the session ID in it,
or, if encoding is not needed, returns the URL unchanged.
The implementation of this method includes the logic to
determine whether the session ID needs to be encoded in the URL.
For example, if the browser supports cookies, or session
tracking is turned off, URL encoding is unnecessary.

For robust session tracking, all URLs emitted by a servlet
should be run through this
method. Otherwise, URL rewriting cannot be used with browsers
which do not support cookies.

Parameters:

url - the url to be encoded.

Returns:

the encoded URL if encoding is needed;
the unchanged URL otherwise.

encodeRedirectURL

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

Encodes the specified URL for use in the
sendRedirect method or, if encoding is not needed,
returns the URL unchanged. The implementation of this method
includes the logic to determine whether the session ID
needs to be encoded in the URL. Because the rules for making
this determination can differ from those used to decide whether to
encode a normal link, this method is seperate from the
encodeURL method.

All URLs sent to the HttpServletResponse.sendRedirect
method should be run through this method. Otherwise, URL
rewriting cannot be used with browsers which do not support
cookies.

sendError

Sends an error response to the client using the specified
status clearing the buffer. The server defaults to creating the
response to look like an HTML-formatted server error page containing the specified message, setting the content type
to "text/html", leaving cookies and other headers unmodified.
If an error-page declaration has been made for the web application
corresponding to the status code passed in, it will be served back in
preference to the suggested msg parameter.

If the response has already been committed, this method throws
an IllegalStateException.
After using this method, the response should be considered
to be committed and should not be written to.

Parameters:

sc - the error status code

msg - the descriptive message

Throws:

java.io.IOException - If an input or output exception occurs

java.lang.IllegalStateException - If the response was committed

sendError

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

Sends an error response to the client using the specified status
code and clearing the buffer.

If the response has already been committed, this method throws
an IllegalStateException.
After using this method, the response should be considered
to be committed and should not be written to.

Parameters:

sc - the error status code

Throws:

java.io.IOException - If an input or output exception occurs

java.lang.IllegalStateException - If the response was committed
before this method call

sendRedirect

Sends a temporary redirect response to the client using the
specified redirect location URL. This method can accept relative URLs;
the servlet container must convert the relative URL to an absolute URL
before sending the response to the client. If the location is relative
without a leading '/' the container interprets it as relative to
the current request URI. If the location is relative with a leading
'/' the container interprets it as relative to the servlet container root.

If the response has already been committed, this method throws
an IllegalStateException.
After using this method, the response should be considered
to be committed and should not be written to.

Parameters:

location - the redirect location URL

Throws:

java.io.IOException - If an input or output exception occurs

java.lang.IllegalStateException - If the response was committed

setDateHeader

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

Sets a response header with the given name and
date-value. The date is specified in terms of
milliseconds since the epoch. If the header had already
been set, the new value overwrites the previous one. The
containsHeader method can be used to test for the
presence of a header before setting its value.

setHeader

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

Sets a response header with the given name and value.
If the header had already been set, the new value overwrites the
previous one. The containsHeader method can be
used to test for the presence of a header before setting its
value.

setIntHeader

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

Sets a response header with the given name and
integer value. If the header had already been set, the new value
overwrites the previous one. The containsHeader
method can be used to test for the presence of a header before
setting its value.

setStatus

public void setStatus(int sc)

Sets the status code for this response. This method is used to
set the return status code when there is no error (for example,
for the status codes SC_OK or SC_MOVED_TEMPORARILY). If there
is an error, and the caller wishes to invoke an defined
in the web applicaion, the sendError method should be used
instead.

The container clears the buffer and sets the Location header, preserving
cookies and other headers.

setStatus

public void setStatus(int sc,
java.lang.String sm)

Deprecated.As of version 2.1, due to ambiguous meaning of the
message parameter. To set a status code
use setStatus(int), to send an error with a description
use sendError(int, String).
Sets the status code and message for this response.