The richlet tag declares a richlet. It uses two parameters,<richlet-class> and the<richlet-uri>. For example:

<richlet>
<richlet-class>com.irteam.TestRichlet</richlet-class>
<richlet-url>/test</richlet-url>
</richlet>

The richlet class must implement the org.zkoss.zk.ui.Richlet class. Be aware of the richlet-url because the "/" is necessary.

More than one listener may be specified in zk.xml. The listener may implement various interfaces. The possible interfaces are:

org.zkoss.zk.ui.event.EventThreadInit Initialize an event processing thread before an event is dispatched.

org.zkoss.zk.ui.event.EventThreadCleanup Clean up an event thread after execution.

org.zkoss.zk.ui.event.EventThreadSuspend Called before an event is going to be suspended.

org.zkoss.zk.ui.event.EventThreadResume Called when an event is resumed or aborted.

org.zkoss.zk.ui.util.WebAppInit Called when a ZK application is initialized.

org.zkoss.zk.ui.util.WebAppCleanup Clean up a ZK application, which is destroyed.

org.zkoss.zk.ui.util.SessionInit Invoked when a new Session is initialized.

org.zkoss.zk.ui.util.SessionCleanup Invoked to clean up a session that is destroyed.

org.zkoss.zk.ui.util.DesktopInit Initialize when a new desktop is created.

org.zkoss.zk.ui.util.DesktopCleanup To clean up a desktop that is destroyed.

org.zkoss.zk.ui.util.ExecutionInit Called when a new execution is initialized.

org.zkoss.zk.ui.util.ExecutionCleanup Clean up an execution which is destroyed.

org.zkoss.zk.ui.util.URIInterceptor This is used to intercept the loading of ZUML pages with the URI. It may be used to confirm if the current user should have access to the URI.

org.zkoss.zk.ui.util.Monitor This is used to monitor the status of the ZK application.

Normally, the logging will be performed according to the settings in the web container. This log tag can overwrite the existing settings. If the whole package needs logging then use this tag.

<log>
<log-base></log-base>
</log>

Or use

<log>
<log-base>com.irteam.myapp</log-base>
</log>

if only the package's com.irteam.myapp.* needs logging.

This has the following possible child tags: theme-uri, disable-default-theme, desktop-timeout, file-check-period, tooltip-delay, and processing-prompt-delay. The following list describes these child tags.

This tag has one child, the<evaluator-class>, and it specifies the class used to evaluate the EL expressions.

This tag has one child, the<addon-uri> element. It defines the URI of language add-ons. It is used to add new components. This is explained in some of the later chapters in more detail.

This element has three child tags:<timeout-uri>, <session-timeout>, and<max-desktops-per-session>.

This has nine child tags:<max-event-threads>, <max-upload-size>, <response-charset>, <locale-provider-class>, <time-zone-provider-class>, <cache-provider-class>, <ui-factory-class>, <engine-class>, and<web-app-class>.

This defines the language and the implementation class.

<zscript-config>
<zscript-language>
<language-name>ZKJava</language-name>
<interpreter-class>com.irteam.ZKJavaInterpreter</interpreterclass>
</zscript-language>
</zscript-config>s

This defines a URI for a specific uncaught exception..

<error-page>
<exception-type>com.irteam.Special</exception-type>
<location>/error/special.zul</location>
</error-page>

Any pair of name / value may be defined..

<preference>
<name>com.irteam.preference.AdminAccount</name>
<value>Administrator</value>
</preference>

The values can be read by the getPreference method of the org.zkoss.zk.ui.util.Configuration class.