Overrides default org.eclipse.jetty.http3.api.Stream.Server.Listener.onDataAvailable.

Doc from org.eclipse.jetty.http3.api.Stream.Server.Listener.onDataAvailable.

Callback method invoked if the application has expressed demand for content, and if there may be content available.

A server application that wishes to handle request content should typically call Stream#demand() from Session.Server.Listener#onRequest(Server, HeadersFrame).

A client application that wishes to handle response content should typically call Stream#demand() from Stream.Client.Listener#onResponse(Client, HeadersFrame).

Just prior calling this method, the outstanding demand is cancelled; applications that implement this method should read content calling Stream#readData(), and call Stream#demand() to signal to the implementation to call again this method when there may be more content available.

Only one thread at a time invokes this method, although it may not be the same thread across different invocations.

It is always guaranteed that invoking Stream#demand() from within this method will not cause a StackOverflowError.

Typical usage:

class MyStreamListener implements Stream.Server.Listener
{
    @Override
    public void onDataAvailable(Stream.Server stream)
    {
        // Read a chunk of the content.
        Stream.Data data = stream.readData();
        if (data == null)
        {
            // No data available now, demand to be called back.
            stream.demand();
        }
        else
        {
            // Process the content.
            process(data.getByteBuffer());
            // Notify that the content has been consumed.
            data.release();
            if (!data.isLast())
            {
                // Demand to be called back.
                stream.demand();
            }
        }
    }
}

Annotations

@Override

Overrides default org.eclipse.jetty.http3.api.Stream.Server.Listener.onFailure.

Doc from org.eclipse.jetty.http3.api.Stream.Server.Listener.onFailure.

Callback method invoked when a stream failure occurred.

Typical stream failures, among others, are failures to decode a HEADERS frame, or failures to read bytes because the stream has been reset.

Annotations

@Override

Overrides default org.eclipse.jetty.http3.api.Stream.Server.Listener.onIdleTimeout.

Doc from org.eclipse.jetty.http3.api.Stream.Server.Listener.onIdleTimeout.

Callback method invoked when the stream idle timeout elapses.

Annotations

@Override

Overrides default org.eclipse.jetty.http3.api.Stream.Server.Listener.onTrailer.

Doc from org.eclipse.jetty.http3.api.Stream.Server.Listener.onTrailer.

Callback method invoked when a trailer is received.

Annotations

@Override