org.eclipse.jetty.http2.api

Interface Stream.Listener

All Known Implementing Classes:

Stream.Listener.Adapter

Enclosing interface:

Stream

public static interface Stream.Listener

A Stream.Listener is the passive counterpart of a Stream and receives events happening on a HTTP/2 stream.

See Also:

Stream

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Stream.Listener.Adapter Empty implementation of Stream.Listener

Method Summary

Modifier and Type	Method and Description
void	onData(Stream stream, DataFrame frame, Callback callback) Callback method invoked when a DATA frame has been received.
void	onHeaders(Stream stream, HeadersFrame frame) Callback method invoked when a HEADERS frame representing the HTTP response has been received.
default boolean	onIdleTimeout(Stream stream, Throwable x) Callback method invoked when the stream exceeds its idle timeout.
Stream.Listener	onPush(Stream stream, PushPromiseFrame frame) Callback method invoked when a PUSH_PROMISE frame has been received.
void	onReset(Stream stream, ResetFrame frame) Callback method invoked when a RST_STREAM frame has been received for this stream.
default void	onTimeout(Stream stream, Throwable x) Deprecated. use onIdleTimeout(Stream, Throwable) instead

Method Detail

onHeaders

void onHeaders(Stream stream,
               HeadersFrame frame)

Callback method invoked when a HEADERS frame representing the HTTP response has been received.

Parameters:

stream - the stream

frame - the HEADERS frame received

onPush

Stream.Listener onPush(Stream stream,
                       PushPromiseFrame frame)

Callback method invoked when a PUSH_PROMISE frame has been received.

Parameters:

stream - the stream

frame - the PUSH_PROMISE frame received

Returns:

a Stream.Listener that will be notified of pushed stream events

onData

void onData(Stream stream,
            DataFrame frame,
            Callback callback)

Callback method invoked when a DATA frame has been received.

Parameters:

stream - the stream

frame - the DATA frame received

callback - the callback to complete when the bytes of the DATA frame have been consumed

onReset

void onReset(Stream stream,
             ResetFrame frame)

Callback method invoked when a RST_STREAM frame has been received for this stream.

Parameters:

stream - the stream

frame - the RST_FRAME received

See Also:

Session.Listener.onReset(Session, ResetFrame)

onTimeout

@Deprecated
default void onTimeout(Stream stream,
                                   Throwable x)

Deprecated. use onIdleTimeout(Stream, Throwable) instead

Callback method invoked when the stream exceeds its idle timeout.

Parameters:

stream - the stream

x - the timeout failure

See Also:

Stream.getIdleTimeout()

onIdleTimeout

default boolean onIdleTimeout(Stream stream,
                              Throwable x)

Callback method invoked when the stream exceeds its idle timeout.

Parameters:

stream - the stream

x - the timeout failure

Returns:

true to reset the stream, false to ignore the idle timeout

See Also:

Stream.getIdleTimeout()