Package io.micronaut.http.body.stream

Class LazyUpstream

java.lang.Object
io.micronaut.http.body.stream.LazyUpstream
All Implemented Interfaces:
BufferConsumer.Upstream
@Internal public final class LazyUpstream extends Object implements BufferConsumer.Upstream
BufferConsumer.Upstream implementation that stores any inputs and then forwards them to another upstream later on. This helps with reentrant calls to the subscriber during a subscribe call, when the real upstream is not yet available.
Since:
4.8.0
Author:
Jonas Konrad

  • Constructor Details

    • LazyUpstream

      public LazyUpstream()

  • Method Details

    • start

      public void start()
      Description copied from interface: BufferConsumer.Upstream
      Signal that we want to start consuming bytes. This is an optional hint to the upstream, the upstream may ignore it and send bytes immediately. This is used for CONTINUE support.
      Specified by:
      start in interface BufferConsumer.Upstream

    • onBytesConsumed

      public void onBytesConsumed(long bytesConsumed)
      Description copied from interface: BufferConsumer.Upstream
      Called when a number of bytes has been consumed by the downstream. Note that this can exceed the actual number of bytes written so far, if the downstream wants to signal it is ready consume much more data.
      Specified by:
      onBytesConsumed in interface BufferConsumer.Upstream
      Parameters:
      bytesConsumed - The number of bytes that were consumed

    • allowDiscard

      public void allowDiscard()
      Description copied from interface: BufferConsumer.Upstream
      Allow the upstream to discard any further messages. Note that this does not actually mean the messages must be discarded: If another consumer still needs the body data, it may continue to be read and continue to be forwarded to this consumer.
      Specified by:
      allowDiscard in interface BufferConsumer.Upstream

    • disregardBackpressure

      public void disregardBackpressure()
      Description copied from interface: BufferConsumer.Upstream
      Instruct the upstream to ignore backpressure from this consumer. This is slightly different from onBytesConsumed(Long.MAX_VALUE): If there are two consumers in ByteBody.SplitBackpressureMode.FASTEST mode, a MAX_VALUE requests all data from the common upstream, while a disregardBackpressure removes this downstream from consideration.
      Specified by:
      disregardBackpressure in interface BufferConsumer.Upstream

    • forward

      public void forward(BufferConsumer.Upstream actual)