インターフェース ActionSource
- すべての既知のサブインターフェース:
ActionSource2
ActionSource は、デフォルトの ActionListener
メカニズムを介してアプリケーションアクションを呼び出す機能を含む、ActionEvent
のソースになりたい具体的な UIComponent
によって実装できるインターフェースです。
メソッドのサマリー
修飾子と型メソッド説明void
addActionListener
(ActionListener listener) 新しいActionListener
を、ActionEvent
の発生時に通知を受けることに関心のあるリスナーのセットに追加します。default MethodExpression
immediate
プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に、ユーザーがこのUIComponent
をアクティブ化した場合、呼び出されるアプリケーションアクションを指すMethodExpression
を返します。このActionSource
インスタンスに登録されているActionListener
のセットを返します。boolean
アプリケーションの呼び出しフェーズまで待つのではなく、Jakarta Faces 実装によって提供されるデフォルトのActionListener
をすぐに(つまり、リクエスト処理ライフサイクルのリクエスト値の適用フェーズ中に)実行する必要があることを示すフラグを返します。void
removeActionListener
(ActionListener listener) ActionEvent
の発生時に通知を受けることに関心のあるリスナーのセットから既存のActionListener
(存在する場合)を削除します。default void
setActionExpression
(MethodExpression action) 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
新しい
ActionListener
を、ActionEvent
の発生時に通知を受けることに関心のあるリスナーのセットに追加します。- パラメーター:
listener
- 追加するActionListener
- 例外:
NullPointerExceptionSE
-listener
がnull
の場合
getActionListeners
ActionListener[] getActionListeners()この
ActionSource
インスタンスに登録されているActionListener
のセットを返します。登録済みのリスナーがない場合は、長さ 0 の配列が返されます。- 戻り値:
- アクションリスナー、または長さゼロの配列。
removeActionListener
ActionEvent
の発生時に通知を受けることに関心のあるリスナーのセットから既存のActionListener
(存在する場合)を削除します。- パラメーター:
listener
- 削除するActionListener
- 例外:
NullPointerExceptionSE
-listener
がnull
の場合
getActionExpression
immediate
プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に、ユーザーがこのUIComponent
をアクティブ化した場合、呼び出されるアプリケーションアクションを指すMethodExpression
を返します。デフォルトの実装は
UnsupportedOperationException
をスローし、ActionSource
を継承する既存のアプリケーションを壊さないという唯一の目的で提供されています。歴史的に、このメソッドはまさにこの理由からActionSource2
で宣言されていましたが、インターフェースのデフォルトメソッドはサポートされていませんでした。- 戻り値:
- アクション式。
- 導入:
- 4.1
setActionExpression
immediate
プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に、このUIComponent
がユーザーによってアクティブ化された場合に呼び出されるアプリケーションアクションを指すMethodExpression
を設定します。このような式で参照されるメソッドはすべて、
String
の戻り値の型でパブリックであり、パラメーターを受け入れない必要があります。デフォルトの実装は
UnsupportedOperationException
をスローし、ActionSource
を継承する既存のアプリケーションを壊さないという唯一の目的で提供されています。歴史的に、このメソッドはまさにこの理由からActionSource2
で宣言されていましたが、インターフェースのデフォルトメソッドはサポートされていませんでした。- パラメーター:
action
- 新しいメソッド式- 導入:
- 4.1