FreeMarker基本语法的使用
参考博客: http://www.cnblogs.com/panchanggui/p/9346574.html
https://blog.csdn.net/zyy88886666/article/details/79134282
https://blog.csdn.net/nengyu/article/details/6829244
https://blog.csdn.net/fhx007/article/details/7902040
https://www.imooc.com/article/16706
0、注释
:<#-- 注释内容 -->
格式部分,不会输出
1、字符输出
常用内部函数：
字符串的两种拼接方式拼接：
可以通过如下语法来截取子串:
2、日期输出
3、数字输出(以数字20为例)
数字格式化插值可采用#{expr;format}形式来格式化数字,其中format可以是:
mX:小数部分最小X位
MX:小数部分最大X位
4、申明变量
申明变量的几种方式
5、比较运算符
表达式中支持的比较运算符有如下几个:
= 或 == ：判断两个值是否相等.
!= ：判断两个值是否不等.
> 或 gt ：判断左边值是否大于右边值
>= 或 gte ：判断左边值是否大于等于右边值
< 或 lt ：判断左边值是否小于右边值
<= 或 lte ：判断左边值是否小于等于右边值
6、算术运算符
FreeMarker表达式中完全支持算术运算,
FreeMarker支持的算术运算符包括:+, - , * , / , %
注意：
（1）、运算符两边必须是数字
（2）、使用+运算符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串再连接,如:${3 + "5"},结果是:35
7、逻辑运算符
逻辑运算符有如下几个:
逻辑与:&&
逻辑或:||
逻辑非:!
逻辑运算符只能作用于布尔值,否则将产生错误
8、FreeMarker中的运算符优先级如下(由高到低排列):
①、一元运算符:!
②、内建函数:?
③、乘除法:*, / , %
④、加减法:- , +
⑤、比较:> , < , >= , <= (lt , lte , gt , gte)
⑥、相等:== , = , !=
⑦、逻辑与:&&
⑧、逻辑或:||
⑨、数字范围:..
实际上,我们在开发过程中应该使用括号来严格区分,这样的可读性好,出错少
9、if 逻辑判断（注意：elseif 不加空格）
if 空值判断
10、switch (条件可为数字，可为字符串)
11、集合 & 循环
12、Map对象
13、FreeMarker支持如下转义字符:
\" ：双引号(u0022)
\' ：单引号(u0027)
\\ ：反斜杠(u005C)
\n ：换行(u000A)
\r ：回车(u000D)
\t ：Tab(u0009)
\b ：退格键(u0008)
\f ：Form feed(u000C)
\l ：<
\g ：>
\a ：&
\{ ：{
\xCode ：直接通过4位的16进制数来指定Unicode码,输出该unicode码对应的字符.
如果某段文本中包含大量的特殊符号,FreeMarker提供了另一种特殊格式:可以在指定字符串内容的引号前增加r标记,在r标记后的文件将会直接输出.看如下代码:
${r"${foo}"} // 输出 ${foo}
${r"C:/foo/bar"} // 输出 C:/foo/bar
14、include指令
15、import指令
17、compress 压缩
18、escape,noescape 对字符串进行HTML编码
---------------------------------- 高级语法 ----------------------------------
1、global全局赋值语法
2、setting 语法
3、macro宏指令
例子1：
例子2：
例子3：
例子4：在nested指令中使用循环变量时,可以使用多个循环变量,看如下代码:
freemarker 宏嵌套nested 的使用:
http://blog.sina.com.cn/s/blog_7e5699790100z59g.html
4、结束macro指令
FreeMarker 工具类：
https://files.cnblogs.com/files/duke-cui/FreeMarkerUtil.rar
二、Freemarker语法及使用方法
1. 取值(插值)指令及适用类型：
(1) ${var}
适用类型：java中常用的八大基本类型以及我们的String引用类型，但是，freemarker中boolean类型显示时true==yes false==no
示例：
在后台文件中定义变量
String strVar = "世界你好";
int intVar = 10;
boolean booVar = true;
在页面中获取变量：
String获取：<font color="red"> ${strVar} </font><br>
int获取：<font color="red"> ${intVar} </font><br>
boolean获取：<font color="red"> ${booVar?string("yes","no")} </font>
展示结果：
String获取：世界你好
int获取：10
boolean获取：yes
(2)${var!}
适用类型：对 null 或者不存在的对象进行取值，可以设置默认值，例：${var!'我是默认值'} 即，有值时显示正常值，无值时显示默认值
示例：
在后台文件中定义变量
String strVar = "世界你好";
String str = null;
在页面中获取变量：
String获取：<font color="red"> ${strVar!"我是空"} </font><br>
str获取：<font color="red"> ${str!} </font><br>
str获取：<font color="red"> ${str!"默认"} </font><br>
展示结果：
String获取：世界你好
str获取：
str获取：默认
(3)${封装对象.属性}
适用类型：对封装对象进行取值，例：${User.name}
示例：
在后台文件中封装对象User[ name, age ]
String name = "姓名";
int age = 18;
在页面中获取变量：
name获取：<font color="red"> ${User.name} </font><br>
age获取：<font color="red"> ${User.age} </font><br>
展示结果：
name获取：姓名
age获取：18
(4)${date?String('yyyy-MM-dd')}
适用类型：对日期格式进行取值，在这里我要强调的是，定义Date类型的变量时，java.util.Date无法输出日期，须使用java.sql.Date
示例：
在后台文件中定义变量
java.sql.Date date = new Date().getTime();
java.sql.Date time = new Date().getTime();
java.sql.Date datetime = new Date().getTime();
在页面中获取变量：
date获取：<font color="red"> ${date?string('yyyy-MM-dd')} </font><br>
time获取：<font color="red"> ${date?string('HH:mm:ss')} </font><br>
datetime获取：<font color="red"> ${date?string('yyyy-MM-dd HH:mm:ss')} </font><br>
展示结果：
name获取：姓名
age获取：18
(5)${var?html}
适用类型：转义HTML内容
示例：
在后台文件中封装变量Menu[ name, model ]
Menu m = new Menu();
m.setName(" freemarker ");
m.setModel("<font color = 'red'>我只是个菜单</font>");
在页面中获取变量：
非转义获取：<font color="red"> ${m.model} </font><br>
转义获取： ${m.model?html} </font><br>
展示结果：
非转义获取：我只是个菜单
转义获取：<font color = 'red'>我只是个菜单</font>
(6)<#assign num = 100 />
适用类型：定义变量，支持计算和赋值
示例：
在页面中定义变量：
<#assign num = 100 />
num获取：<font color="red"> ${num)} </font><br>
计算结果：<font color="red"> ${num * 10} </font><br>
展示结果：
num获取：100
计算结果：1000
(7)对List集合进行取值
<#list list集合 as item>
${item} --取值
</#list>
示例：
在后台文件中定义变量
List<String> strList = new ArrayList<String>();
strList.add("第一个值");
strList.add("第二个值");
strList.add("第三个值");
在页面中获取变量：
<#list strList as item>
${item!}<br/> --取值
</#list>
展示结果：
第一个值
第二个值
第三个值
(8)对Map集合进行取值
<#list map?keys as key>
${key}:${map[key]}
</#list>
示例：
在后台文件中定义变量
Map<String, Object> m = new HashMap<String, Object>();
m.put("name","姓名");
m.put("age",18);
m.put("sex","男");
在页面中获取变量：
<#list m?keys as key>
${key}:${m[key]}
</#list>
展示结果：
name：姓名
age：18
sex：男
2. 条件判断指令：
(1) if
格式：<#if 条件>
输出
</#if>
示例：
在页面中定义变量并判断条件：
<#assign age = 18 /><br>
<#if age == 18>
<font color="red"> age = 18</font>
</#if>
展示结果：
age = 18
(2) if - else
格式：<#if 条件>
输出
<#else>
输出
</#if>
示例：
在页面中定义变量并判断条件：
<#assign age = 20 /><br>
<#if age == 18>
<font color="red"> age = 18</font>
<#else>
<font color="red"> age != 18</font>
</#if>
展示结果：
age != 18
(3) if - elseif - else
格式：<#if 条件1>
输出
<#elseif 条件2>
输出
<#else>
输出
</#if>
示例：
在页面中定义变量并判断条件：
<#assign age = 20 /><br>
<#if age > 18>
<font color="red">青年</font>
<#elseif age == 18>
<font color="red"> 成年</font>
<#else>
<font color="red"> 少年</font>
</#if>
展示结果：
成年
(4) switch --常与case break default一起使用 参数可为字符串
格式：<#switch var>
<#case 条件1>
输出
<#break>
<#case 条件2>
输出
<#break>
<#default>
输出
</#switch>
示例：
在页面中定义变量并判断：
<#switch var="星期一">
<#case "星期一">
油焖大虾
<#break>
<#case "星期二">
炸酱面
<#break>
<#default>
肯德基
</#switch>
展示结果：
油焖大虾
3. 自定义函数、自定义指令：
(1) 自定义函数
实现TemplateMthodModelEx
(2) 自定义指令
实现TemplateDirectiveModel
示例：
<@自定义指令名称 入参(key-value格式) ; 出参(list格式)>
运行条件
</@自定义指令名称>
PS:不同的返回值用逗号( , )间隔开
4.常用内建函数、macro(宏指令)、function(函数指令)：
(1) 常用内建函数
处理字符串：
substring 截取字符串，包头不包尾（下标）
cap_first 第一个字母大写
end_with 以什么字母结尾
contains 是否包含目标字符串
date datetime time 转换成日期格式
starts_with 以什么字母开头
index_of 返回某个指定的字符串值在字符串中首次出现的位置（下标）
last_index_of 获取指定字符出现的最后位置（下标）
split 分隔
trim 去两端空格
处理数字：
string
x?string("0.##") 变成小数点后几位
round 四舍五入
floor 去掉小数点
ceiling 近1 变成整数
处理list:
first: 取List值第一个值
last: 取List值最后一个值
seq_contains: 是否包含指定字符
seq_index_of: 指定字符所在位置
size: 集合大小
reverse: 集合倒序排列
sort: 对集合进行排序
sort_by: 根据某一个属性排序
chunk: 分块处理
其他:
is_string: 是否为字符类型
is_number: 是否为整数类型
is_method: 是否为方法
(): 判断整个变量
has_content: 判断对象是否为空或不存在
eval： 求值
(2) macro(宏指令)
调用：<@macro_name param />
语法：<#macro 变量名 参数>
<#nested/>
</#macro>
(3) function(函数指令)
调用：${function_name(param)}
语法：<#function 变量名 参数>
<#return>
</#function>
