パッケージ jakarta.servlet

インターフェース ReadListener

  • すべてのスーパーインターフェース:
    EventListenerSE
    public interface ReadListener
extends EventListenerSE

    このクラスは、HTTP リクエストデータがブロックなしで読み取れるようになると、実装に通知するコールバックメカニズムを表します。

    導入:
    Servlet 3.1

    • メソッドのサマリー

      すべてのメソッド   インスタンスメソッド   抽象メソッド  
      修飾子と型 メソッド 説明
      voidonAllDataRead()
      現在のリクエストのすべてのデータが読み取られたときに呼び出されます。
      voidonDataAvailable()
      ReadListener のインスタンスが ServletInputStream に登録されている場合、このメソッドは、データを読み取ることができるときに、コンテナーによって最初に呼び出されます。
      voidonError​(ThrowableSE t)
      リクエストの処理中にエラーが発生したときに呼び出されます。

    • メソッドの詳細

      • onDataAvailable

        void onDataAvailable()
              throws IOExceptionSE
        ReadListener のインスタンスが ServletInputStream に登録されている場合、このメソッドは、データを読み取ることができるときに、コンテナーによって最初に呼び出されます。その後、コンテナーは、ServletInputStream.isReady() メソッドが呼び出され、false の値を返し、その後データを読み取ることができるようになった場合にのみ、このメソッドを呼び出します。
        例外:
        IOExceptionSE - 処理中に I/O 関連のエラーが発生した場合

      • onAllDataRead

        void onAllDataRead()
            throws IOExceptionSE
        現在のリクエストのすべてのデータが読み取られたときに呼び出されます。
        例外:
        IOExceptionSE - 処理中に I/O 関連のエラーが発生した場合

      • onError

        void onError​(ThrowableSE t)
        リクエストの処理中にエラーが発生したときに呼び出されます。
        パラメーター:
        t - 読み取り操作が失敗した理由を示すスロー可能オブジェクト