如果要使用ZK的话在web.xml中做一些配置是肯定少不了的,其中配置DHtmlLayoutServlet就是其中之一,当然现在的J2EE规范提倡使用Filter了,zk也提供了DHtmlLayoutFilter,不过它们完成的功能都是类似的,在此仅以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> <init-param> <param-name>log-level</param-name> <param-value>DEBUG</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet>
对上述配置这里不做任何说明,但是有一点需要指出,就是上面的配置中指定这个servlet的启动参数是1,即在Web容器启动时就会进行初始化,我们关心的是DHtmlLayoutServlet在初始化时都做了哪些工作,这对我们了解zk的工作原理有好处。
通过阅读源码可以知道DHtmlLayoutServlet的实例有两个重要的私有属性,它们的类型分别是ServletContext与WebManager,初始化的任务除了初始化这两个属性外还要解析日志级别(log-level)、是否压缩输出(compress)以及更新URI(update-uri)参数,这些参数是在配置servlet时指定的,其中的updateURI还会被用于创建WebManager实例。
_webman = new WebManager(_ctx, updateURI);
_ctx.setAttribute(ATTR_LAYOUT_SERVLET, this);
注意:在一个web应用中只会有一个DHtmlLayoutServlet的实例存在。