org.tinygroup.weblayer.webcontext.buffered.response

类 BufferedResponseImpl

java.lang.Object

javax.servlet.ServletResponseWrapper

javax.servlet.http.HttpServletResponseWrapper

org.tinygroup.weblayer.webcontext.AbstractResponseWrapper

org.tinygroup.weblayer.webcontext.buffered.response.BufferedResponseImpl

所有已实现的接口:

javax.servlet.http.HttpServletResponse, javax.servlet.ServletResponse

public class BufferedResponseImpl
extends AbstractResponseWrapper

包裹HttpServletResponse，使之输出到内存中。

作者:

renhui

字段概要

从接口继承的字段 javax.servlet.http.HttpServletResponse

SC_ACCEPTED, SC_BAD_GATEWAY, SC_BAD_REQUEST, SC_CONFLICT, SC_CONTINUE, SC_CREATED, SC_EXPECTATION_FAILED, SC_FORBIDDEN, SC_FOUND, SC_GATEWAY_TIMEOUT, SC_GONE, SC_HTTP_VERSION_NOT_SUPPORTED, SC_INTERNAL_SERVER_ERROR, SC_LENGTH_REQUIRED, SC_METHOD_NOT_ALLOWED, SC_MOVED_PERMANENTLY, SC_MOVED_TEMPORARILY, SC_MULTIPLE_CHOICES, SC_NO_CONTENT, SC_NON_AUTHORITATIVE_INFORMATION, SC_NOT_ACCEPTABLE, SC_NOT_FOUND, SC_NOT_IMPLEMENTED, SC_NOT_MODIFIED, SC_OK, SC_PARTIAL_CONTENT, SC_PAYMENT_REQUIRED, SC_PRECONDITION_FAILED, SC_PROXY_AUTHENTICATION_REQUIRED, SC_REQUEST_ENTITY_TOO_LARGE, SC_REQUEST_TIMEOUT, SC_REQUEST_URI_TOO_LONG, SC_REQUESTED_RANGE_NOT_SATISFIABLE, SC_RESET_CONTENT, SC_SEE_OTHER, SC_SERVICE_UNAVAILABLE, SC_SWITCHING_PROTOCOLS, SC_TEMPORARY_REDIRECT, SC_UNAUTHORIZED, SC_UNSUPPORTED_MEDIA_TYPE, SC_USE_PROXY

构造器概要

构造器

构造器和说明
BufferedResponseImpl(WebContext webContext, javax.servlet.http.HttpServletResponse response) 创建一个BufferedResponseImpl。

方法概要

方法

限定符和类型	方法和说明
void	commitBuffer() 将buffer中的内容提交到真正的servlet输出流中。
void	flushBuffer() 冲洗buffer。
javax.servlet.ServletOutputStream	getOutputStream() 取得输出流。
PrintWriter	getWriter() 取得输出字符流。
boolean	isBuffering() 设置是否将所有信息保存在内存中。
ByteArray	popByteBuffer() 弹出最近的buffer，如果堆栈中只有一个buffer，则弹出后再创建一个新的。
String	popCharBuffer() 弹出最近的buffer，如果堆栈中只有一个buffer，则弹出后再创建一个新的。
void	pushBuffer() 创建新的buffer，保存老的buffer。
void	resetBuffer() 清除所有buffers，常用于显示出错信息。
void	setBuffering(boolean buffering) 设置buffer模式，如果设置成true，表示将所有信息保存在内存中，否则直接输出到原始response中。
void	setContentLength(int length) 设置content长度。

从类继承的方法 org.tinygroup.weblayer.webcontext.AbstractResponseWrapper

getServletContext, getWebContext, toString

从类继承的方法 javax.servlet.http.HttpServletResponseWrapper

addCookie, addDateHeader, addHeader, addIntHeader, containsHeader, encodeRedirectUrl, encodeRedirectURL, encodeUrl, encodeURL, sendError, sendError, sendRedirect, setDateHeader, setHeader, setIntHeader, setStatus, setStatus

从类继承的方法 javax.servlet.ServletResponseWrapper

