パッケージ jakarta.servlet

インターフェース WriteListener

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

  • メソッドのサマリー

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

  • メソッドの詳細

    • onWritePossible

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

    • onError

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