Package org.eclipse.jetty.server
Class Response
- java.lang.Object
-
- org.eclipse.jetty.server.Response
-
- All Implemented Interfaces:
HttpServletResponse,ServletResponse
public class Response extends java.lang.Object implements HttpServletResponse
Responseprovides the implementation forHttpServletResponse.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classResponse.OutputType
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringSET_INCLUDE_HEADER_PREFIXIf a header name starts with this string, the header (stripped of the prefix) can be set during include using onlysetHeader(String, String)oraddHeader(String, String).-
Fields inherited from interface 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
-
-
Constructor Summary
Constructors Constructor Description Response(HttpChannel channel, HttpOutput out)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidaddCookie(Cookie cookie)voidaddCookie(HttpCookie cookie)voidaddDateHeader(java.lang.String name, long date)voidaddHeader(java.lang.String name, java.lang.String value)voidaddIntHeader(java.lang.String name, int value)voidcloseOutput()voidcompleteOutput()Deprecated.UsecloseOutput()voidcompleteOutput(Callback callback)booleancontainsHeader(java.lang.String name)java.lang.StringencodeRedirectUrl(java.lang.String url)Deprecated.java.lang.StringencodeRedirectURL(java.lang.String url)java.lang.StringencodeUrl(java.lang.String url)Deprecated.java.lang.StringencodeURL(java.lang.String url)voiderrorClose()voidflushBuffer()intgetBufferSize()java.lang.StringgetCharacterEncoding()MetaData.ResponsegetCommittedMetaData()Get the MetaData.Response committed for this response.longgetContentCount()longgetContentLength()java.lang.StringgetContentType()java.lang.StringgetHeader(java.lang.String name)java.util.Collection<java.lang.String>getHeaderNames()java.util.Collection<java.lang.String>getHeaders(java.lang.String name)HttpChannelgetHttpChannel()HttpFieldsgetHttpFields()HttpOutputgetHttpOutput()java.util.LocalegetLocale()longgetLongContentLength()ServletOutputStreamgetOutputStream()java.lang.StringgetReason()intgetStatus()java.util.function.Supplier<HttpFields>getTrailers()java.io.PrintWritergetWriter()voidinclude()voidincluded()booleanisAllContentWritten(long written)booleanisCommitted()booleanisContentComplete(long written)booleanisIncluding()booleanisStreaming()booleanisWriting()booleanisWritingOrStreaming()static voidputHeaders(HttpServletResponse response, HttpContent content, long contentLength, boolean etag)voidputHeaders(HttpContent content, long contentLength, boolean etag)voidreopen()voidreplaceCookie(HttpCookie cookie)Replace (or add) a cookie.voidreset()voidresetBuffer()voidresetContent()voidresetForForward()voidsendError(int sc)voidsendError(int code, java.lang.String message)Send an error response.voidsendProcessing()Sends a 102-Processing response.voidsendRedirect(int code, java.lang.String location)Sends a response with one of the 300 series redirection codes.voidsendRedirect(java.lang.String location)voidsetBufferSize(int size)voidsetCharacterEncoding(java.lang.String encoding)voidsetContentLength(int len)voidsetContentLengthLong(long length)voidsetContentType(java.lang.String contentType)voidsetDateHeader(java.lang.String name, long date)voidsetHeader(java.lang.String name, java.lang.String value)voidsetHeader(HttpHeader name, java.lang.String value)voidsetIntHeader(java.lang.String name, int value)voidsetLocale(java.util.Locale locale)voidsetLongContentLength(long len)voidsetStatus(int sc)voidsetStatus(int sc, java.lang.String sm)Deprecated.voidsetStatusWithReason(int sc, java.lang.String sm)voidsetTrailers(java.util.function.Supplier<HttpFields> trailers)java.lang.StringtoString()static HttpServletResponseunwrap(ServletResponse servletResponse)
-
-
-
Field Detail
-
SET_INCLUDE_HEADER_PREFIX
public static final java.lang.String SET_INCLUDE_HEADER_PREFIX
If a header name starts with this string, the header (stripped of the prefix) can be set during include using onlysetHeader(String, String)oraddHeader(String, String).- See Also:
- Constant Field Values
-
-
Constructor Detail
-
Response
public Response(HttpChannel channel, HttpOutput out)
-
-
Method Detail
-
getHttpChannel
public HttpChannel getHttpChannel()
-
getHttpOutput
public HttpOutput getHttpOutput()
-
reopen
public void reopen()
-
errorClose
public void errorClose()
-
isIncluding
public boolean isIncluding()
-
include
public void include()
-
included
public void included()
-
addCookie
public void addCookie(HttpCookie cookie)
-
replaceCookie
public void replaceCookie(HttpCookie cookie)
Replace (or add) a cookie. Using name, path and domain, look for a matching set-cookie header and replace it.- Parameters:
cookie- The cookie to add/replace
-
addCookie
public void addCookie(Cookie cookie)
- Specified by:
addCookiein interfaceHttpServletResponse
-
containsHeader
public boolean containsHeader(java.lang.String name)
- Specified by:
containsHeaderin interfaceHttpServletResponse
-
encodeURL
public java.lang.String encodeURL(java.lang.String url)
- Specified by:
encodeURLin interfaceHttpServletResponse
-
encodeRedirectURL
public java.lang.String encodeRedirectURL(java.lang.String url)
- Specified by:
encodeRedirectURLin interfaceHttpServletResponse
-
encodeUrl
@Deprecated public java.lang.String encodeUrl(java.lang.String url)
Deprecated.- Specified by:
encodeUrlin interfaceHttpServletResponse
-
encodeRedirectUrl
@Deprecated public java.lang.String encodeRedirectUrl(java.lang.String url)
Deprecated.- Specified by:
encodeRedirectUrlin interfaceHttpServletResponse
-
sendError
public void sendError(int sc) throws java.io.IOException- Specified by:
sendErrorin interfaceHttpServletResponse- Throws:
java.io.IOException
-
sendError
public void sendError(int code, java.lang.String message) throws java.io.IOExceptionSend an error response.In addition to the servlet standard handling, this method supports some additional codes:
- 102
- Send a partial PROCESSING response and allow additional responses
- -1
- Abort the HttpChannel and close the connection/stream
- Specified by:
sendErrorin interfaceHttpServletResponse- Parameters:
code- The error codemessage- The message- Throws:
java.io.IOException- If an IO problem occurred sending the error response.
-
sendProcessing
public void sendProcessing() throws java.io.IOExceptionSends a 102-Processing response. If the connection is an HTTP connection, the version is 1.1 and the request has a Expect header starting with 102, then a 102 response is sent. This indicates that the request still be processed and real response can still be sent. This method is called by sendError if it is passed 102.- Throws:
java.io.IOException- if unable to send the 102 response- See Also:
HttpServletResponse.sendError(int)
-
sendRedirect
public void sendRedirect(int code, java.lang.String location) throws java.io.IOExceptionSends a response with one of the 300 series redirection codes.- Parameters:
code- the redirect status codelocation- the location to send inLocationheaders- Throws:
java.io.IOException- if unable to send the redirect
-
sendRedirect
public void sendRedirect(java.lang.String location) throws java.io.IOException- Specified by:
sendRedirectin interfaceHttpServletResponse- Throws:
java.io.IOException
-
setDateHeader
public void setDateHeader(java.lang.String name, long date)- Specified by:
setDateHeaderin interfaceHttpServletResponse
-
addDateHeader
public void addDateHeader(java.lang.String name, long date)- Specified by:
addDateHeaderin interfaceHttpServletResponse
-
setHeader
public void setHeader(HttpHeader name, java.lang.String value)
-
setHeader
public void setHeader(java.lang.String name, java.lang.String value)- Specified by:
setHeaderin interfaceHttpServletResponse
-
getHeaderNames
public java.util.Collection<java.lang.String> getHeaderNames()
- Specified by:
getHeaderNamesin interfaceHttpServletResponse
-
getHeader
public java.lang.String getHeader(java.lang.String name)
- Specified by:
getHeaderin interfaceHttpServletResponse
-
getHeaders
public java.util.Collection<java.lang.String> getHeaders(java.lang.String name)
- Specified by:
getHeadersin interfaceHttpServletResponse
-
addHeader
public void addHeader(java.lang.String name, java.lang.String value)- Specified by:
addHeaderin interfaceHttpServletResponse
-
setIntHeader
public void setIntHeader(java.lang.String name, int value)- Specified by:
setIntHeaderin interfaceHttpServletResponse
-
addIntHeader
public void addIntHeader(java.lang.String name, int value)- Specified by:
addIntHeaderin interfaceHttpServletResponse
-
setStatus
public void setStatus(int sc)
- Specified by:
setStatusin interfaceHttpServletResponse
-
setStatus
@Deprecated public void setStatus(int sc, java.lang.String sm)Deprecated.- Specified by:
setStatusin interfaceHttpServletResponse
-
setStatusWithReason
public void setStatusWithReason(int sc, java.lang.String sm)
-
getCharacterEncoding
public java.lang.String getCharacterEncoding()
- Specified by:
getCharacterEncodingin interfaceServletResponse
-
getContentType
public java.lang.String getContentType()
- Specified by:
getContentTypein interfaceServletResponse
-
getOutputStream
public ServletOutputStream getOutputStream() throws java.io.IOException
- Specified by:
getOutputStreamin interfaceServletResponse- Throws:
java.io.IOException
-
isWriting
public boolean isWriting()
-
isStreaming
public boolean isStreaming()
-
isWritingOrStreaming
public boolean isWritingOrStreaming()
-
getWriter
public java.io.PrintWriter getWriter() throws java.io.IOException- Specified by:
getWriterin interfaceServletResponse- Throws:
java.io.IOException
-
setContentLength
public void setContentLength(int len)
- Specified by:
setContentLengthin interfaceServletResponse
-
getContentLength
public long getContentLength()
-
isAllContentWritten
public boolean isAllContentWritten(long written)
-
isContentComplete
public boolean isContentComplete(long written)
-
closeOutput
public void closeOutput() throws java.io.IOException- Throws:
java.io.IOException
-
completeOutput
@Deprecated public void completeOutput() throws java.io.IOExceptionDeprecated.UsecloseOutput()close the output- Throws:
java.io.IOException
-
completeOutput
public void completeOutput(Callback callback)
-
getLongContentLength
public long getLongContentLength()
-
setLongContentLength
public void setLongContentLength(long len)
-
setContentLengthLong
public void setContentLengthLong(long length)
- Specified by:
setContentLengthLongin interfaceServletResponse
-
setCharacterEncoding
public void setCharacterEncoding(java.lang.String encoding)
- Specified by:
setCharacterEncodingin interfaceServletResponse
-
setContentType
public void setContentType(java.lang.String contentType)
- Specified by:
setContentTypein interfaceServletResponse
-
setBufferSize
public void setBufferSize(int size)
- Specified by:
setBufferSizein interfaceServletResponse
-
getBufferSize
public int getBufferSize()
- Specified by:
getBufferSizein interfaceServletResponse
-
flushBuffer
public void flushBuffer() throws java.io.IOException- Specified by:
flushBufferin interfaceServletResponse- Throws:
java.io.IOException
-
reset
public void reset()
- Specified by:
resetin interfaceServletResponse
-
resetContent
public void resetContent()
-
resetForForward
public void resetForForward()
-
resetBuffer
public void resetBuffer()
- Specified by:
resetBufferin interfaceServletResponse
-
setTrailers
public void setTrailers(java.util.function.Supplier<HttpFields> trailers)
-
getTrailers
public java.util.function.Supplier<HttpFields> getTrailers()
-
getCommittedMetaData
public MetaData.Response getCommittedMetaData()
Get the MetaData.Response committed for this response. This may differ from the meta data in this response for exceptional responses (eg 4xx and 5xx responses generated by the container) and the committedMetaData should be used for logging purposes.- Returns:
- The committed MetaData or a
newResponseMetaData()if not yet committed.
-
isCommitted
public boolean isCommitted()
- Specified by:
isCommittedin interfaceServletResponse
-
setLocale
public void setLocale(java.util.Locale locale)
- Specified by:
setLocalein interfaceServletResponse
-
getLocale
public java.util.Locale getLocale()
- Specified by:
getLocalein interfaceServletResponse
-
getStatus
public int getStatus()
- Specified by:
getStatusin interfaceHttpServletResponse
-
getReason
public java.lang.String getReason()
-
getHttpFields
public HttpFields getHttpFields()
-
getContentCount
public long getContentCount()
-
toString
public java.lang.String toString()
- Overrides:
toStringin classjava.lang.Object
-
putHeaders
public void putHeaders(HttpContent content, long contentLength, boolean etag)
-
putHeaders
public static void putHeaders(HttpServletResponse response, HttpContent content, long contentLength, boolean etag)
-
unwrap
public static HttpServletResponse unwrap(ServletResponse servletResponse)
-
-