ZK Directive: init

From Documentation

Stop.png This documentation is for an older version of ZK. For the latest one, please click here.

<?init class="..." [arg0="..."] [arg1="..."] [arg2="..."] [arg3="..."]?>
<?init zscript="..."?>

There are two approaches:

  • Specify a class to do the application-specific initialization.
  • Specify a zscript file to do the application-specific initialization.

The initialization takes place before the page is evaluated and attached to a desktop. Thus, the getDesktop, getId and getTitle methods will return null, when initializing. To retrieve the current desktop, you could use the Execution interface.

You could specify any number of the init directive. If you choose the first format, the specified class must implement the Initiator interface. Once specified, an instance of the class is constructed and its doInit method is called, before the page is evaluated.

In addition, the doFinally method is called, after the page has been evaluated. The doCatch method is called if an exception occurs. Thus, this directive is not limited to initialization. You could use it for cleanup and error handling.

If you choose the second format, the zscript file is evaluated and the arguments (arg0, arg1,...) will be passed as a variable called args whose type is Object[].

Since 3.6.2, you can use any (readable) name instead of arg0 and so on. For example,

<?init class="org.zkoss.zkplus.databind.AnnotateDataBinderInit" root="./abc"?>

For more information, refer to ZK ZUML Reference .

Last Update : 2022/01/19

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.