ZK 6: Upgrade Notes"
m (Created page with "{{Template:Smalltalk_Author| |author=Tom Yeh, Potix Corporation |date=November 15, 2011 |version=ZK 6 }} {{Template:CommentedSmalltalk_Footer| |name=Potix Corporation }}") |
|||
| Line 1: | Line 1: | ||
{{Template:Smalltalk_Author| | {{Template:Smalltalk_Author| | ||
| − | |author= | + | |author=ZK Team, Potix Corporation |
|date=November 15, 2011 | |date=November 15, 2011 | ||
|version=ZK 6 | |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: | ||
| + | |||
| + | * ZK JSP 2.0 or later. [http://code.google.com/p/zkjsp/downloads/list Download here]. | ||
| + | * ZK Calendar 2.1.1 or later. [http://code.google.com/p/zkcalendar/downloads/list Download here]. | ||
| + | |||
| + | =API that are changed= | ||
| + | ==org.zkoss.zk.zul.api.* are removed== | ||
| + | |||
| + | The component's API interfaces (<tt>org.zkoss.zk.ui.api.*</tt>, <tt>org.zkoss.zul.api.*</tt>...) are removed<ref>The reason to remove them is they cause more confusion than the abstraction benefit, and they are costly to maintain.</ref> Please replace them with the concrete classes. For example, use <tt>org.zkoss.zul.Window</tt> instead of <tt>org.zkoss.zul.api.Window</tt>. | ||
| + | |||
| + | {{references}} | ||
| + | |||
| + | ==org.zkoss.zk.ui.util.Initiator is simplified== | ||
| + | |||
| + | The <tt>doAfterComposer</tt>, <tt>doCatch</tt> and <tt>doFinally</tt> methods are moved from <tt>org.zkoss.zk.ui.util.Initiator</tt> to <tt>org.zkoss.zk.ui.util.InitiatorExt</tt>. In other words, if you'd like to override any of these methods, your initiator has to implement both <tt>org.zkoss.zk.ui.util.Initiator</tt> and <tt>org.zkoss.zk.ui.util.InitiatorExt</tt>. | ||
| + | |||
| + | =API that are deprecated= | ||
| + | |||
| + | =CSS and Theme= | ||
{{Template:CommentedSmalltalk_Footer| | {{Template:CommentedSmalltalk_Footer| | ||
|name=Potix Corporation | |name=Potix Corporation | ||
}} | }} | ||
Revision as of 02:15, 14 November 2011
ZK Team, Potix Corporation
November 15, 2011
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:
- ZK JSP 2.0 or later. Download here.
- ZK Calendar 2.1.1 or later. Download here.
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.
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. |
- ↑ The reason to remove them is they cause more confusion than the abstraction benefit, and they are costly to maintain.