インターフェース ActionSource
- 既知のすべてのサブインターフェース:
ActionSource2
ActionSource は、デフォルトの ActionListener メカニズムを介してアプリケーションアクションを呼び出す機能を含む、ActionEvent のソースになりたい具体的な UIComponent によって実装できるインターフェースです。
方法の概要
修飾子と型メソッド説明voidaddActionListener(ActionListener listener) 新しいActionListenerを、ActionEventの発生時に通知を受けることに関心のあるリスナーのセットに追加します。default MethodExpressionimmediateプロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に、ユーザーがこのUIComponentをアクティブ化した場合、呼び出されるアプリケーションアクションを指すMethodExpressionを返します。このActionSourceインスタンスに登録されているActionListenerのセットを返します。booleanアプリケーションの呼び出しフェーズまで待つのではなく、Jakarta Faces 実装によって提供されるデフォルトのActionListenerをすぐに(つまり、リクエスト処理ライフサイクルのリクエスト値の適用フェーズ中に)実行する必要があることを示すフラグを返します。voidremoveActionListener(ActionListener listener) ActionEventの発生時に通知を受けることに関心のあるリスナーのセットから既存のActionListener(存在する場合)を削除します。default voidsetActionExpression(MethodExpression action) immediateプロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に、このUIComponentがユーザーによってアクティブ化された場合に呼び出されるアプリケーションアクションを指すMethodExpressionを設定します。voidsetImmediate(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