ZK Installation Guide/Quick Start/Create and Run Your First ZK Application Manually

Create your first application

Here shows you how to create a web application manually without IDE or other tools.

Download ZK Libraries

First, download the ZK libraries (Now is zk-bin-5.0.4.zip) from ZK Download and save it to a proper location.

Create Web application

ZK Web Applications use a standard directory structure defined in the Servlet specification. When developing ZK web applications, you must follow this structure so that application can be deployed in any J2EE compliant web server.

All you need to do is create a web application directory with related files.

• Now i create one for example named myZK

Install Library Distribution

1. Unzip zk-bin-5.0.4.zip
2. Copy JAR files under following list to myZK/WEB-INF/lib

   • {YOUR_ZK_UNZIP_FOLDER}/dist/lib
   • {YOUR_ZK_UNZIP_FOLDER}/dist/lib/ext
   • {YOUR_ZK_UNZIP_FOLDER}/dist/lib/zkforge

Create web.xml

web.xml is called the web application deployment descriptor. This is a XML file that defines servlets, servlet mappings, listeners, filters, welcome files etc.

Deployment descriptor is a heart of any J2EE web application, so every web application must have a web.xml deployment descriptor directly under WEB-INF folder.

For the content of web.xml, please refer to Sample of web.xml and Sample of web.xml for Servlet 2.3 (For some web container which support Servlet 2.3 only (e.g. Tomcat (4.x))

Create hello.zul

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

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

Compress this folder

壓縮myZK成為myZK.zip,rename to myZK.war

c:\>"C:\Program Files\7-Zip\7z.exe" a -tzip c:\myZK c:\myZK\*

確認你的ZK.war的內容

myZK.war
│  hello.zul
│  
└─WEB-INF
    │  web.xml
    │  
    └─lib
            *.jar

Version History

Last Update : 2010/09/21

Version	Date	Content
5.0.4	9/21/2010	Created