onConstructionFunction

Die JSF-Handlereigenschaft onConstructionFunction gibt eine Funktion im JSF-Handler an, die ausgeführt wird, wenn die Seite zum ersten Mal erstellt wird. (Diese Eigenschaft hieß früher onPageLoadFunction.) Genauer gesagt wird die Funktion ausgeführt, wenn die Page-Bean (die den JSF-Handler im Web-Server darstellt) instanziiert (erstellt) wird.

Die angegebene Funktion wird ausgeführt, wenn ein anderer JSF-Handler oder ein Programm die Steuerung an den JSF-Handler übergibt. Diese Funktion darf nicht erneut ausgeführt werden, wenn der JSF-Handler die Steuerung an sich selbst weitergibt oder wenn eine Funktion im JSF-Handler beendet wird, ohne dass eine Anweisung forward ausgegeben wurde.

Vergleichen Sie die folgenden verwandten Eigenschaften:

Wenn Sie Parameter für eine beliebige Funktion angeben, auf die diese Eigenschaften verweisen, müssen Sie dieselben Parameter für alle Funktionen angeben.

Wenn Sie einen Sitzungsbereich verwenden und cancelOnPageTransition auf NO setzen, platziert JSF den Handler in der Sitzung, bis das Sitzungszeitlimit überschritten oder die Sitzung beendet wird. Der Handler kann Daten für ungenutzte Felder oder andere nicht erforderliche Informationen enthalten. Möglicherweise können Sie Speicherplatz einsparen, wenn Sie Folgendes tun:

Sie können eine Seite aus dem Sitzungsbereich mithilfe der 'j2eeLib'-Funktionen clearSessionAttr() und clearEGLSessionAttr() explizit entfernen (siehe clearSessionAttr() und clearEGLSessionAttrs()).

Einschränkungen

Beispiel

Im folgenden Beispiel wird die Eigenschaft im Kontext eines JSF-Handlerabschnitts dargestellt:

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

Kompatibilität

Tabelle 1. Unterstützung für die Eigenschaft 'onConstructionFunction'
Datenelement JSF-Handler VGUI-Datensatz Konsol-UI Textformular Java™ Textformular COBOL Druckformular Java Druckformular COBOL
Nein Ja Nein Nein Nein Nein Nein Nein

Feedback