getBufferSize, getCharacterEncoding, getContentType, getLocale, getResponse, isCommitted, reset, setBufferSize, setCharacterEncoding, setContentType, setLocale, setResponse

从类继承的方法 java.lang.Object

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

从接口继承的方法 javax.servlet.ServletResponse

getBufferSize, getCharacterEncoding, getContentType, getLocale, isCommitted, reset, setBufferSize, setCharacterEncoding, setContentType, setLocale

构造器详细资料

BufferedResponseImpl

public BufferedResponseImpl(WebContext webContext,
                    javax.servlet.http.HttpServletResponse response)

创建一个BufferedResponseImpl。

参数:

requestContext - response所在的request context

response - 原始的response

方法详细资料

getOutputStream

public javax.servlet.ServletOutputStream getOutputStream()
                                                  throws IOException

取得输出流。

指定者:

getOutputStream 在接口中 javax.servlet.ServletResponse

覆盖:

getOutputStream 在类中 javax.servlet.ServletResponseWrapper

返回:

response的输出流

抛出:

IOException - 输入输出失败

getWriter

public PrintWriter getWriter()
                      throws IOException

取得输出字符流。

指定者:

getWriter 在接口中 javax.servlet.ServletResponse

覆盖:

getWriter 在类中 javax.servlet.ServletResponseWrapper

返回:

response的输出字符流

抛出:

IOException - 输入输出失败

setContentLength

public void setContentLength(int length)

设置content长度。该调用只在setBuffering(false)时有效。

指定者:

setContentLength 在接口中 javax.servlet.ServletResponse

覆盖:

setContentLength 在类中 javax.servlet.ServletResponseWrapper

参数:

length - content长度

flushBuffer

public void flushBuffer()
                 throws IOException

冲洗buffer。

指定者:

flushBuffer 在接口中 javax.servlet.ServletResponse

覆盖:

flushBuffer 在类中 javax.servlet.ServletResponseWrapper

抛出:

IOException - 如果失败

resetBuffer

public void resetBuffer()

清除所有buffers，常用于显示出错信息。

指定者:

resetBuffer 在接口中 javax.servlet.ServletResponse

覆盖:

resetBuffer 在类中 javax.servlet.ServletResponseWrapper

抛出:

IllegalStateException - 如果response已经commit

isBuffering

public boolean isBuffering()

设置是否将所有信息保存在内存中。

返回:

如果是，则返回true

setBuffering

public void setBuffering(boolean buffering)

设置buffer模式，如果设置成true，表示将所有信息保存在内存中，否则直接输出到原始response中。

此方法必须在getOutputStream和getWriter方法之前执行，否则将抛出 IllegalStateException。

参数:

buffering - 是否buffer内容

抛出:

IllegalStateException - getOutputStream或 getWriter方法已经被执行

pushBuffer

public void pushBuffer()

创建新的buffer，保存老的buffer。

抛出:

IllegalStateException - 如果不在buffer模式，或getWriter 方法曾被调用，或getOutputStream方法从未被调用

popByteBuffer

public ByteArray popByteBuffer()

弹出最近的buffer，如果堆栈中只有一个buffer，则弹出后再创建一个新的。

返回:

最近的buffer内容，如果getOutputStream方法从未被调用，则返回空的byte array

抛出:

IllegalStateException - 如果不在buffer模式，或getWriter方法曾被调用

popCharBuffer

public String popCharBuffer()

弹出最近的buffer，如果堆栈中只有一个buffer，则弹出后再创建一个新的。

返回:

最近的buffer内容，如果getWriter方法从未被调用，则返回空的字符串

抛出:

IllegalStateException - 如果不在buffer模式，或getOutputStream 方法曾被调用

commitBuffer

public void commitBuffer()
                  throws IOException

将buffer中的内容提交到真正的servlet输出流中。

如果从来没有执行过getOutputStream或getWriter 方法，则该方法不做任何事情。

抛出:

IOException - 如果输入输出失败

IllegalStateException - 如果不是在buffer模式，或buffer栈中不止一个buffer