クラス FlowHandler

方法の詳細

• getCurrentFlowScope

  public abstract MapSE<ObjectSE,ObjectSE> getCurrentFlowScope()

  #{flowScope} Jakarta Expression Language 暗黙オブジェクトをバックアップする Map を返します。現在アクティブなフローがない場合は、null を返します。

  戻り値:

  このフロースコープの Map。

  導入:

  2.2

• getFlow

  public abstract Flow getFlow(FacesContext context, StringSE definingDocumentId, StringSE id)

  引数 definingDocument のスコープ内で、 id が引数 id と同等である Flow を返します。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  definingDocumentId - 返されるフローが定義されているドキュメントのアプリケーション固有の識別子。

  id - definingDocument のスコープ内で一意の Flow の ID。

  戻り値:

  引数識別子の Flow。

  例外:

  NullPointerExceptionSE - パラメーターのいずれかが null の場合

  導入:

  2.2

• addFlow

  public abstract void addFlow(FacesContext context, Flow toAdd)

  現在のアプリケーションで認識されている Flow のコレクションに引数 Flow を追加します。実装はスレッドセーフでなければなりません。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  toAdd - 追加する Flow。

  例外:

  NullPointerExceptionSE - パラメーターのいずれかが null の場合

  IllegalStateExceptionSE - definingDocument のスコープ内に引数 Flow と同じ id のフローがすでに存在する場合。

  IllegalArgumentExceptionSE - 追加するフローの id が null または空の文字列の場合。

  IllegalArgumentExceptionSE - toAdd の  definingDocumentId が null の場合。

  導入:

  2.2

• getCurrentFlow

  public abstract Flow getCurrentFlow(FacesContext context)

  引数 FacesContext に対して現在アクティブな Flow を返します。アクティブなフローがない場合は、null を返します。Flow は常に正確に 1 つの ClientWindow に関連付ける必要がありますが、ClientWindow には複数の Flow が含まれる場合があります。

  このメソッドを呼び出す前に、引数として true を使用して pushReturnMode(jakarta.faces.context.FacesContext) が呼び出された場合は、実際の現在のフローの代わりにスタック上の先行するフローを返します。先行するフローがない場合は null を返します。それ以外の場合は、現在のフローを返します。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  戻り値:

  フローがアクティブでない場合は、現在の Flow または null 

  例外:

  NullPointerExceptionSE - パラメーターのいずれかが null の場合

  導入:

  2.2

• getCurrentFlow

  public Flow getCurrentFlow()

  FacesContext.getCurrentInstance() を呼び出してから getCurrentFlow(jakarta.faces.context.FacesContext) を呼び出す便利なオーバーロード。

  戻り値:

  フローがアクティブでない場合は、現在の Flow または null 

  導入:

  2.2

• getLastDisplayedViewId

  public abstract StringSE getLastDisplayedViewId(FacesContext context)

  getCurrentFlow(jakarta.faces.context.FacesContext) によって返される現在のフローの最後に表示された viewId を返します。現在のフローがない場合は null を返します。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  戻り値:

  最後に表示された viewId。

  例外:

  NullPointerExceptionSE - context が null の場合

  導入:

  2.2

• pushReturnMode

  public abstract void pushReturnMode(FacesContext context)

  リターンノードを処理するときに、ナビゲーションの正しい処理を有効にします。デフォルトの NavigationHandler 仕様では、フローリターンのナビゲーションルールを処理する前にこのメソッドを呼び出し、その直後に finally ブロックから popReturnMode(jakarta.faces.context.FacesContext) を呼び出す必要があります。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  例外:

  NullPointerExceptionSE - context が null の場合。

  導入:

  2.2

• popReturnMode

  public abstract void popReturnMode(FacesContext context)

  リターンノードを処理するときに、ナビゲーションの正しい処理を有効にします。デフォルトの NavigationHandler 仕様では、finally ブロックからこのメソッドを呼び出し、フローリターンのコンテキストでナビゲーションルールの処理をすぐに試行する必要があります。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  例外:

  NullPointerExceptionSE - context が null の場合。

  導入:

  2.2

