All Known Implementing Classes:
HttpServletResponse, HttpServletResponseWrapper, NoBodyResponse, ServletResponseWrapper
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
manually.
The charset for the MIME body response can be specified
explicitly using the #setCharacterEncoding and
#setContentType methods, or implicitly
using the #setLocale method.
Explicit specifications take precedence over
implicit specifications. If no charset is specified, ISO-8859-1 will be
used. The setCharacterEncoding
,
setContentType
, or setLocale
method must
be called before getWriter
and before committing
the response for the character encoding to be used.
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.
Various
- $
- Version$Method from javax.servlet.ServletResponse Summary: |
---|
flushBuffer, getBufferSize, getCharacterEncoding, getContentType, getLocale, getOutputStream, getWriter, isCommitted, reset, resetBuffer, setBufferSize, setCharacterEncoding, setContentLength, setContentType, setLocale |
Method from javax.servlet.ServletResponse Detail: |
---|
|
|
getWriter has been
called or after the response has been committed have no
effect on the character encoding. If no character encoding
has been specified, ISO-8859-1 is returned.
See RFC 2047 (http://www.ietf.org/rfc/rfc2047.txt) for more information about character encoding and MIME. |
|
setLocale after the response is committed
have no effect. If no locale has been specified,
the container's default locale is returned. |
Calling flush() on the ServletOutputStream commits the response. Either this method or #getWriter may be called to write the body, not both. |
PrintWriter object that
can send character text to the client.
The PrintWriter uses the character
encoding returned by #getCharacterEncoding .
If the response's character encoding has not been
specified as described in getCharacterEncoding
(i.e., the method just returns the default value
ISO-8859-1 ), getWriter
updates it to ISO-8859-1 .
Calling flush() on the Either this method or #getOutputStream may be called to write the body, not both. |
|
IllegalStateException . |
IllegalStateException . |
getBufferSize .
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 quickly. This method must be called before any response body content is
written; if content has been written or the response object has
been committed, this method throws an
|
String
of text/html and calling
this method with the String of UTF-8
is equivalent with calling
setContentType with the String of
text/html; charset=UTF-8 .
This method can be called repeatedly to change the character
encoding.
This method has no effect if it is called after
Containers must communicate the character encoding used for
the servlet response's writer to the client if the protocol
provides a way for doing so. In the case of HTTP, the character
encoding is communicated as part of the |
|
text/html;charset=UTF-8 .
The response's character encoding is only set from the given
content type if this method is called before getWriter
is called.
This method may be called repeatedly to change content type and
character encoding.
This method has no effect if called after the response
has been committed. It does not set the response's character
encoding if it is called after Containers must communicate the content type and the character
encoding used for the servlet response's writer to the client if
the protocol provides a way for doing so. In the case of HTTP,
the |
getWriter hasn't
been called yet, and the response hasn't been committed yet.
If the deployment descriptor contains a
locale-encoding-mapping-list element, and that
element provides a mapping for the given locale, that mapping
is used. Otherwise, the mapping from locale to character
encoding is container dependent.
This method may be called repeatedly to change locale and
character encoding. The method has no effect if called after the
response has been committed. It does not set the response's
character encoding if it is called after #setContentType
has been called with a charset specification, after
#setCharacterEncoding has been called, after
Containers must communicate the locale and the character encoding
used for the servlet response's writer to the client if the protocol
provides a way for doing so. In the case of HTTP, the locale is
communicated via the |