ZK 6: Upgrade Notes

From Documentation
Revision as of 02:15, 14 November 2011 by Tomyeh (talk | contribs)
ZK 6: Upgrade Notes

Author
ZK Team, Potix Corporation
Date
November 15, 2011
Version
ZK 6

Overview

In additions to new features, ZK 6 also cleans up some API that are confusing, redundant or over complicated. The effort to upgrade depends on what features your application uses. Many of them shall run without modification. It is suggested to re-compile the applications and replace the code that use the deprecated API.

Upgrade addons

Here is a list of addons that you have to upgrade:

API that are changed

org.zkoss.zk.zul.api.* are removed

The component's API interfaces (org.zkoss.zk.ui.api.*, org.zkoss.zul.api.*...) are removed[1] Please replace them with the concrete classes. For example, use org.zkoss.zul.Window instead of org.zkoss.zul.api.Window.

Template:References

org.zkoss.zk.ui.util.Initiator is simplified

The doAfterComposer, doCatch and doFinally methods are moved from org.zkoss.zk.ui.util.Initiator to org.zkoss.zk.ui.util.InitiatorExt. In other words, if you'd like to override any of these methods, your initiator has to implement both org.zkoss.zk.ui.util.Initiator and org.zkoss.zk.ui.util.InitiatorExt.

API that are deprecated

CSS and Theme

Comments



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


  1. The reason to remove them is they cause more confusion than the abstraction benefit, and they are costly to maintain.