クラス ClientBehaviorContext
- java.lang.ObjectSE
-
- jakarta.faces.component.behavior.ClientBehaviorContext
public abstract class ClientBehaviorContext extends ObjectSE
ClientBehaviorContext は、
ClientBehavior.getScript(jakarta.faces.component.behavior.ClientBehaviorContext)の実装に役立つコンテキスト情報を提供します。- 導入:
- 2.0
ネストされたクラスの要約
ネストされたクラス 修飾子と型 クラス 説明 static classClientBehaviorContext.Parameterパラメーターインスタンスは、Faces ライフサイクルにポストバックするときに ClientBehavior 実装を「送信」するときに含める必要がある名前 / 値のペアを表します。
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static StringSEBEHAVIOR_EVENT_PARAM_NAMEリクエストパラメーター値が動作イベントの型を識別するリクエストパラメーター名。static StringSEBEHAVIOR_SOURCE_PARAM_NAMEリクエストパラメーター値が動作イベントのソースコンポーネントを識別するリクエストパラメーター名。
コンストラクターの概要
コンストラクター コンストラクター 説明 ClientBehaviorContext()
メソッドのサマリー
すべてのメソッド 静的メソッド インスタンスメソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 static ClientBehaviorContextcreateClientBehaviorContext(FacesContext context, UIComponent component, StringSE eventName, StringSE sourceId, CollectionSE<ClientBehaviorContext.Parameter> parameters)ClientBehaviorContext インスタンスを作成します。abstract UIComponentgetComponent()ClientBehaviorスクリプトをリクエストしているUIComponentを返します。abstract StringSEgetEventName()ClientBehavior スクリプトがリクエストされている動作イベントの名前を返します。abstract FacesContextgetFacesContext()現在のリクエストのFacesContextを返します。abstract CollectionSE<ClientBehaviorContext.Parameter>getParameters()Faces ライフサイクルにデータをポストバックするときにClientBehavior実装を「送信」する必要があるパラメーターを返します。abstract StringSEgetSourceId()ClientBehaviorソースとして使用する ID を返します。
メソッドの詳細
createClientBehaviorContext
public static ClientBehaviorContext createClientBehaviorContext(FacesContext context, UIComponent component, StringSE eventName, StringSE sourceId, CollectionSE<ClientBehaviorContext.Parameter> parameters)
ClientBehaviorContext インスタンスを作成します。
- パラメーター:
context- 現在のリクエストのFacesContext。component-ClientBehaviorが接続されているコンポーネントインスタンス。eventName-ClientBehaviorが接続されている動作イベントの名前。sourceId- ClientBehavior の「ソース」として使用する ID。parameters- リクエストに含める ClientBehaviors を送信するためのパラメーターのコレクション。- 戻り値:
- 提供された値で構成された
ClientBehaviorContextインスタンス。 - 例外:
NullPointerExceptionSE-context、component、eventNameがnullの場合- 導入:
- 2.0
getFacesContext
public abstract FacesContext getFacesContext()
現在のリクエストの
FacesContextを返します。- 戻り値:
FacesContext- 導入:
- 2.0
getComponent
public abstract UIComponent getComponent()
ClientBehaviorスクリプトをリクエストしているUIComponentを返します。- 戻り値:
- コンポーネント。
- 導入:
- 2.0
getEventName
public abstract StringSE getEventName()
ClientBehavior スクリプトがリクエストされている動作イベントの名前を返します。
- 戻り値:
- イベント名。
- 導入:
- 2.0
getSourceId
public abstract StringSE getSourceId()
ClientBehaviorソースとして使用するための ID を返します。Faces ライフサイクルにサブミットする ClientBehavior 実装は、jakarta.faces.sourceリクエストパラメーターを介して ClientBehavior によって開始されたリクエストをトリガーしたコンポーネントを識別するために必要です。ほとんどの場合、ソース ID は、振る舞いーのクライアント側スクリプトが添付されている要素から簡単に派生できます。ソース ID は通常、この要素の ID です。ただし、より複雑なコンテンツを生成するコンポーネントでは、動作スクリプトが jakarta.faces.source 値に使用する正しい ID を決定できない場合があります。getSourceId()メソッドにより、コンポーネントはこの情報をClientBehavior.getScript(jakarta.faces.component.behavior.ClientBehaviorContext)実装に渡すことができます。- 戻り値:
- 振る舞いのスクリプトが「ソース」として使用する ID。振る舞いのスクリプトが DOM からソースを識別できる場合は null。
- 導入:
- 2.0
getParameters
public abstract CollectionSE<ClientBehaviorContext.Parameter> getParameters()
Faces ライフサイクルにデータをポストバックするときに
ClientBehavior実装を「送信」する必要があるパラメーターを返します。パラメーターが指定されていない場合、このメソッドは空の(null 以外の)コレクションを返します。- 戻り値:
- パラメーター。
- 導入:
- 2.0