public interface ActionSource
ActionSource は、デフォルトの ActionListener
メカニズムを介してアプリケーションアクションを呼び出す機能を含む、ActionEvent
のソースになりたい具体的な UIComponent
によって実装できるインターフェースです。
修飾子と型 | メソッドと説明 |
---|---|
void | addActionListener(ActionListener listener) 新しい ActionListener を、ActionEvent の発生時に通知を受けることに関心のあるリスナーのセットに追加します。 |
MethodBinding | getAction() 使用すべきではありません。 これは ActionSource2.getActionExpression() に置き換えられました。 |
MethodBinding | getActionListener() 使用すべきではありません。 代わりに getActionListeners() を使用してください。 |
ActionListener[] | getActionListeners() この ActionSource インスタンスに登録されている ActionListener のセットを返します。 |
boolean | isImmediate() アプリケーションの呼び出しフェーズまで待つのではなく、Jakarta Server Faces 実装によって提供されるデフォルトの ActionListener をすぐに(つまり、リクエスト処理ライフサイクルのリクエスト値の適用フェーズ中に)実行する必要があることを示すフラグを返します。 |
void | removeActionListener(ActionListener listener) ActionEvent の発生時に通知を受けることに関心のあるリスナーのセットから既存の ActionListener (存在する場合)を削除します。 |
void | setAction(MethodBinding action) 使用すべきではありません。 これは ActionSource2.setActionExpression(jakarta.el.MethodExpression) に置き換えられました。 |
void | setActionListener(MethodBinding actionListener) 使用すべきではありません。 これは addActionListener(jakarta.faces.event.ActionListener) に置き換えられました。 |
void | setImmediate(boolean immediate) この UIComponent の「即時実行」フラグを設定します。 |
boolean isImmediate()
Jakarta Server Faces 実装によって提供されるデフォルトの ActionListener
が、アプリケーションの呼び出しフェーズまで待機するのではなく、ただちに(つまり、リクエスト処理ライフサイクルのリクエスト値の適用フェーズ中に)実行されることを示すフラグを返します。このプロパティのデフォルト値は false
でなければなりません。
true
、それ以外の場合は false
。void setImmediate(boolean immediate)
この UIComponent
の「即時実行」フラグを設定します。
immediate
- 新しい即時実行フラグ void addActionListener(ActionListener listener)
新しい ActionListener
を、ActionEvent
の発生時に通知を受けることに関心のあるリスナーのセットに追加します。
listener
- 追加する ActionListener
NullPointerExceptionSE
- listener
が null
の場合 ActionListener[] getActionListeners()
この ActionSource
インスタンスに登録されている ActionListener
のセットを返します。登録済みのリスナーがない場合は、長さ 0 の配列が返されます。
void removeActionListener(ActionListener listener)
ActionEvent
の発生時に通知を受けることに関心のあるリスナーのセットから既存の ActionListener
(存在する場合)を削除します。
listener
- 削除する ActionListener
NullPointerExceptionSE
- listener
が null
の場合 @DeprecatedSE MethodBinding getAction()
ActionSource2.getActionExpression()
に置き換えられました。 実装クラスも ActionSource2
を実装している場合、このメソッドの実装は ActionSource2.getActionExpression()
を呼び出して結果を調べる必要があります。以前の setAction(jakarta.faces.el.MethodBinding)
の呼び出しの結果が返された場合は、そこから MethodBinding
を抽出して返します。それ以外の場合は、返された MethodExpression
を MethodBinding
実装でラップして返します。
実装クラスが ActionSource2
を実装していない場合は、呼び出されるアプリケーションアクションを指す MethodBinding
を返します。この UIComponent
がユーザーによってアクティブ化されている場合、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に、immediate
プロパティ。
@DeprecatedSE void setAction(MethodBinding action)
ActionSource2.setActionExpression(jakarta.el.MethodExpression)
に置き換えられました。 実装クラスが ActionSource2
も実装する場合、このメソッドの実装は、MethodExpression
を実装するクラスで引数 action
をラップし、ラップされた action
を渡して ActionSource2.setActionExpression(jakarta.el.MethodExpression)
を呼び出す必要があります。
実装クラスが ActionSource2
を実装していない場合、MethodBinding
がアプリケーションアクションを指すように設定します。この UIComponent
がユーザーによってアクティブ化された場合、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に、immediate
プロパティ。
このような式で参照されるメソッドはすべて、String
の戻り値の型でパブリックであり、パラメーターを受け入れない必要があります。
action
- 新しい MethodBinding 式 @DeprecatedSE MethodBinding getActionListener()
getActionListeners()
を使用してください。 このインスタンスに対して setActionListener(jakarta.faces.el.MethodBinding)
が以前に呼び出されていなかった場合、このメソッドは null
を返す必要があります。呼び出された場合、このメソッドは setActionListener(jakarta.faces.el.MethodBinding)
に渡された正確な MethodBinding
インスタンスを返す必要があります。
呼び出されるメソッドは、この UIComponent
がユーザーによってアクティブ化された場合、immediate
プロパティの値に応じて、リクエスト処理ライフサイクルのリクエスト値の適用フェーズまたはアプリケーションの呼び出しフェーズ中に呼び出されます。
@DeprecatedSE void setActionListener(MethodBinding actionListener)
addActionListener(jakarta.faces.event.ActionListener)
に置き換えられました。 引数 actionListener
を ActionListener
の実装にラップし、getActionListeners()
メソッドをサポートする内部データ構造に格納します。setActionListener
への以前の呼び出しによって格納されたインスタンスを上書きすることに注意してください。
このような式で参照されるメソッドは、戻り値の型が void
のパブリックであり、型 ActionEvent
の単一のパラメーターを受け入れる必要があります。
actionListener
- 新しいメソッドバインディング式 Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.