• transition

  public abstract void transition(FacesContext context, Flow sourceFlow, Flow targetFlow, FlowCallNode outboundCallNode, StringSE toViewId)

  現在のユーザーの ClientWindow のフローグラフで遷移を実行します。origin および destination 引数に対応する Flow インスタンスへの参照を取得します。origin Flow が destination Flow と等しい場合は、何も実行せずに null を返します。それ以外の場合、outboundCallNode 引数が null でない場合は、送信パラメーターを保存します。説明のために、evaluatedParams は、送信パラメーターの評価された値を格納するデータ構造です。フロースコープをポップする前にこれらの値を評価する必要があります。値は、ターゲットフローに渡す必要があるが、新しいスコープがアクティブになると使用できなくなるスコープインスタンスを参照する可能性があるためです。次のアルゴリズムを使用して、送信パラメーターを保存します。

  outboundCallNode の outboundParameters プロパティが非 null かつ空でなく、ターゲットフローの inboundParameters プロパティが非 null かつ空でない場合、名前が受信 パラメーターのエントリと一致する送信 パラメーターの各エントリについて、パラメーターの値を評価し、評価した値を対応する名前の evaluatedParams に格納します。それ以外の場合は、evaluatedParams を空と見なします。

  destination Flow が  origin Flow のサブフローである場合は、destination Flow をフローデータ構造にプッシュし、the destination Flow を返します。それ以外の場合は、フローデータ構造から現在の Flow をポップします。destination Flow が null でない場合は、 destination Flow を現在のフローにして、データ構造にプッシュします。evaluatedParams が空でない場合は、各エントリについて、ターゲットフローの受信パラメーターで対応するパラメーターを見つけ、その setValue メソッドを呼び出して、evaluatedParams からの値を渡します。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  sourceFlow - 現在の Flow、またはソースフローがない場合は null。

  targetFlow - 宛先 Flow、または宛先フローがない場合は null。

  outboundCallNode - この遷移を引き起こしているフロー呼び出しノード、またはこの遷移がフロー呼び出しによって引き起こされていない場合は null。

  toViewId - この遷移の結果として表示されるビューの viewId。このパラメーターにより、getLastDisplayedViewId(jakarta.faces.context.FacesContext) を実装できるようになります。

  例外:

  NullPointerExceptionSE - context または toViewId が null の場合。

  導入:

  2.2

• clientWindowTransition

  public abstract void clientWindowTransition(FacesContext context)

  コンポーネントファミリ jakarta.faces.OutcomeTarget のレンダラーによってレンダリングされたコンポーネントの場合にフロー遷移を許可します。これらの遷移は、そのようなコンポーネントの HTTP GET ベースの性質により、リクエスト処理ライフサイクルの前に発生する必要があります。このメソッドは、ライフサイクルのビューの復元フェーズから呼び出されます。

  flowId を、FLOW_ID_REQUEST_PARAM_NAME の値によって名前が指定されたパラメーターのリクエストパラメーターマップの値とします。toFlowDocumentId を、TO_FLOW_DOCUMENT_ID_REQUEST_PARAM_NAME の値によって名前が指定されたパラメーターのリクエストパラメーターマップの値とします。toFlowDocumentId が null の場合、何も実行せず戻ります。それ以外の場合、sourceFlow を getCurrentFlow(jakarta.faces.context.FacesContext) からの戻り値とします。null 値は、現在のフローが存在しないことを示します。これは、このナビゲーションがフローに入ろうとしている場合に当てはまります。flowId が null でなく、toFlowDocumentId が NULL_FLOW の値と等しくない場合、getFlow(jakarta.faces.context.FacesContext, java.lang.String, java.lang.String) を呼び出して、最後の 2 つの引数としてそれぞれ toFlowDocumentId と flowId を渡した結果を targetFlow とします。結果が null 以外の場合、sourceFlow で Flow.getFlowCall(jakarta.faces.flow.Flow) を呼び出した際の戻り値を flowCallNode とし、引数として targetFlow を渡します。それ以外の場合、targetFlow と flowCallNode は null のままで、これがフロー戻り値であることを示します。FacesContext.getViewRoot() を呼び出し、UIViewRoot.getViewId() を呼び出した際の戻り値を toViewId とします。

  前のアルゴリズムで収集された引数を渡して、transition(jakarta.faces.context.FacesContext, jakarta.faces.flow.Flow, jakarta.faces.flow.Flow, jakarta.faces.flow.FlowCallNode, java.lang.String) を呼び出します。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  例外:

  NullPointerExceptionSE - context が null の場合。

  導入:

  2.2

• isActive

  public abstract boolean isActive(FacesContext context, StringSE definingDocument, StringSE id)

  引数 definingDocument および id によって参照されるフローが現在アクティブである場合にのみ、true を返します。

  パラメーター:

  context - 現在のリクエストの FacesContext。

  definingDocument - 返されるフローが定義されているドキュメントのアプリケーション固有の識別子。

  id - definingDocument のスコープ内で一意の Flow の ID。

  戻り値:

  参照されたフローがアクティブである場合にのみ true

  例外:

  NullPointerExceptionSE - パラメーターのいずれかが null の場合

  導入:

  2.2