onConstructionFunction

JSF ハンドラーのプロパティー onConstructionFunction は、ページが最初に構成されるときに実行される、JSF ハンドラー内の関数を指定します。 (このプロパティーは、以前は onPageLoadFunction でした。) より正確には、ページ Bean (Web サーバー内の JSF ハンドラーを表す) がインスタンス化 (作成) されたときにこの関数が実行されます。

この特定の関数は、別の JSF ハンドラーまたはプログラムがこの JSF ハンドラーにコントロールを転送すると実行されます。 この関数は、JSF ハンドラーが制御をそれ自体に転送した場合、または JSF ハンドラー内の関数が forward 文を発行せずに終了した場合は、再度実行されません。

以下の関連プロパティーと比較してください。

これらのプロパティーが参照する関数のいずれかにパラメーターを指定する場合、すべての関数に対して同じパラメーターを指定する必要があります。

セッション・スコープを使用し、cancelOnPageTransition を NO に設定している場合、JSF はハンドラーをセッションに配置します。この状態は、タイムアウトになるまで、あるいはセッションが終了するまで続きます。 ハンドラーには、未使用フィールドのデータ、またはその他の不要な情報を含めることができます。 以下を実行することにより、メモリーを保存できる場合があります。

j2eeLib clearSessionAttr()clearEGLSessionAttr() の関数を用いて、セッション・スコープから明示的にページを削除できます (clearSessionAttr() および clearEGLSessionAttrs() 参照)。

制限

次の例は、JSF ハンドラー・パーツのコンテキストでのプロパティーを示しています。

Handler  handler01  type JSFHandler
        { onConstructionFunction="resetVars" }
  ...
  Function resetVars()
     ...
  end
end

互換性

表 1. onConstructionFunction プロパティーのサポート
データ項目 JSF ハンドラー VGUI レコード コンソール UI テキスト書式 Java™ テキスト書式 COBOL 印刷書式 Java 印刷書式 COBOL
なし あり なし なし なし なし なし なし

フィードバック