org.eclipse.jetty.server

Class Response

java.lang.Object

org.eclipse.jetty.server.Response

public class Response
extends java.lang.Object

Response provides the implementation for HttpServletResponse.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Response.OutputType

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	HTTP_ONLY_COMMENT If this string is found within the comment of a cookie added with addCookie(Cookie), then the cookie will be set as HTTP ONLY.
static 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 only #setHeader(String, String) or addHeader(String, String).

Constructor Summary

Constructors

Constructor and Description
Response(HttpChannel channel, HttpOutput out)

Method Summary

Modifier and Type	Method and Description
void	addCookie(Cookie cookie)
void	addCookie(HttpCookie cookie)
void	addDateHeader(java.lang.String name, long date)
void	addHeader(java.lang.String name, java.lang.String value)
void	addIntHeader(java.lang.String name, int value)
void	addSetRFC2965Cookie(java.lang.String name, java.lang.String value, java.lang.String domain, java.lang.String path, long maxAge, java.lang.String comment, boolean isSecure, boolean isHttpOnly, int version) Format a set cookie value
void	addSetRFC6265Cookie(java.lang.String name, java.lang.String value, java.lang.String domain, java.lang.String path, long maxAge, boolean isSecure, boolean isHttpOnly) Format a set cookie value by RFC6265
void	closeOutput()
boolean	containsHeader(java.lang.String name)
java.lang.String	encodeRedirectUrl(java.lang.String url) Deprecated.
java.lang.String	encodeRedirectURL(java.lang.String url)
java.lang.String	encodeUrl(java.lang.String url) Deprecated.
java.lang.String	encodeURL(java.lang.String url)
void	flushBuffer()
int	getBufferSize()
java.lang.String	getCharacterEncoding()
MetaData.Response	getCommittedMetaData() Get the MetaData.Response committed for this response.
long	getContentCount()
long	getContentLength()
java.lang.String	getContentType()
java.lang.String	getHeader(java.lang.String name)
java.util.Collection<java.lang.String>	getHeaderNames()
java.util.Collection<java.lang.String>	getHeaders(java.lang.String name)
HttpChannel	getHttpChannel()
HttpFields	getHttpFields()
HttpOutput	getHttpOutput()
java.util.Locale	getLocale()
long	getLongContentLength()
ServletOutputStream	getOutputStream()
java.lang.String	getReason()
int	getStatus()
java.util.function.Supplier<HttpFields>	getTrailers()
java.io.PrintWriter	getWriter()
void	include()
void	included()
boolean	isAllContentWritten(long written)
boolean	isCommitted()
boolean	isContentComplete(long written)
boolean	isIncluding()
boolean	isWriting()
protected MetaData.Response	newResponseMetaData()
void	putHeaders(HttpContent content, long contentLength, boolean etag)
static void	putHeaders(HttpServletResponse response, HttpContent content, long contentLength, boolean etag)
protected void	recycle()
void	reset()
void	reset(boolean preserveCookies)
void	resetBuffer()
void	resetForForward()
void	sendError(int sc)
void	sendError(int code, java.lang.String message)
void	sendProcessing() Sends a 102-Processing response.
void	sendRedirect(int code, java.lang.String location) Sends a response with one of the 300 series redirection codes.
void	sendRedirect(java.lang.String location)
void	setBufferSize(int size)
void	setCharacterEncoding(java.lang.String encoding)
void	setContentLength(int len)
void	setContentLengthLong(long length)
void	setContentType(java.lang.String contentType)
void	setDateHeader(java.lang.String name, long date)
void	setHeader(HttpHeader name, java.lang.String value)
void	setIntHeader(java.lang.String name, int value)
void	setLocale(java.util.Locale locale)
void	setLongContentLength(long len)
void	setStatus(int sc)
void	setStatus(int sc, java.lang.String sm) Deprecated.
void	setStatusWithReason(int sc, java.lang.String sm)
void	setTrailers(java.util.function.Supplier<HttpFields> trailers)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

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 only #setHeader(String, String) or addHeader(String, String).

See Also:

Constant Field Values

HTTP_ONLY_COMMENT

public static final java.lang.String HTTP_ONLY_COMMENT

If this string is found within the comment of a cookie added with addCookie(Cookie), then the cookie will be set as HTTP ONLY.

See Also:

Constant Field Values

Constructor Detail

Response

public Response(HttpChannel channel,
                HttpOutput out)

Method Detail

getHttpChannel

public HttpChannel getHttpChannel()

recycle

protected void recycle()

getHttpOutput

public HttpOutput getHttpOutput()

isIncluding

public boolean isIncluding()

include

public void include()

included

public void included()

addCookie

public void addCookie(HttpCookie cookie)

addCookie

public void addCookie(Cookie cookie)

addSetRFC6265Cookie

