クラス FlowBuilder
- java.lang.ObjectSE
-
- jakarta.faces.flow.builder.FlowBuilder
public abstract class FlowBuilder extends ObjectSE
Flow
を構築するための Java 言語 API。この API は、アプリケーション構成リソースの XML スキーマ定義の<flow-definition>
要素と意味的に同じです。使用例:
public class FlowA implements Serializable { @Produces
FlowDefinition
publicFlow
buildMyFlow(@FlowBuilderParameter
FlowBuilder
flowBuilder) { String flowId = "flow-a"; flowBuilder.id("unique", flowId); flowBuilder.returnNode("taskFlowReturn1"). fromOutcome("#{flow_a_Bean.returnValue}"); flowBuilder.inboundParameter("param1FromFlowB", "#{flowScope.param1Value}"); flowBuilder.inboundParameter("param2FromFlowB", "#{flowScope.param2Value}"); flowBuilder.flowCallNode("callB").flowReference("", "flow-b"). outboundParameter("param1FromFlowA", "param1Value"). outboundParameter("param2FromFlowA", "param2Value"); return flowBuilder.getFlow(); } }ランタイムは、起動時にそのようなすべてのメソッドを検出し、
FlowHandler.addFlow(jakarta.faces.context.FacesContext, jakarta.faces.flow.Flow)
メソッドを使用して返されたフローがFlowHandler
に追加されるようにする必要があります。- 導入:
- 2.2
コンストラクターのサマリー
コンストラクター コンストラクター 説明 FlowBuilder()
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 abstract FlowBuilder
finalizer(MethodExpression methodExpression)
フローが終了したときに呼び出される MethodExpression。abstract FlowBuilder
finalizer(StringSE methodExpression)
フローが終了したときに呼び出される MethodExpression。abstract FlowCallBuilder
flowCallNode(StringSE flowCallNodeId)
フローコールノードを定義します。abstract Flow
getFlow()
フロー定義の最後のステップとして呼び出されるこのメソッドは、実装固有の初期化を実行し、ビルドされたFlow
を返す必要があります。abstract FlowBuilder
id(StringSE definingDocumentId, StringSE id)
このフローの定義ドキュメント ID とフロー ID を設定します。abstract FlowBuilder
inboundParameter(StringSE name, ValueExpression expression)
このフローがそのフローから入力されたときに、別のフローからの対応する名前の送信パラメーターからの値が入力されるパラメーター。abstract FlowBuilder
inboundParameter(StringSE name, StringSE expression)
このフローがそのフローから入力されたときに、別のフローからの対応する名前の送信パラメーターからの値が入力されるパラメーター。abstract FlowBuilder
initializer(MethodExpression methodExpression)
フローが開始されたときに呼び出される MethodExpression。abstract FlowBuilder
initializer(StringSE methodExpression)
フローが開始されたときに呼び出される MethodExpression。abstract MethodCallBuilder
methodCallNode(StringSE methodCallNodeId)
メソッド呼び出しノードを定義します。abstract NavigationCaseBuilder
navigationCase()
このケースを実行するために一致する必要がある条件の特定の組み合わせと、次に選択する必要があるコンポーネントツリーのビュー ID を定義します。abstract ReturnBuilder
returnNode(StringSE returnNodeId)
リターンノードを定義します。abstract SwitchBuilder
switchNode(StringSE switchNodeId)
フローグラフの次に進む場所を決定するために、定義された順序でインスペクションされるケースの特定のリストを定義します。abstract ViewBuilder
viewNode(StringSE viewNodeId, StringSE vdlDocumentId)
フローグラフでビューノードを定義します。
メソッドの詳細
id
public abstract FlowBuilder id(StringSE definingDocumentId, StringSE id)
このフローの定義ドキュメント ID とフロー ID を設定します。
- パラメーター:
definingDocumentId
- このフローの定義ドキュメント ID、またはこのフローが定義ドキュメント ID を必要としない場合は空の文字列。id
- フローの ID- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
viewNode
public abstract ViewBuilder viewNode(StringSE viewNodeId, StringSE vdlDocumentId)
フローグラフでビューノードを定義します。
- パラメーター:
viewNodeId
- フローグラフ内で、このビューノードの ID。このフローグラフのすべてのノード間で一意である必要があります。vdlDocumentId
- このフロー内のビューノードへの完全修飾パス。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
navigationCase
public abstract NavigationCaseBuilder navigationCase()
このケースを実行するために一致する必要がある条件の特定の組み合わせと、次に選択する必要があるコンポーネントツリーのビュー ID を定義します。
- 戻り値:
- ビルダーインスタンス
- 導入:
- 2.2
switchNode
public abstract SwitchBuilder switchNode(StringSE switchNodeId)
フローグラフの次に進む場所を決定するために、定義された順序でインスペクションされるケースの特定のリストを定義します。いずれのケースも一致しない場合は、デフォルトのケースの結果が選択されます。
- パラメーター:
switchNodeId
- フローグラフ内で、このスイッチノードの ID。このフローグラフのすべてのノード間で一意である必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
returnNode
public abstract ReturnBuilder returnNode(StringSE returnNodeId)
リターンノードを定義します。このノードにより、指定された結果が呼び出しフローに返されます。
- パラメーター:
returnNodeId
- フローグラフ内で、このリターンノードの ID。このフローグラフのすべてのノード間で一意である必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
methodCallNode
public abstract MethodCallBuilder methodCallNode(StringSE methodCallNodeId)
メソッド呼び出しノードを定義します。このノードにより、指定されたメソッドが呼び出され、必要に応じてパラメーターが渡されます。メソッドからのリターンは、フローの次に進む場所の結果として使用されます。メソッドが void メソッドの場合、デフォルトの結果が使用されます。
- パラメーター:
methodCallNodeId
- フローグラフ内で、このメソッド呼び出しノードの ID。このフローグラフのすべてのノード間で一意である必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
flowCallNode
public abstract FlowCallBuilder flowCallNode(StringSE flowCallNodeId)
フロー呼び出しノードを定義します。このノードにより、指定されたフローが呼び出され、必要に応じてパラメーターが渡されます。
- パラメーター:
flowCallNodeId
- フローグラフ内で、このリターンノードの ID。このフローグラフのすべてのノード間で一意である必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
initializer
public abstract FlowBuilder initializer(MethodExpression methodExpression)
フローが開始されたときに呼び出される MethodExpression。
- パラメーター:
methodExpression
- 呼び出す式は、引数なしのメソッドを参照する必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
initializer
public abstract FlowBuilder initializer(StringSE methodExpression)
フローが開始されたときに呼び出される MethodExpression。
- パラメーター:
methodExpression
- 呼び出す式は、引数なしのメソッドを参照する必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
finalizer
public abstract FlowBuilder finalizer(MethodExpression methodExpression)
フローが終了したときに呼び出される MethodExpression。
- パラメーター:
methodExpression
- 呼び出す式は、引数なしのメソッドを参照する必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
finalizer
public abstract FlowBuilder finalizer(StringSE methodExpression)
フローが終了したときに呼び出される MethodExpression。
- パラメーター:
methodExpression
- 呼び出す式は、引数なしのメソッドを参照する必要があります。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
inboundParameter
public abstract FlowBuilder inboundParameter(StringSE name, ValueExpression expression)
このフローがそのフローから入力されたときに、別のフローからの対応する名前の送信パラメーターからの値が入力されるパラメーター。
- パラメーター:
name
- パラメーター名expression
- フローが呼び出されたときに受信値を入力するValueExpression
。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
inboundParameter
public abstract FlowBuilder inboundParameter(StringSE name, StringSE expression)
このフローがそのフローから入力されたときに、別のフローからの対応する名前の送信パラメーターからの値が入力されるパラメーター。
- パラメーター:
name
- パラメーター名expression
- フローが呼び出されたときに受信値を入力するValueExpression
文字列。- 戻り値:
- ビルダーインスタンス
- 例外:
NullPointerExceptionSE
- パラメーターのいずれかがnull
の場合- 導入:
- 2.2
getFlow
public abstract Flow getFlow()
フロー定義の最後のステップとして呼び出されるこのメソッドは、実装固有の初期化を実行し、ビルドされた
Flow
を返す必要があります。特定のフロー構築プロセス中に複数回呼び出された場合、2 回目以降の呼び出しはアクションを実行せず、構築されたフローを返す必要があります。- 戻り値:
- 完全に構築された
Flow
- 例外:
IllegalStateExceptionSE
- このメソッドが呼び出される前にid(java.lang.String, java.lang.String)
メソッドが呼び出されていなかった場合。- 導入:
- 2.2