Module org.eclipse.jetty.server

Package org.eclipse.jetty.server

Class Response.Wrapper

java.lang.Object

org.eclipse.jetty.server.Response.Wrapper

All Implemented Interfaces:

org.eclipse.jetty.io.Content.Sink, Response

Direct Known Subclasses:

ContextResponse, GzipResponseAndCallback, StatisticsHandler.MinimumDataRateHandler.MinimumDataRateResponse

Enclosing interface:

Response

public static class Response.Wrapper
extends Object
implements Response

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.server.Response

Response.Wrapper

Constructor Summary

Constructors

Constructor	Description
Wrapper(Request request, Response wrapped)

Method Summary

Modifier and Type	Method	Description
org.eclipse.jetty.http.HttpFields.Mutable	getHeaders()
Request	getRequest()
int	getStatus()
Supplier<org.eclipse.jetty.http.HttpFields>	getTrailersSupplier()
Response	getWrapped()
boolean	hasLastWrite()	Returns whether the last write has been initiated on the response.
boolean	isCommitted()	Returns whether this response has already been committed.
boolean	isCompletedSuccessfully()	Returns whether the response completed successfully.
void	reset()	Resets this response, clearing the HTTP status code, HTTP headers and HTTP trailers.
void	setStatus(int code)	Set the response HTTP status code.
void	setTrailersSupplier(Supplier<org.eclipse.jetty.http.HttpFields> trailers)	Sets the supplier for the HTTP trailers.
void	write(boolean last, ByteBuffer byteBuffer, org.eclipse.jetty.util.Callback callback)
CompletableFuture<Void>	writeInterim(int status, org.eclipse.jetty.http.HttpFields headers)	Writes an HTTP interim response, with the given HTTP status code and HTTP headers.

Methods inherited from class java.lang.Object

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

Constructor Details

Wrapper

public Wrapper(Request request,
 Response wrapped)

Method Details

getWrapped

public Response getWrapped()

getRequest

public Request getRequest()

Specified by:

getRequest in interface Response

Returns:

the Request associated with this Response

getStatus

public int getStatus()

Specified by:

getStatus in interface Response

Returns:

the response HTTP status code

setStatus

public void setStatus(int code)

Description copied from interface: Response

Set the response HTTP status code.

Specified by:

setStatus in interface Response

Parameters:

code - the response HTTP status code

getHeaders

public org.eclipse.jetty.http.HttpFields.Mutable getHeaders()

Specified by:

getHeaders in interface Response

Returns:

the response HTTP headers

getTrailersSupplier

public Supplier<org.eclipse.jetty.http.HttpFields> getTrailersSupplier()

Specified by:

getTrailersSupplier in interface Response

Returns:

a supplier for the HTTP trailers

setTrailersSupplier

public void setTrailersSupplier(Supplier<org.eclipse.jetty.http.HttpFields> trailers)

Description copied from interface: Response

Sets the supplier for the HTTP trailers.

The method Supplier.get() may be called by the implementation multiple times, so it is important that the same value is returned in every invocation.

Example:

 // Correct usage.
 HttpFields.Mutable trailers = HttpFields.build();
 response.setTrailersSupplier(() -> trailers);

 // WRONG usage, as the value changes for
 // every invocation of supplier.get().
 response.setTrailersSupplier(() -> HttpFields.build());
 

Specified by:

setTrailersSupplier in interface Response

Parameters:

trailers - a supplier for the HTTP trailers

isCommitted

public boolean isCommitted()

Description copied from interface: Response

Returns whether this response has already been committed.

Committing a response means that the HTTP status code and HTTP headers cannot be modified anymore, typically because they have already been serialized and sent over the network.

Specified by:

isCommitted in interface Response

Returns:

whether this response has already been committed

hasLastWrite

public boolean hasLastWrite()

Description copied from interface: Response

Returns whether the last write has been initiated on the response.

Specified by:

hasLastWrite in interface Response

Returns:

true if last==true has been passed to Response.write(boolean, ByteBuffer, Callback).

isCompletedSuccessfully

public boolean isCompletedSuccessfully()

Description copied from interface: Response

Returns whether the response completed successfully.

The response HTTP status code, HTTP headers and content have been successfully serialized and sent over the network without errors.

Specified by:

isCompletedSuccessfully in interface Response

Returns:

whether the response completed successfully

reset

public void reset()

Description copied from interface: Response

Resets this response, clearing the HTTP status code, HTTP headers and HTTP trailers.

Specified by:

reset in interface Response

writeInterim

public CompletableFuture<Void> writeInterim(int status,
 org.eclipse.jetty.http.HttpFields headers)

Description copied from interface: Response

Writes an HTTP interim response, with the given HTTP status code and HTTP headers.

It is possible to write more than one interim response, for example in case of HttpStatus.EARLY_HINTS_103.

The returned CompletableFuture is notified of the result of this write, whether it succeeded or failed.

Specified by:

writeInterim in interface Response

Parameters:

status - the interim HTTP status code

headers - the HTTP headers

Returns:

a CompletableFuture with the result of the write

write

public void write(boolean last,
 ByteBuffer byteBuffer,
 org.eclipse.jetty.util.Callback callback)

Description copied from interface: Response

The invocation of the passed Callback is serialized with previous calls of this method, so that it is not invoked until any invocation of the callback of a previous call to this method has returned.

Thus a Callback should not block waiting for a callback of a future call to this method.

Specified by:

write in interface org.eclipse.jetty.io.Content.Sink

Specified by:

write in interface Response

Parameters:

last - whether the ByteBuffer is the last to write

byteBuffer - the ByteBuffer to write

callback - the callback to notify when the write operation is complete