public void addSetRFC6265Cookie(java.lang.String name,
                                java.lang.String value,
                                java.lang.String domain,
                                java.lang.String path,
                                long maxAge,
                                boolean isSecure,
                                boolean isHttpOnly)

Format a set cookie value by RFC6265

Parameters:

name - the name

value - the value

domain - the domain

path - the path

maxAge - the maximum age

isSecure - true if secure cookie

isHttpOnly - true if for http only

addSetRFC2965Cookie

public void addSetRFC2965Cookie(java.lang.String name,
                                java.lang.String value,
                                java.lang.String domain,
                                java.lang.String path,
                                long maxAge,
                                java.lang.String comment,
                                boolean isSecure,
                                boolean isHttpOnly,
                                int version)

Format a set cookie value

Parameters:

name - the name

value - the value

domain - the domain

path - the path

maxAge - the maximum age

comment - the comment (only present on versions > 0)

isSecure - true if secure cookie

isHttpOnly - true if for http only

version - version of cookie logic to use (0 == default behavior)

containsHeader

public boolean containsHeader(java.lang.String name)

encodeURL

public java.lang.String encodeURL(java.lang.String url)

encodeRedirectURL

public java.lang.String encodeRedirectURL(java.lang.String url)

encodeUrl

@Deprecated
public java.lang.String encodeUrl(java.lang.String url)

Deprecated.

encodeRedirectUrl

@Deprecated
public java.lang.String encodeRedirectUrl(java.lang.String url)

Deprecated.

sendError

public void sendError(int sc)
               throws java.io.IOException

Throws:

java.io.IOException

sendError

public void sendError(int code,
                      java.lang.String message)
               throws java.io.IOException

Throws:

java.io.IOException

sendProcessing

public void sendProcessing()
                    throws java.io.IOException

Sends a 102-Processing response. If the connection is a 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:

javax.servlet.http.HttpServletResponse#sendError(int)

sendRedirect

public void sendRedirect(int code,
                         java.lang.String location)
                  throws java.io.IOException

Sends a response with one of the 300 series redirection codes.

Parameters:

code - the redirect status code

location - the location to send in Location headers

Throws:

java.io.IOException - if unable to send the redirect

sendRedirect

public void sendRedirect(java.lang.String location)
                  throws java.io.IOException

Throws:

java.io.IOException

setDateHeader

public void setDateHeader(java.lang.String name,
                          long date)

addDateHeader

public void addDateHeader(java.lang.String name,
                          long date)

setHeader

public void setHeader(HttpHeader name,
                      java.lang.String value)

getHeaderNames

public java.util.Collection<java.lang.String> getHeaderNames()

getHeader

public java.lang.String getHeader(java.lang.String name)

getHeaders

public java.util.Collection<java.lang.String> getHeaders(java.lang.String name)

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String value)

setIntHeader

public void setIntHeader(java.lang.String name,
                         int value)

addIntHeader

public void addIntHeader(java.lang.String name,
                         int value)

setStatus

public void setStatus(int sc)

setStatus

@Deprecated
public void setStatus(int sc,
                                  java.lang.String sm)

Deprecated.

setStatusWithReason

public void setStatusWithReason(int sc,
                                java.lang.String sm)

getCharacterEncoding

public java.lang.String getCharacterEncoding()

getContentType

public java.lang.String getContentType()

getOutputStream

public ServletOutputStream getOutputStream()
                                    throws java.io.IOException

Throws:

java.io.IOException

isWriting

public boolean isWriting()

getWriter

public java.io.PrintWriter getWriter()
                              throws java.io.IOException

Throws:

java.io.IOException

setContentLength

public void setContentLength(int len)

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

getLongContentLength

public long getLongContentLength()

setLongContentLength

public void setLongContentLength(long len)

setContentLengthLong

public void setContentLengthLong(long length)

setCharacterEncoding

public void setCharacterEncoding(java.lang.String encoding)

setContentType

public void setContentType(java.lang.String contentType)

setBufferSize

public void setBufferSize(int size)

getBufferSize

public int getBufferSize()

flushBuffer

public void flushBuffer()
                 throws java.io.IOException

Throws:

java.io.IOException

reset

public void reset()

reset

public void reset(boolean preserveCookies)

resetForForward

public void resetForForward()

resetBuffer

public void resetBuffer()

setTrailers

public void setTrailers(java.util.function.Supplier<HttpFields> trailers)

getTrailers

public java.util.function.Supplier<HttpFields> getTrailers()

newResponseMetaData

protected MetaData.Response newResponseMetaData()

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()

setLocale

public void setLocale(java.util.Locale locale)

getLocale

public java.util.Locale getLocale()

getStatus

public int getStatus()

getReason

public java.lang.String getReason()

getHttpFields

public HttpFields getHttpFields()

getContentCount

public long getContentCount()

toString

public java.lang.String toString()

Overrides:

toString in class java.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)