Package org.eclipse.jetty.http3.server.internal

Class HttpStreamOverHTTP3

java.lang.Object

org.eclipse.jetty.http3.server.internal.HttpStreamOverHTTP3

All Implemented Interfaces:

HttpStream, Callback, Invocable

public class HttpStreamOverHTTP3
extends Object
implements HttpStream

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.Callback

Callback.Completable, Callback.Completing, Callback.Nested

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

HttpStream.Wrapper

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.thread.Invocable

Invocable.Callable, Invocable.InvocationType, Invocable.ReadyTask, Invocable.Task

Field Summary

Fields inherited from interface org.eclipse.jetty.util.Callback

NOOP

Fields inherited from interface org.eclipse.jetty.server.HttpStream

CONTENT_NOT_CONSUMED, UPGRADE_CONNECTION_ATTRIBUTE

Fields inherited from interface org.eclipse.jetty.util.thread.Invocable

__nonBlocking

Constructor Summary

Constructors

Constructor	Description
HttpStreamOverHTTP3(ServerHTTP3StreamConnection connection, HttpChannel httpChannel, HTTP3StreamServer stream)

Method Summary

Modifier and Type	Method	Description
Throwable	consumeAvailable()
void	demand()	Demands more content chunks to the underlying implementation.
void	failed(Throwable x)	Callback invoked when the operation fails.
String	getId()
long	getIdleTimeout()
boolean	isCommitted()
boolean	isIdle()
Runnable	onDataAvailable()
Runnable	onFailure(Throwable failure)
void	onIdleTimeout(TimeoutException failure, BiConsumer<Runnable,Boolean> consumer)
Runnable	onRequest(HeadersFrame frame)
Runnable	onTrailer(HeadersFrame frame)
void	prepareResponse(HttpFields.Mutable headers)	Prepare the response headers with respect to the stream.
Content.Chunk	read()	Reads a chunk of content, with the same semantic as Content.Source.read().
void	send(MetaData.Request request, MetaData.Response response, boolean last, ByteBuffer byteBuffer, Callback callback)	Send response meta-data and/or data.
void	setIdleTimeout(long idleTimeoutMs)
void	succeeded()	Callback invoked when the operation completes.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.Callback

completeWith

Methods inherited from interface org.eclipse.jetty.server.HttpStream

getTunnelSupport, push

Methods inherited from interface org.eclipse.jetty.util.thread.Invocable

getInvocationType

Constructor Details

HttpStreamOverHTTP3

public HttpStreamOverHTTP3(ServerHTTP3StreamConnection connection,
 HttpChannel httpChannel,
 HTTP3StreamServer stream)

Method Details

getId

public String getId()

Specified by:

getId in interface HttpStream

Returns:

an ID unique within the lifetime scope of the associated protocol connection. This may be a protocol ID (e.g. HTTP/2 stream ID) or it may be unrelated to the protocol.

onRequest

public Runnable onRequest(HeadersFrame frame)

read

public Content.Chunk read()

Description copied from interface: HttpStream

Reads a chunk of content, with the same semantic as Content.Source.read().

This method is called from the implementation of Request.read().

Specified by:

read in interface HttpStream

Returns:

a chunk of content, possibly with non-null Content.Chunk.getFailure() or null.

demand

public void demand()

Description copied from interface: HttpStream

Demands more content chunks to the underlying implementation.

This method is called from the implementation of Request.demand(Runnable) and when the demand can be satisfied the implementation must call HttpChannel.onContentAvailable(). If there is a problem meeting demand, then the implementation must call HttpChannel.onFailure(Throwable).

Specified by:

demand in interface HttpStream

See Also:

• HttpChannel.onContentAvailable()
• HttpChannel.onFailure(Throwable)

onDataAvailable

public Runnable onDataAvailable()

onTrailer

public Runnable onTrailer(HeadersFrame frame)

prepareResponse

public void prepareResponse(HttpFields.Mutable headers)

Description copied from interface: HttpStream

Prepare the response headers with respect to the stream. Typically this may set headers related to protocol specific behaviour (e.g. Keep-Alive for HTTP/1.0 connections).

Specified by:

prepareResponse in interface HttpStream

Parameters:

headers - The headers to prepare.

send

public void send(MetaData.Request request,
 MetaData.Response response,
 boolean last,
 ByteBuffer byteBuffer,
 Callback callback)

Description copied from interface: HttpStream

Send response meta-data and/or data.

Specified by:

send in interface HttpStream

Parameters:

request - The request metadata for which the response should be sent.

response - The response metadata to be sent or null if the response is already committed by a previous call to send.

last - True if this will be the last call to send and the response can be completed.

byteBuffer - A buffer of content to send or null if no content.

callback - The callback to invoke when the send is completed successfully or in failure.

getIdleTimeout

public long getIdleTimeout()

Specified by:

getIdleTimeout in interface HttpStream

setIdleTimeout

public void setIdleTimeout(long idleTimeoutMs)

Specified by:

setIdleTimeout in interface HttpStream

isCommitted

public boolean isCommitted()

Specified by:

isCommitted in interface HttpStream

consumeAvailable

public Throwable consumeAvailable()

Specified by:

consumeAvailable in interface HttpStream

isIdle

public boolean isIdle()

succeeded

public void succeeded()

Description copied from interface: Callback

Callback invoked when the operation completes.

Specified by:

succeeded in interface Callback

See Also:

• Callback.failed(Throwable)

failed

public void failed(Throwable x)

Description copied from interface: Callback

Callback invoked when the operation fails.

Specified by:

failed in interface Callback

Parameters:

x - the reason for the operation failure

onIdleTimeout

public void onIdleTimeout(TimeoutException failure,
 BiConsumer<Runnable,Boolean> consumer)

onFailure

public Runnable onFailure(Throwable failure)