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来将负责收集页面读/写操作统计工作。