XML Technology Research Lab: 安裝 ZK

安裝 ZK

The following examples had been tested on Mozilla's Firefox and Microsoft's IE. The document is provided as is. You are welcomed to use it for non-commercial purpose.
Written by: 國立中興大學資管系呂瑞麟 Eric Jui-Lin Lu

請勿轉貼

看其他教材

安裝 ZK 的過程主要分成下列幾個步驟，在這裡我們假設 ZK 會安裝給某一特定專案使用：

首先我們需要安裝 Tomcat，其安裝的步驟說明於安裝 Tomcat 5.5.x。安裝後，我們已經有了 d:\tomcat\webapps\xml 目錄，也就是有了一個名為 xml 的專案。
若已經依照上一步驟安裝 Tomcat，請先執行 d:\tomcat\bin\shutdown.bat 來停止 Tomcat。
請到 ZK 下載頁下載 zk-bin-prof-3.6.x.zip 並解縮到任一空目錄，我們假設解壓縮到 d:\。
解壓縮後，請到 d:\zk-bin-3.6.x 目錄，並將 dist/lib/*.jar, dist/lib/zkforge/*.jar, 和 dist/lib/ext/*.jar 複製到 d:\tomcat\webapps\xml\WEB-INF\lib 目錄內（複製檔案前，記得先新增一個 lib 目錄在 d:\tomcat\webapps\xml\WEB-INF 內）。

請新增一個 web.xml 檔在 d:\tomcat\webapps\xml\WEB-INF 目錄內，其內容如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"          
         xmlns="http://java.sun.com/xml/ns/javaee"          
         xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"          
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee          
         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 
         id="WebApp_ID" version="2.5">
  <display-name>Welcome to ZK</display-name>
  <listener>
        <description>
        Used to cleanup 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>
        The servlet loads the DSP pages.</description>
        <servlet-name>dspLoader</servlet-name>
        <servlet-class>
        org.zkoss.web.servlet.dsp.InterpreterServlet</servlet-class>
  </servlet>
  <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>
        <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>dspLoader</servlet-name>
        <url-pattern>*.dsp</url-pattern>
  </servlet-mapping>
  <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-mapping>
        <servlet-name>auEngine</servlet-name>
        <url-pattern>/zkau/*</url-pattern>
  </servlet-mapping>
  <welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>default.html</welcome-file>
    <welcome-file>default.htm</welcome-file>
    <welcome-file>default.jsp</welcome-file>
    <welcome-file>index.zul</welcome-file>
  </welcome-file-list>
</web-app>

完成後，請記得重新啟動 Tomcat。
為了確認 ZK 的安裝是否正確，讓我們新增一個 hello.zul 的檔案到 d:\tomcat\webapps\xml 目錄內，hello.zul 的內容如下：（hello.zul 的內容，我們之後解釋）
```
<?xml version="1.0" encoding="Big5"?>
<window title="我的第一個視窗" border="normal" width="200px"> 
 Hello, World! 
</window>
```
請在你的瀏覽器輸入 http://localhost:8080/xml/hello.zul，你應該會看到如下的畫面，這就表示你的 ZK 已經安裝完成了。

Written by: 國立中興大學資管系呂瑞麟 Eric Jui-Lin Lu

XML Technology Research Lab

安裝 ZK

安裝 ZK

沒有留言:

張貼留言