パッケージ jakarta.faces.component

インターフェース ActionSource

すべての既知のサブインターフェース:
ActionSource2
すべての既知の実装クラス:
HtmlCommandButtonHtmlCommandLinkHtmlCommandScriptUICommandUIViewAction

public interface ActionSource

ActionSource は、デフォルトの ActionListener メカニズムを介してアプリケーションアクションを呼び出す機能を含む、ActionEvent のソースになりたい具体的な UIComponent によって実装できるインターフェースです。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    新しい ActionListener を、ActionEvent の発生時に通知を受けることに関心のあるリスナーのセットに追加します。
    immediate プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値適用フェーズまたはアプリケーションの呼び出しフェーズ中に、ユーザーがこの UIComponent をアクティブ化した場合、呼び出されるアプリケーションアクションを指す MethodExpression を返します。
    この ActionSource インスタンスに登録されている ActionListener のセットを返します。
    boolean
    アプリケーション呼び出しフェーズまで待つのではなく、Jakarta Faces 実装によって提供されるデフォルトの ActionListener をすぐに(つまり、リクエスト処理ライフサイクルのリクエスト値の適用フェーズ中に)実行する必要があることを示すフラグを返します。
    void
    ActionEvent の発生時に通知を受けることに関心のあるリスナーのセットから既存の ActionListener(存在する場合)を削除します。
    default void
    immediate プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値適用フェーズまたはアプリケーションの呼び出しフェーズ中に、この UIComponent がユーザーによってアクティブ化された場合に呼び出されるアプリケーションアクションを指す MethodExpression を設定します。
    void
    setImmediate(boolean immediate)
    この UIComponent の「即時実行」フラグを設定します。
  • メソッドの詳細

    • isImmediate

      boolean isImmediate()

      Jakarta Faces 実装によって提供されるデフォルトの ActionListener が、アプリケーション呼び出しフェーズまで待機するのではなく、ただちに(つまり、リクエスト処理ライフサイクルのリクエスト値の適用フェーズ中に)実行されることを示すフラグを返します。このプロパティのデフォルト値は false でなければなりません。

      戻り値:
      即時の場合は true、それ以外の場合は false
    • setImmediate

      void setImmediate(boolean immediate)

      この UIComponent の「即時実行」フラグを設定します。

      パラメーター:
      immediate - 新しい即時実行フラグ
    • addActionListener

      void addActionListener(ActionListener listener)

      新しい ActionListener を、ActionEvent の発生時に通知を受けることに関心のあるリスナーのセットに追加します。

      パラメーター:
      listener - 追加する ActionListener
      例外:
      NullPointerExceptionSE - listener が null の場合
    • getActionListeners

      ActionListener[] getActionListeners()

      この ActionSource インスタンスに登録されている ActionListener のセットを返します。登録済みのリスナーがない場合は、長さ 0 の配列が返されます。

      戻り値:
      アクションリスナー、または長さゼロの配列。
    • removeActionListener

      void removeActionListener(ActionListener listener)

      ActionEvent の発生時に通知を受けることに関心のあるリスナーのセットから既存の ActionListener(存在する場合)を削除します。

      パラメーター:
      listener - 削除する ActionListener
      例外:
      NullPointerExceptionSE - listener が null の場合
    • getActionExpression

      default MethodExpression getActionExpression()

      immediate プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値適用フェーズまたはアプリケーションの呼び出しフェーズ中に、ユーザーがこの UIComponent をアクティブ化した場合、呼び出されるアプリケーションアクションを指す MethodExpression を返します。

      デフォルトの実装は UnsupportedOperationException をスローし、ActionSource を継承する既存のアプリケーションを壊さないという唯一の目的で提供されています。歴史的に、このメソッドはまさにこの理由から ActionSource2 で宣言されていましたが、インターフェースのデフォルトメソッドはサポートされていませんでした。

      戻り値:
      アクション式。
      導入:
      4.1
    • setActionExpression

      default void setActionExpression(MethodExpression action)

      immediate プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値適用フェーズまたはアプリケーションの呼び出しフェーズ中に、この UIComponent がユーザーによってアクティブ化された場合に呼び出されるアプリケーションアクションを指す MethodExpression を設定します。

      このような式で参照されるメソッドはすべて、String の戻り値の型でパブリックであり、パラメーターを受け入れない必要があります。

      デフォルトの実装は UnsupportedOperationException をスローし、ActionSource を継承する既存のアプリケーションを壊さないという唯一の目的で提供されています。歴史的に、このメソッドはまさにこの理由から ActionSource2 で宣言されていましたが、インターフェースのデフォルトメソッドはサポートされていませんでした。

      パラメーター:
      action - 新しいメソッド式
      導入:
      4.1