程序包 cn.taketoday.http.server.reactive

类 AbstractListenerReadPublisher<T>

java.lang.Object
cn.taketoday.http.server.reactive.AbstractListenerReadPublisher<T>
类型参数:
T - the type of element signaled
所有已实现的接口:
org.reactivestreams.Publisher<T>
直接已知子类:
ServletServerHttpRequest.RequestBodyPublisher, UndertowServerHttpRequest.RequestBodyPublisher
public abstract class AbstractListenerReadPublisher<T> extends Object implements org.reactivestreams.Publisher<T>
Abstract base class for Publisher implementations that bridge between event-listener read APIs and Reactive Streams.

Specifically a base class for reading from the HTTP request body with Servlet 3.1 non-blocking I/O and Undertow XNIO as well as handling incoming WebSocket messages with standard Java WebSocket (JSR-356), Jetty, and Undertow.

从以下版本开始:
4.0
作者:
Arjen Poutsma, Violeta Georgieva, Rossen Stoyanchev

  • 字段详细资料

  • 构造器详细资料

    • AbstractListenerReadPublisher

      public AbstractListenerReadPublisher()

    • AbstractListenerReadPublisher

      public AbstractListenerReadPublisher(String logPrefix)
      Create an instance with the given log prefix.

  • 方法详细资料

    • getLogPrefix

      public String getLogPrefix()
      Return the configured log message prefix.

    • subscribe

      public void subscribe(org.reactivestreams.Subscriber<? super T> subscriber)
      指定者:
      subscribe 在接口中 org.reactivestreams.Publisher<T>

    • onDataAvailable

      public final void onDataAvailable()
      Invoked when reading is possible, either in the same thread after a check via checkOnDataAvailable(), or as a callback from the underlying container.

    • onAllDataRead

      public void onAllDataRead()
      Sub-classes can call this method to delegate a contain notification when all data has been read.

    • onError

      public final void onError(Throwable ex)
      Sub-classes can call this to delegate container error notifications.

    • checkOnDataAvailable

      protected abstract void checkOnDataAvailable()
      Check if data is available and either call onDataAvailable() immediately or schedule a notification.

    • read

      @Nullable protected abstract T read() throws IOException
      Read once from the input, if possible.
      返回:
      the item that was read; or null
      抛出:
      IOException

    • readingPaused

      protected abstract void readingPaused()
      Invoked when reading is paused due to a lack of demand.

      Note: This method is guaranteed not to compete with checkOnDataAvailable() so it can be used to safely suspend reading, if the underlying API supports it, i.e. without competing with an implicit call to resume via checkOnDataAvailable().

    • discardData

      protected abstract void discardData()
      Invoked after an I/O read error from the underlying server or after a cancellation signal from the downstream consumer to allow sub-classes to discard any current cached data they might have.

    • readAndPublish

      private boolean readAndPublish() throws IOException
      Read and publish data one at a time until there is no more data, no more demand, or perhaps we completed meanwhile.
      返回:
      true if there is more demand; false if there is no more demand or we have completed.
      抛出:
      IOException

    • changeState

      private boolean changeState(AbstractListenerReadPublisher.State oldState, AbstractListenerReadPublisher.State newState)

    • changeToDemandState

      private void changeToDemandState(AbstractListenerReadPublisher.State oldState)

    • handlePendingCompletionOrError

      private boolean handlePendingCompletionOrError()

    • createSubscription

      private org.reactivestreams.Subscription createSubscription()