パッケージ jakarta.servlet

インターフェース WriteListener

  • すべてのスーパーインターフェース:
    EventListenerSE
    public interface WriteListener
extends EventListenerSE
    ブロックせずにコンテンツを書き込むことができることを開発者に知らせるコールバック通知メカニズム。
    導入:
    Servlet 3.1

    • メソッドのサマリー

      すべてのメソッド   インスタンスメソッド   抽象メソッド  
      修飾子と型 メソッド 説明
      voidonError​(ThrowableSE t)
      ノンブロッキング API を使用してデータを書き込むときにエラーが発生すると呼び出されます。
      voidonWritePossible()
      WriteListener のインスタンスが ServletOutputStream に登録されている場合、このメソッドは、データを書き込むことができるときにコンテナーによって初めて呼び出されます。

    • メソッドの詳細

      • onWritePossible

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

      • onError

        void onError​(ThrowableSE t)
        ノンブロッキング API を使用してデータを書き込むときにエラーが発生すると呼び出されます。
        パラメーター:
        t - 書き込み操作が失敗した理由を示すスロー可能オブジェクト