Defines an object to assist a servlet in sending a response to the client.
The servlet container creates a ServletResponse object and
passes it as an argument to the servlet's service method.
To send binary data in a MIME body response, use
the ServletOutputStream returned by getOutputStream().
To send character data, use the PrintWriter object
returned by getWriter(). To mix binary and text data,
for example, to create a multipart response, use a
ServletOutputStream and manage the character sections
The charset for the MIME body response can be specified with
setContentType(java.lang.String). For example, "text/html; charset=Shift_JIS".
The charset can alternately be set using setLocale(java.util.Locale).
If no charset is specified, ISO-8859-1 will be used.
The setContentType or setLocale method
must be called before getWriter for the charset to
affect the construction of the writer.
See the Internet RFCs such as
RFC 2045 for more information on MIME. Protocols such as SMTP
and HTTP define profiles of MIME, and those standards
are still evolving.
public java.io.PrintWriter getWriter()
Returns a PrintWriter object that
can send character text to the client.
The character encoding used is the one specified
in the charset= property of the
setContentType(java.lang.String) method, which must be called
before calling this method for the charset to take effect.
If necessary, the MIME type of the response is
modified to reflect the character encoding used.
Calling flush() on the PrintWriter commits the response.
Sets the preferred buffer size for the body of the response.
The servlet container will use a buffer at least as large as
the size requested. The actual buffer size used can be found
A larger buffer allows more content to be written before anything is
actually sent, thus providing the servlet with more time to set
appropriate status codes and headers. A smaller buffer decreases
server memory load and allows the client to start receiving data more
This method must be called before any response body content is
written; if content has been written, this method throws an
size - the preferred buffer size
java.lang.IllegalStateException - if this method is called after
content has been written
Sets the locale of the response, setting the headers (including the
Content-Type's charset) as appropriate. This method should be called
before a call to getWriter(). By default, the response locale
is the default locale for the server.