第 18 章 Portal 整合

目录

配置
WEB-INF/portlet.xml
WEB-INF/web.xml
使用方法
zk_page zk_richlet参数和属性
事例

ZK提供了一个portlet来为JSR 168 compliant portal加载ZUML页面。这个portlet被称为ZK portlet 加载器(ZK portlet loader),它就像org.zkoss.zk.ui.http.DHtmlLayoutPortlet一样被实现。

配置

WEB-INF/portlet.xml

为使用ZK portlet 加载器,首先你需要将下列定义添加至WEB-INF/portlet.xml。注意,exp iration-cache必须被设置为0,以阻止portal缓存结果。

<portlet>
   <description>ZK loader for ZUML pages</description>
   <portlet-name>zkPortletLoader</portlet-name>
   <display-name>ZK Portlet Loader</display-name>
   <portlet-class>org.zkoss.zk.ui.http.DHtmlLayoutPortlet</portlet-class>
   <expiration-cache>0</expiration-cache>
   <supports>
      <mime-type>text/html</mime-type>
      <portlet-mode>VIEW</portlet-mode>
   </supports>
   <supported-locale>en</supported-locale>
   <portlet-info>
      <title>ZK</title>
      <short-title>ZK</short-title>
      <keywords>ZK,ZUML</keywords>
   </portlet-info>
</portlet>

WEB-INF/web.xml

ZK portlet加载器实际上将ZUML 页面的加载委派(delegate)给ZK加载器(org.zkoss.zk.ui.http.DHtmlLayoutServlet)。因此,你必须配置WEB-INF/web.xml,将像在 the Developer's Reference 的附录A(Appendix A)中指定的那样,即使你仅想使用portlet。