ZK框架筆記2、ZK框架安裝、相關類庫、web及zk配置

1、先去ZK官網注冊一個賬號

2、在MyEclipse菜單欄中Help----Eclipse Marketplace中搜索ZK Studio，點擊install安裝即可

     

 

3、相關類庫

bsh.jar：BeanShell Java代碼解析器

commons-el.jar：Apache的表達式語言(EL)解析器類庫

commons-fileupload.jar：Apache的文件上傳類庫

commons-io.jar：Apache的I/O流處理類庫(和文件上傳包一起使用)

dojoz.jar：Dojo Ajax工具箱——相關的組件

fakez.jar：FCKeditor HTML編輯器——相關的組件

gmapsz.jar：Google地圖——相關的組件

zcommon.jar：ZK的通用類庫

zhtml.jar：XTHML——相關的組件

zk.jar：ZK內核代碼

zkplus.jar：Acegi Security，Spring，Hibernate和數據庫綁定的繼承代碼

zul.jar：XUL——相關的組建

zweb.jar:Web——相關的實用代碼

 

4、配置web.xml

<listener>
<display-name>ZK Session cleaner</javaee:display-name>
<listener-class>org.zkoss.zk.ui.http.HttpSessionListener</javaee:listener-class>
</listener>
 
<servlet>
<servlet-name>zkLoader</servlet-name>
<servlet-class>org.zkoss.zk.ui.http.DHtmlLayoutServlet</servlet-class>
<init-param>
<param-name>update-uri</javaee:param-name>
<param-value>/zkau</javaee:param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
 
<servlet>
<servlet-name>auEngine</servlet-name>
<servlet-class>org.zkoss.zk.au.http.DHtmlUpdateServlet</servlet-class>
</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>
 
<!-- richlet的可選配置 -->
<servlet-mapping>
<servlet-name>zkLoader</servlet-name>
<url-pattern>/zk/*</url-pattern>
</servlet-mapping>
 
<servlet-mapping>
<servlet-name>auEngine</servlet-name>
<url-pattern>/zkau/*</url-pattern>
</servlet-mapping>

    兩個Servlet是DHtmlLayoutServlet和DHtmlUpdateServlet。其中DHtml layout servlet命名為zkLoader，它負責加載ZUMLy頁面。同時，當servlet容器接受到來自瀏覽器請求時，會根據頁面的定義創建這些組件。DHtml update servlet被命名為auEngine，它負責處理ZK的事件請求(一個基於Ajax的XMLHttpRequest)。zkLoader的update-uri必須和auEngine的uri-pattern保持一致，否則web應用不能正常運行。

    除了使用ZMUL來構建zk web外，還可以使用richlet來構建純Java的Web應用。每一個richlet都是一個曉得java程序，負責創建所有需要的組件去響應用戶的請求。

 

5、配置zk.xml

<!-- 可選配置 -->
<!--
你可以定義如下任何數量的richlet
注意:要使用一個richlet，必須在web.xml中映射zkLoader到/xx/*,這個xx可以是任何嗎，名字，
並且最終的URL應該是/xx/richlet-url.
-->
<richlet>
<richlet-class>org.zkoss.zkdemo.test.TestRichlet</richlet-class>
<richlet-url>/test</richlet-url>
<!-- 任意多個初始化參數
<init-param>
<param-name>any</param-name>
<param-value>any</param-value>
</init-param>
-->
</richlet>
<!-- 可選配置 -->
<session-config>
<!-- 一個空URL將導致瀏覽器重新加載同樣的URL -->
<timeout-uri>/timeout.zul</timeout-uri>
</session-config>
<!-- 可選配置 -->
<listener>
<listener-class>org.zkoss.zk.ui.util.Statisic</listener-class>
</listener>

 　　richlet必須和web.xml文件中所定義的richlet URL pattern 一同工作，用來決定哪個richlet類處理特定的URL pattern的請求。比如http://localhost:8080/zkdemo-all/test這個URL的請求應該由指定的org.zkoss.zkdemo.test.TestRichlet類來進行處理。 

        session-config為ZK Web應用定義了回話屬性。其中timeout-url是一個子屬性，它定義了一個web頁面在繪畫超時后的響應。如果這個屬性值保留空白，那么瀏覽器重新加載同樣的URL。

      監聽器被用來配置可選的自定義回調監聽器類，這個類需要使用Java來編寫，而且它是由開發人員自己實現的。Statistic這個Java來將負責收集頁面讀/寫操作統計工作。