Tomcat

Install Tomcat

• First, visit http://tomcat.apache.org/download-60.cgi
• Second, select the correct binary distribution for your environment.
  • Windows users could select "32-bit/64-bit Windows Service Installer" and then follow its instructions.

Test drive with the ZK demo application

The simplest way to test drive ZK is to download and install the ZK demo application.

This step is optional. You could skip it if you prefer to start creating your own application directly.

1. Download at http://sourceforge.net/projects/zk1/files/ZK/zk-5.0.4/zk-demo-5.0.4.zip/download
2. Unzip zk-demo-5.0.4.zip
3. Copy zkdemo.war under the zk-demo-5.0.4 directory to $TOMCAT_HOME/webapps. $TOMCAT_HOME is the directory you installed Tomcat, for example, C:\Program Files\Apache Software Foundation\Tomcat 6.0.
4. Then, you could visit http://localhost:8080/zkdemo, and then play around with the demo application

---

Create your first application

Here is how to create a Web application manually without IDE or other tools. It is easy to find the similar procedure with your preferred IDE or tools, such as Eclipse and NetBeans.

Download ZK

First, download the ZK libraries from http://www.zkoss.org/download/zk.dsp and save it to a proper location.

Create a Web application

Creating a Web application in Tomcat is easy: just create a directory under $TOMCAT_HOME/webapps. $TOMCAT_HOME is the directory you installed Tomcat, for example, C:\Program Files\Apache Software Foundation\Tomcat 6.0.

Let us assume the application is called myZK. Then, the directory structure shall be as follows.

myZK

WEB-INF

WEB-INF/lib

Deploy ZK libraries

1. Unzip zk-bin-5.0.4.zip
2. Copy JAR files under dist/lib to $TOMCAT_HOME/webapps/myZK/WEB-INF/lib

Create web.xml

Create web.xml under $TOMCAT_HOME/webapps/myZK/WEB-INF. For the content of web.xml, please refer to Sample of web.xml.

For older Tomcat (4.x) that supports only Servlet 2.3, please refer to Sample of web.xml for Servlet 2.3.

Create your application

After setting up web.xml, it is ready to serve your application.

For example, we can create a simple page, say, hello.zul with the following content.

<syntax lang="xml">

<window title="My First ZK Application" border="normal">
	Hello World!
</window>

</syntax>

Then, you can see the result by visiting http://localhost:8080/myZK/hello.zul.

---

Version History

Version	Date	Content
5.0.4	9/21/2010	Updated