Installing Java SDK

If you haven't installed Java SDK yet, please download and install SUN Java Standard SDK.

Installing Tomcat 5.5

Install the most updated Tomcat first. Or you could find the document from Tomcat Setup.

Downloading ZK Library

Download ZK library(professional edition) for your operating systems.

Create ZK Project

1. Create project
Create a development directory under $TOMCAT_HOME/webapps.
The structure of development directory is shown below:(ex.zkdemo)

+zkdemo
  +WEB-INF
    web.xml
  index.zul

2. Unzip ZK library
   Unzip zk-bin-prof-xxx.zip or zk-bin-prof-xxx.tar.gz (ex. zk-bin-prof-x.x.x.zip)
3. Deploy ZK library
   Copy the following jar files to the $TOMCAT_HOME/webapps/$PROJECT_NAME/WEB-INF/lib (ex.zkdemo/WEB-INF/lib)
   • dist/lib/*.jar
   • dist/lib/zkforge/*.jar
   • dist/lib/ext/*.jar
4. Create web.xml
   Create web.xml under $TOMCAT_HOME/webapps/zkdemo, and Copy the following lines into web.xml

   
   <!-- ZK -->
     <listener>
       <description>Used to clean up when a session is destroyed</description>
       <display-name>ZK Session Cleaner</display-name>
       <listener-class>org.zkoss.zk.ui.http.HttpSessionListener</listener-class>
     </listener>
   
     <servlet>
       <description>ZK loader for ZUML pages</description>
       <servlet-name>zkLoader</servlet-name>
       <servlet-class>org.zkoss.zk.ui.http.DHtmlLayoutServlet</servlet-class>
       <init-param>
         <param-name>update-uri</param-name>
         <param-value>/zkau</param-value>
       </init-param>
       <load-on-startup>1</load-on-startup>
     </servlet>
     <servlet-mapping>
       <servlet-name>zkLoader</servlet-name>
       <url-pattern>*.zul</url-pattern>
     </servlet-mapping>
     <servlet-mapping>
       <servlet-name>zkLoader</servlet-name>
       <url-pattern>*.zhtml</url-pattern>
     </servlet-mapping>
   
     <servlet>
       <description>The asynchronous update engine for ZK</description>
       <servlet-name>auEngine</servlet-name> 
       <servlet-class>org.zkoss.zk.au.http.DHtmlUpdateServlet</servlet-class>
     </servlet>
     <servlet-mapping>
       <servlet-name>auEngine</servlet-name>
       <url-pattern>/zkau/*</url-pattern>
     </servlet-mapping>
   

5. Create index.zul
   Create index.zul under $TOMCAT_HOME/webapps/zkdemo/, and copy the following lines into it.

   
   <window title="My First window" border="normal" width="200px">
   	Hello, World!
   </window>
   
   

6. Start Tomcat
   Execute $TOMCAT_HOME/start.bat to activate Tomcat.
   (ex. C:\Program Files\apache-tomcat-5.5.23\bin\start.bat)
7. Browse zkdemo
   Browse to http://localhost/zkdemo/ or http://localhost:8080/zkdemo/ depending on your configuration for Tomcat.