本篇博文将叙述在freemarker中以标签的形式调用自定义的zk component,jsp的方式就不赘述了,很类似。部分组件使用官方提供的demo,下载点此
,zk组件定制过程不在本文讨论范围。
首先确保zuljsp.jar在项目中
以zssapp component 为例,该组件是官方demo在zss-app-2.0.1.zip 可以获得源代码。
<component> <component-name>zssapp</component-name> <extends>div</extends> <component-class>org.zkoss.zss.app.zul.Zssapp</component-class> </component>
提供一个标签解析的工具类,需要扩展zk的标签基类BranchTag
package app.support.util; import org.zkoss.jsp.zul.impl.BranchTag; public class ZssappTag extends BranchTag { @Override protected String getComponentName() { return "zssapp"; } }
加入一个tld文件
<?xml version="1.0" encoding="UTF-8" ?> <taglib xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:zk="http://www.zkoss.org/" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-jsptaglibrary_2_0.xsd" version="2.0"> <description> The JSP Tags for ZK XUL Components </description> <tlib-version>1.5</tlib-version> <short-name>zssapp</short-name> <uri>http://bijiqiang.me/jsp/zul</uri> <tag> <description> Define the Spreadsheet comonent. </description> <name>zssapp</name> <tag-class>app.support.util.ZssappTag</tag-class> <body-content>scriptless</body-content> <attribute> <description> If false, this tag is ignored. Default: true. </description> <name>if</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <description> If true, this tag is ignored. Default: false. </description> <name>unless</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <description> Default : Zul Component Spreadsheet. </description> <name>use</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <description> Used to forward Event, same as ZUL's forward. </description> <name>forward</name> <required>false</required> <rtexprvalue>true</rtexprvalue> </attribute> <dynamic-attributes>true</dynamic-attributes> </tag> <!-- Functions --> </taglib>
tag-class标签应指定到刚刚书写的标签工具类,name标签要与标签工具类的getComponentName返回值相同。
web.xml 应包含以下片段
<servlet> <servlet-name>JspSupportServlet</servlet-name> <servlet-class>org.apache.struts2.views.JspSupportServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet>
struts action代码如下负责转发
package app.action; import org.springframework.security.core.Authentication; import org.springframework.security.core.context.SecurityContext; import org.springframework.security.core.context.SecurityContextHolder; import app.model.Role; import app.model.User; import app.support.action.BaseAction; import com.opensymphony.xwork2.Action; public class IndexAction extends BaseAction { private String test="/xls/海水质量监测-水质数据.xls"; public String execute() { return Action.INPUT; } public String getTest() { return test; } public void setTest(String test) { this.test = test; } }
struts.xml 片段
<package name="index" extends="struts-default"> <action name="freemarker" class="app.action.IndexAction"> <result name="input" type="freemarker">/WEB-INF/freemarker_test.ftl </result> </action> </package>
freemarker_test.ftl页面
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <#assign z=JspTaglibs["http://www.zkoss.org/jsp/zul"] /> <#assign app=JspTaglibs["/WEB-INF/tld/zk/zssapp.tld"]> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>ZK Spreadsheet</title> </head> <body> <@z.page zscriptLanguage="java"> <h2>ZK Spreadsheet</h2> <@z.window height="100%"> <@app.zssapp id="fluSpreadsheet" src="${test}" width="100%" height="100%" maxrows="51" maxcolumns="42" style="border:1px solid black;"/> </@z.window> </@z.page> </body> </html>
<#assign z=JspTaglibs["http://www.zkoss.org/jsp/zul"] /> 是引用zk默认提供的标签
<#assign app=JspTaglibs["/WEB-INF/tld/zk/zssapp.tld"]> 是引用自定制的zk组件
顺便吐个槽,zk的jar没用maven版本管理,连版本号都没有,官方的例子经常是跑不通的,哎。