- java.lang.Object
-
- javax.servlet.ServletResponseWrapper
-
- All Implemented Interfaces:
- ServletResponse
- Direct Known Subclasses:
- HttpServletResponseWrapper
public class ServletResponseWrapper extends Object implements ServletResponse
Provides a convenient implementation of the ServletResponse interface that can be subclassed by developers wishing to adapt the response from a Servlet. This class implements the Wrapper or Decorator pattern. Methods default to calling through to the wrapped response object.- Since:
- Servlet 2.3
- Author:
- Various
- See Also:
ServletResponse
-
-
Constructor Summary
Constructors Constructor and Description ServletResponseWrapper(ServletResponse response)
Creates a ServletResponse adaptor wrapping the given response object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description void
flushBuffer()
The default behavior of this method is to call flushBuffer() on the wrapped response object.int
getBufferSize()
The default behavior of this method is to return getBufferSize() on the wrapped response object.String
getCharacterEncoding()
The default behavior of this method is to return getCharacterEncoding() on the wrapped response object.String
getContentType()
The default behavior of this method is to return getContentType() on the wrapped response object.Locale
getLocale()
The default behavior of this method is to return getLocale() on the wrapped response object.ServletOutputStream
getOutputStream()
The default behavior of this method is to return getOutputStream() on the wrapped response object.ServletResponse
getResponse()
Return the wrapped ServletResponse object.PrintWriter
getWriter()
The default behavior of this method is to return getWriter() on the wrapped response object.boolean
isCommitted()
The default behavior of this method is to return isCommitted() on the wrapped response object.boolean
isWrapperFor(Class<?> wrappedType)
Checks (recursively) if this ServletResponseWrapper wraps aServletResponse
of the given class type.boolean
isWrapperFor(ServletResponse wrapped)
Checks (recursively) if this ServletResponseWrapper wraps the givenServletResponse
instance.void
reset()
The default behavior of this method is to call reset() on the wrapped response object.void
resetBuffer()
The default behavior of this method is to call resetBuffer() on the wrapped response object.void
setBufferSize(int size)
The default behavior of this method is to call setBufferSize(int size) on the wrapped response object.void
setCharacterEncoding(String charset)
The default behavior of this method is to call setCharacterEncoding(String charset) on the wrapped response object.void
setContentLength(int len)
The default behavior of this method is to call setContentLength(int len) on the wrapped response object.void
setContentLengthLong(long len)
The default behavior of this method is to call setContentLengthLong(long len) on the wrapped response object.void
setContentType(String type)
The default behavior of this method is to call setContentType(String type) on the wrapped response object.void
setLocale(Locale loc)
The default behavior of this method is to call setLocale(Locale loc) on the wrapped response object.void
setResponse(ServletResponse response)
Sets the response being wrapped.
-
-
-
Constructor Detail
-
ServletResponseWrapper
public ServletResponseWrapper(ServletResponse response)
Creates a ServletResponse adaptor wrapping the given response object.- Throws:
IllegalArgumentException
- if the response is null.
-
-
Method Detail
-
getResponse
public ServletResponse getResponse()
Return the wrapped ServletResponse object.
-
setResponse
public void setResponse(ServletResponse response)
Sets the response being wrapped.- Throws:
IllegalArgumentException
- if the response is null.
-
setCharacterEncoding
public void setCharacterEncoding(String charset)
The default behavior of this method is to call setCharacterEncoding(String charset) on the wrapped response object.- Specified by:
setCharacterEncoding
in interfaceServletResponse
- Parameters:
charset
- a String specifying only the character set defined by IANA Character Sets (http://www.iana.org/assignments/character-sets)- Since:
- Servlet 2.4
- See Also:
ServletResponse.setContentType(java.lang.String)
,ServletResponse.setLocale(java.util.Locale)
-
getCharacterEncoding
public String getCharacterEncoding()
The default behavior of this method is to return getCharacterEncoding() on the wrapped response object.- Specified by:
getCharacterEncoding
in interfaceServletResponse
- Returns:
- a
String
specifying the name of the character encoding, for example,UTF-8
-
getOutputStream
public ServletOutputStream getOutputStream() throws IOException
The default behavior of this method is to return getOutputStream() on the wrapped response object.- Specified by:
getOutputStream
in interfaceServletResponse
- Returns:
- a
ServletOutputStream
for writing binary data - Throws:
IOException
- if an input or output exception occurred- See Also:
ServletResponse.getWriter()
,ServletResponse.reset()
-
getWriter
public PrintWriter getWriter() throws IOException
The default behavior of this method is to return getWriter() on the wrapped response object.- Specified by:
getWriter
in interfaceServletResponse
- Returns:
- a
PrintWriter
object that can return character data to the client - Throws:
UnsupportedEncodingException
- if the character encoding returned bygetCharacterEncoding
cannot be usedIOException
- if an input or output exception occurred- See Also:
ServletResponse.getOutputStream()
,ServletResponse.setCharacterEncoding(java.lang.String)
,ServletResponse.reset()
-
setContentLength
public void setContentLength(int len)
The default behavior of this method is to call setContentLength(int len) on the wrapped response object.- Specified by:
setContentLength
in interfaceServletResponse
- Parameters:
len
- an integer specifying the length of the content being returned to the client; sets the Content-Length header
-
setContentLengthLong
public void setContentLengthLong(long len)
The default behavior of this method is to call setContentLengthLong(long len) on the wrapped response object.- Specified by:
setContentLengthLong
in interfaceServletResponse
- Parameters:
len
- a long specifying the length of the content being returned to the client; sets the Content-Length header
-
setContentType
public void setContentType(String type)
The default behavior of this method is to call setContentType(String type) on the wrapped response object.- Specified by:
setContentType
in interfaceServletResponse
- Parameters:
type
- aString
specifying the MIME type of the content- See Also:
ServletResponse.setLocale(java.util.Locale)
,ServletResponse.setCharacterEncoding(java.lang.String)
,ServletResponse.getOutputStream()
,ServletResponse.getWriter()
-
getContentType
public String getContentType()
The default behavior of this method is to return getContentType() on the wrapped response object.- Specified by:
getContentType
in interfaceServletResponse
- Returns:
- a
String
specifying the content type, for example,text/html; charset=UTF-8
, or null - Since:
- Servlet 2.4
-
setBufferSize
public void setBufferSize(int size)
The default behavior of this method is to call setBufferSize(int size) on the wrapped response object.- Specified by:
setBufferSize
in interfaceServletResponse
- Parameters:
size
- the preferred buffer size- See Also:
ServletResponse.getBufferSize()
,ServletResponse.flushBuffer()
,ServletResponse.isCommitted()
,ServletResponse.reset()
-
getBufferSize
public int getBufferSize()
The default behavior of this method is to return getBufferSize() on the wrapped response object.- Specified by:
getBufferSize
in interfaceServletResponse
- Returns:
- the actual buffer size used
- See Also:
ServletResponse.setBufferSize(int)
,ServletResponse.flushBuffer()
,ServletResponse.isCommitted()
,ServletResponse.reset()
-
flushBuffer
public void flushBuffer() throws IOException
The default behavior of this method is to call flushBuffer() on the wrapped response object.- Specified by:
flushBuffer
in interfaceServletResponse
- Throws:
IOException
- See Also:
ServletResponse.setBufferSize(int)
,ServletResponse.getBufferSize()
,ServletResponse.isCommitted()
,ServletResponse.reset()
-
isCommitted
public boolean isCommitted()
The default behavior of this method is to return isCommitted() on the wrapped response object.- Specified by:
isCommitted
in interfaceServletResponse
- Returns:
- a boolean indicating if the response has been committed
- See Also:
ServletResponse.setBufferSize(int)
,ServletResponse.getBufferSize()
,ServletResponse.flushBuffer()
,ServletResponse.reset()
-
reset
public void reset()
The default behavior of this method is to call reset() on the wrapped response object.- Specified by:
reset
in interfaceServletResponse
- See Also:
ServletResponse.setBufferSize(int)
,ServletResponse.getBufferSize()
,ServletResponse.flushBuffer()
,ServletResponse.isCommitted()
-
resetBuffer
public void resetBuffer()
The default behavior of this method is to call resetBuffer() on the wrapped response object.- Specified by:
resetBuffer
in interfaceServletResponse
- See Also:
ServletResponse.setBufferSize(int)
,ServletResponse.getBufferSize()
,ServletResponse.isCommitted()
,ServletResponse.reset()
-
setLocale
public void setLocale(Locale loc)
The default behavior of this method is to call setLocale(Locale loc) on the wrapped response object.- Specified by:
setLocale
in interfaceServletResponse
- Parameters:
loc
- the locale of the response- See Also:
ServletResponse.getLocale()
,ServletResponse.setContentType(java.lang.String)
,ServletResponse.setCharacterEncoding(java.lang.String)
-
getLocale
public Locale getLocale()
The default behavior of this method is to return getLocale() on the wrapped response object.- Specified by:
getLocale
in interfaceServletResponse
- See Also:
ServletResponse.setLocale(java.util.Locale)
-
isWrapperFor
public boolean isWrapperFor(ServletResponse wrapped)
Checks (recursively) if this ServletResponseWrapper wraps the givenServletResponse
instance.- Parameters:
wrapped
- the ServletResponse instance to search for- Returns:
- true if this ServletResponseWrapper wraps the given ServletResponse instance, false otherwise
- Since:
- Servlet 3.0
-
isWrapperFor
public boolean isWrapperFor(Class<?> wrappedType)
Checks (recursively) if this ServletResponseWrapper wraps aServletResponse
of the given class type.- Parameters:
wrappedType
- the ServletResponse class type to search for- Returns:
- true if this ServletResponseWrapper wraps a ServletResponse of the given class type, false otherwise
- Throws:
IllegalArgumentException
- if the given class does not implementServletResponse
- Since:
- Servlet 3.0
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 18/08/2025
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-javaee-rf-javax/servlet/servletresponsewrapper.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor dieser Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.