关于FreeMarker 的基础学习请参考文档。。这里主要记录 FreeMarker 的一些问题。。
1.FreeMarker 乱码问题
在struts2 中s:component默认是使用freemarker模板方式处理
IDE是MyEclipse6.5,使用的是默认的GBK编码:可以在这里查看:Window->Preferences->Workspace->Text file encoding
struts2的配置文件中是这么配置编码的:<constant name="struts.i18n.encoding" value="utf-8" />
使用s:component时,模板页内容有中文时会乱码,在网上查了一通,自已又尝试了多种方式,一直无法解决乱码问题,郁闷了很长一段时间。无意间发现,修改ftl文件的编码即可很容易解决乱码问题:选择ftl文件->右键->Properties->Text file encoding,改为utf-8。
2、FreeMarker 和Struts2 的整合
在FreeMarker模板中使用标签毕竟不同于在JSP页面中使用标签,因为FreeMarker不支持使用taglib指令来导入标签库.但Struts2为了在FreeMarker模板中使用标签库提供了额外的支持.可以按照下面的步骤进行: 1,将系统所需要的标签库定义文件(.tld文件)复制到WEB-INF目录下,对于Struts2,则是复制struts2-core-2.0.11.2.jar中的META-INF\struts-tags.tld文件 2,在web.xml文件中启动JspSupportServlet.为了启动它,则应该在web.xml文件中增加如下配置片段: <!-- 定义一个JspSupportServlet --> <servlet> <servlet-name>JspSupportServlet</servlet-name> <servlet-class>org.apache.struts2.views.JspSupportServlet</servlet-class> <!-- 配置JspSupportServlet优先启动 --> <load-on-startup>1</load-on-startup> </servlet> 3,在FreeMarker模板中使用assign指令导入标签库,导入标签库的代码如下: <#-- 定义/WEB-INF/struts-tags.tld文件对应的标签库前缀为s --> <#assign s=JspTaglibs["/WEB-INF/struts-tags.tld"] />
Struts2解析FreeMarker模板中变量的顺序如下:
1,FreeMarker模板内建的变量;
2,ValueStack中的变量;
3,ActionContext中的变量;
4,HttpServletRequest中的属性;
5,HttpSession中的属性;
6,ServletContext范围的属性.
FreeMarker模板的内建变量有如下几个:
1,stack:代表ValueStack本身,可通过如下方式来访问其中的变量"${stack.findString('ognl expr')}"
2,action:代表刚刚执行过的Action实例
3,response:代表HpptServletResponse实例
4,res:代表HpptServletResponse实例
5,request:代表HpptServletRequest实例
6,req:代表HpptServletRequest实例
7,session:代表HpptSession实例
8,application:代表ServletContext实例
9,base:代表用户请求的上下文路径.
FreeMarker中访问Servlet/JSP范围对象
Struts2还为在FreeMarker模板中访问Servlet/JSP范围对象提供了支持,通过这种支持可以直接访问这些变量.
访问application范围内的属性代码如下:
<#if Application.attributeName?exists>
${Application.attributeName}
</#if>
也可以通过使用Struts2标签来输出,代码如下:
<@s.property value="${#application.attributeName}" />
访问session范围内的属性如下:
<#if Session.attributeName?exists>
${Session.attributeName}
</#if>
或
<@s.property value="${#session.attributeName}" />
访问request范围内的属性如下:
<#if Request.attributeName?exists>
${Request.attributeName}
</#if>
或
<@s.property value="${#request.attributeName}" />
对于request,还可以访问request的请求参数,如下:
<#if Parameter.parameterName?exists>
${Parameter.parameterName}
</#if>
或
<@s.property value="${#parameter.parameterName}" />
访问ValueStack上下文参数,代码如下:
${stack.findValue('#myContextParam')}
或
<@s.property value="${#myContextParam}" />
3、FreeMarker 的内建函数
chunk, is_date, last, root, j_string, round, contains, is_hash, long, float, ends_with, namespace, matches, time, values, seq_last_index_of, uncap_first, byte, substring, is_transform, web_safe, groups, seq_contains, is_macro, index_of, word_list, int, is_method, eval, parent, xml, number, capitalize, if_exists, rtf, node_type, double, is_directive, url, size, default, floor, ceiling, is_boolean, split, node_name, is_enumerable, seq_index_of, is_sequence, sort, is_node,
sort_by, left_pad, cap_first, interpret, children, node_namespace, chop_linebreak, date, short, last_index_of, is_collection, ancestors, length, trim, datetime, is_string, reverse, c, keys, upper_case, js_string, has_content, right_pad, replace, is_hash_ex, new, is_number, lower_case, is_indexable, string, exists, html, first
具体的用途,以后有空再总结,最近用到的有
一般写法是这个样子的
<#list dataEntity as de>
<a href="${de.url}">${de.name}</a>
</#list>
要是排序,则用
<#list dataEntity?sort as de>
<a href="${de.url}">${de.name}</a>
</#list>
这是按元素的首字母排序。若要按list中对象元素的某一属性排序的话,则用
<#list dataEntity?sort_by([“name”]) as de>
<a href="${de.url}">${de.name}</a>
</#list>
这个是按list中对象元素的[name]属性排序的,是升序,而我们大多情况要用到降排序,这时得改成如下的样子:
<#list dataEntity?sort_by([“name”])?reverse as de>
<a href="${de.url}">${de.name}</a>
</#list>