FreeMarker基础知识

${String?ends_with("str")} //判断字符串是否以指定子串结尾/返回布尔值
${String?index_of("查找的子串"[,开始查找的索引])} //在字符串中查找子串第一次出现处的索引,没有找到则返回-1
${String?contains("str")} //判断字符串中是否包含子串,返回布尔值
3.FreeMarker是一个轻量级组件(易于嵌入到产品中),不需要Servlet环境
4.可以在FreeMarker模板中清楚和直觉地访问XML对象模型 //如:用<#recurse>和<#visit>指令(2.3版本)结构递归遍历XML树
5.FreeMarker页面的扩展/后缀名为.ftl
集合对象?first //获取集合中的第一个值
集合对象?last //获取集合中的最后一个值
集合对象?reverse //将集合中的顺序反转(即倒序排序)
集合对象?size //获取集合中的元素个数
集合对象?sort //将集合中的对象转化为字符串后顺序排序
判断对象是否为空:?exists
判断变量是否为空:?if_exists
判断集合/数组中是否有数据:?has_content
(2).switch结构:
<#switch 变量>
<#case value>...<#break>
<table border=4 cellspacing=0 cellpadding=4><tr><td>
<#nested>
</tr></td></table>
</#macro>
集合对象?sort_by(value) //按集合中对象的属性value进行排序
7.ftl访问Hash:
hash对象?keys //返回hash中的所有key,返回结果为集合
hash对象?values //返回hash中的所有value,返回结果为sequence
调用时在调用宏体中加入要嵌套的内容:<@宏名>嵌套内容</@宏名>,输出:<table border=4 cellspacing=0 cellpadding=4><tr><td>嵌套内容</tr></td></table>
n.ftl中的其它用法:
取值:${4个范围内的非int型的任意对象},#{4个范围内的int型变量}
一.FreeMarker简介:
1.FreeMarker是一个模板引擎,一个基于模板生成HTML/XML/RTF/Java源代码等等的通用工具,使用纯Java编写
2.FreeMarker与容器无关,因为它并不知道HTTP或Servlet,也可以在FreeMarker模板中使用JSP标记库 //支持JSP标记库
f:只替换第一个出现被替换字符串的字符串
r:表示第二个参数(替换后的子串)是正则表达式
m:
s:
c:
${String?length} //获取字符串长度
${String?trim} //字符串去空格
${String?upper_case} //将字母字符串转为大写
获取集合的当前循环索引:集合的别名_index
判断是否达到最后一次循环:集合的别名_has_next //返回true/false
注:ftl中可以使用类似[i]语法的索引方式访问集合/数组中的元素、可以在循环外访问循环体内的控制变量
6.ftl访问集合/数组:
#{int?string.percent} //将数字转为百分比(%)形式,还可用${int?string("percent")}
数字格式化:#{变量;format},其中format可以是:mn:小数部分最少n位,Mn:小数部分最多n位;如:
<#assign a=2.582/>,<#assign b=4/>
8.ftl中定义变量:
(1).使用<#assign 变量名="值">指令定义局部变量 //用于在页面创建或替换一个变量(当前ftl范围内/page范围内的变量声明,在宏定义体中有效)
(2).plain变量：可以在模板的任何地方访问，包括使用include指令插入的模板，
注释使用<#-- 注释内容 -->
${String?split("*")} //用指定的分隔符将字符串拆分成数组
${String?replace("字符串中指定的子串","替换后的子串"[,"规则参数"])} //将字符串中的子串从左到右替换为指定的子串,规则参数有:i、r、m、s、c、f,具体含义如下:
i:不区分大小写
算术运算符:+、-、*、/、%
逻辑操作符:&&:and、||:or、!:not //只能用于布尔值
<#recurse>和<#visit>指令 //递归遍历XML树,访问XML对象模型
10.import指令:用于导入FreeMarker模板中的所有变量,并将该变量放置在指定的Map对象中
${String?string("yyyy-MM-dd HH:mm:ss zzzz")/("EEE,MMM d,''yy")/("EEEE,MMMM dd,yyyy,hh:mm:ss a '('zzz')'")} //日期格式化
${String?substring(startIndex,endIndex)} //截取字符串,还可以用更简单的${String[0..number]}
${String?number} //将字符串转为数字
${bool?string("yes/是","no/否")} //布尔值格式化
3.ftl中对整型的处理:
#{int?c} //将数字转为字符串,还可用#{int?string}
#{int?string.currency} //将数字转为货币(￥)形式,还可用#{int?string("currency")}
、检查map是否为空、获得key或值的list
1.ftl中判断对象/字符串是否为null:
在<#if>指令中用Object或String?exists判断,在${}指令中用Object或String?if_exists输出布尔形式判断
2.ftl中对字符串的处理
(3).使用local指令创建和替换 9.ftl中 Nhomakorabea运算符:
比较运算符可以用gt、gte、、lt、lte、或>、>=、==、<、<=、!= //不推荐使用后者(因为麻烦),因为Freemarker会将>解释成FTL标记的结束字符,故对于>和>=要用括号括起来(如:<#if (x>y)>)
二.FreeMarker使用:
三.FreeMarker中的指令语法:ftl页面支持所有Html标记和js、css语法,ftl指令区分大小写,ftl页面中的<script>中也可使用ftl指令
注:ftl中可以使用内置函数操作/维护与Java后台程序无关的string、list和map等,如:通过索引访问list元素、获得子list、合并list、对list排序,通过key变量访问map元素
<#import "/lib/common.ftl" as com> //此处将导入/lib/common.ftl模板文件中的所有变量,将这些变量放置在一个名为com的Map对象中
11.include指令:用于包含指定页面(类似JSP的包含指令,如:<#include "/common/copyright.ftl" encoding="GBK">)
<#case value>...<#break>
<#default>...<#break>
</#switch>
5.ftl中的循环结构:<#list 4个范围内的集合/数组 as 遍历的集合/数组中的对象的别名>循环体</#list> //ftl中的循环也支持break子句
12.setting指令:用来设置ftl使用的环境,如:<#setting locale="en_US">
13.ftl中的宏:宏相当于程序中的函数,可以传参,可以调用宏以执行宏体内的内容,在那里调用宏宏体中的内容就相当于写在那里。以便在模板中通过用户定义指令使用该变量
(1).宏的定义:用macro指令定义,如:<#macro 宏名 [宏的输入参数名 ...(可选)]>Hello Joe!</#macro> //创建时可带多个参数,可在定义时指定参数的缺省值,否则在调用宏
时必须对所有参数赋值,宏的参数只在宏范围中有效,在宏体中使用宏中的参数用${参数名}
(2).宏的调用:使用@表示调用宏,可以是双标签也可以是单标签,如:<@宏名 [宏的输入参数名="值" ...(可选,当宏定义中带参时这里才有参数)]></@宏名> //宏调用中可嵌套