ZK Developer's Guide

[ 9 ]
Chapter 1
First Step: Say Hello to ZK
To get a feel of working with ZK, it's wise to do a small example. To follow the long
tradition of many programming technologies, we will start with the traditional
"Hello World" example.
For the examples, we are using version 2.3.0 of the ZK framework.
The best way to start with ZK is to download the zkdemo application from the
ZK team. The application can be downloaded from: http://www.zkoss.org/
download/. The application comes in a ZIP archive. This archive contains four files:
1. zkdemo-all.war
2. zkdemo.war
3. zkdemos-all.ear
4. zkdemos.ear
The WAR files are for deploying inside a J2EE web container. The EAR files are
for deploying inside a J2EE application server. To start, just throw the zkdemo.
war inside the webapps directory of Tomcat. After this the application is available
with the URL http://localhost:8080/zkdemo (if Tomcat runs at port 8080). Now
create a new file with the name hello.zul, and copy this page to the decompressed
application zkdemo. The page can be accessed with http://localhost:8080/
zkdemo/hello.zul.
Hello World!
The downloaded archive of the demo contains zkdemo.war,
zkdemo-all.war, zkdemos-all.ear, and zkdemos.ear. The
files without the suffix -all does not contain a complete application.
The libraries from ZK are missing. For a first start you can copy the
zkdemo-all.war to your Tomcat webapps directory. If you want
to use the zkdemo.war please copy all libraries from your zk-2.3.0
(directory zk-2.3.0/dist/lib) into the expanded directory of the
web application. Without a copy of the libraries you get an error while
executing your application.