请注意，FreeMarker并不解析FTL标签以外的文本、插值和注释， 上面示例在HTML属性中使用FTL标签也不会有问题。

使用内建函数

内建函数很像子变量(如果了解Java术语的话，也可以说像方法)， 它们并不是数据模型中的东西，是 FreeMarker 在数值上添加的。 为了清晰子变量是哪部分，使用 ?(问号)代替 .(点)来访问它们。常用内建函数的示例：

user?html 给出 user 的HTML转义版本， 比如 & 会由 & 来代替。

user?upper_case 给出 user 值的大写版本 (比如 "JOHN DOE" 来替代 "John Doe")

animal.name?cap_first 给出 animal.name 的首字母大写版本(比如 "Mouse" 来替代 "mouse")

user?length 给出 user 值中 字符的数量(对于 "John Doe" 来说就是8)

animals?size 给出 animals 序列中 项目 的个数(我们示例数据模型中是3个)

如果在 <#list animals as animal> 和对应的 标签中：

animal?index 给出了在 animals 中基于0开始的 animal的索引值

animal?counter 也像 index， 但是给出的是基于1的索引值

animal?item_parity 基于当前计数的奇偶性，给出字符串 "odd" 或 "even"。在给不同行着色时非常有用，比如在 中。

一些内建函数需要参数来指定行为，比如：

animal.protected?string("Y", "N") 基于 animal.protected 的布尔值来返回字符串 "Y" 或 "N"。

animal?item_cycle('lightRow','darkRow') 是之前介绍的 item_parity 更为常用的变体形式。

fruits?join(", ") 通过连接所有项，将列表转换为字符串， 在每个项之间插入参数分隔符(比如 "orange,banana")

user?starts_with("J") 根据 user 的首字母是否是 "J" 返回布尔值true或false。

内建函数应用可以链式操作，比如user?upper_case?html 会先转换用户名到大写形式，之后再进行HTML转义。(这就像可以链式使用 .(点)一样)

可以阅读 全部内建函数参考。

处理不存在的变量

数据模型中经常会有可选的变量(也就是说有时并不存在)。 除了一些典型的人为原因导致失误外，FreeMarker 绝不能容忍引用不存在的变量， 除非明确地告诉它当变量不存在时如何处理。这里来介绍两种典型的处理方法。

这部分对程序员而言: 一个不存在的变量和一个是 null 值的变量， 对于FreeMarker来说是一样的，所以这里所指的"丢失"包含这两种情况。

不论在哪里引用变量，都可以指定一个默认值来避免变量丢失这种情况， 通过在变量名后面跟着一个 !(叹号，译者注)和默认值。 就像下面的这个例子，当 user 不存在于数据模型时, 模板将会将 user 的值表示为字符串 "visitor"。(当 user 存在时， 模板就会表现出 ${user} 的值)：

Welcome ${user!"visitor"}!

也可以在变量名后面通过放置 ?? 来询问一个变量是否存在。将它和 if 指令合并， 那么如果 user 变量不存在的话将会忽略整个问候的代码段：

<#if user??>

Welcome ${user}!

关于多级访问的变量，比如 animals.python.price， 书写代码：animals.python.price!0 当且仅当 animals.python 永远存在， 而仅仅最后一个子变量 price 可能不存在时是正确的 (这种情况下我们假设价格是 0)。 如果 animals 或 python 不存在， 那么模板处理过程将会以"未定义的变量"错误而停止。为了防止这种情况的发生， 可以如下这样来编写代码 (animals.python.price)!0。 这种情况就是说 animals 或 python 不存在时， 表达式的结果是 0。对于 ?? 也是同样用来的处理这种逻辑的; 将 animals.python.price?? 对比 (animals.python.price)??来看。

二、FreeMarker常用语法

转载至：https://www.cnblogs.com/anyun/p/9426479.html

一、基本数据类型

布尔型：等价于java中的boolean类型， 不同的是不能直接输出，可以转换成字符串再输出

日期型：等价于java中的Date类型， 不同之处在于不能直接输出，需要转换成字符串再输出

数值型：等价于java 中的int, float, double 等数值类型，有三种显示形式：数值型(默认) 、货币型、百分比型

字符串型：等价于java 中的字符串，有很多内置函数

sequence 类型：等价于java中的数组，list，set 等集合类型

hash 类型：等价于java 中的Map 类型

二、 数据类型示例

【1. 布尔型】：

不能直接输出布尔型的值， 必须转换为string：$

在if标签中可以直接使用

<#if b>

b 的值为 true

【2. 日期型】

输出日期：$

只输出时间：$

输出日期时间：$

格式化日期： $

【3. 数值型】：

1. Freemarker 中预定义了三种数字格式，货币，百分比，数字，默认为数字格式

​ 货币：：${0.3?string.currency}

​ 百分比：${0.3?string.percent}

​ 数字（默认）：${0.3?string.number}

2.取整

向上取整

3.4 --> ${3.4?ceiling}

3.5 --> ${3.5?ceiling}

向下取整

3.4 --> ${3.4?floor}

3.5 --> ${3.5?floor}

四舍五入

3.4 --> ${3.4?round}

3.5 --> ${3.5?round}

3. 数字格式化， 使用0 表示不够 由0 补齐， 用# 表示不够不补齐

保留两位小数: 必须两位，不够补0, 当前一位为偶数时，五舍六入， 当前一位为基数时，四舍五入

0.135 -- > ${0.135?string('.00')}

0.125 -- > ${0.125?string('.00')}

0.1 -- > ${0.1?string('.00')}

保留两位小数: 最多两位，不够不补0, 当前一位为偶数时，五舍六入， 当前一位为基数时，四舍五入

0.135 -- > ${0.135?string('#.##')}

0.125 -- > ${0.125?string('#.##')}

0.1 -- > ${0.1?string('#.##')}

格式化整数， 用0 表示必须三位整数，不够由0 补齐

12.1 -- > ${12.1?string('000.00')}

12.125 -- > ${12.125?string('000.00')}

12.135 -- > ${12.135?string('000.00')}

格式化整数， 用0 表示必须三位整数，不够由0 补齐, 一个# 和 多个# 是一样的

12.1 -- > ${12.1?string('#.00')}

12.125 -- > ${12.125?string('#.00')}

12.135 -- > ${12.135?string('#.00')}

千位分割

123456789 --> ${123456789?string(',###')}

23456789 --> ${123456789?string(',####')}

4 数字转换成字符串：

​ 数字转换成字符串后，就可以直接用字符串的内置函数了

1234 -- > ${123?string}

1234 -- > ${123?string[0]}

<#-- ${123[2]} 报错 -->

**【4. 字符串型】

4.1 截取字符串subString(start,end):"hello,wold"**

截取

6~end: ${"hello,wold"?substring(6)}

截取

0~5: ${"Hello,World"?substring(0,5)}

4.2 字母大小写转换

首个单词的首字母大写: ${"hello world"?cap_first}

首个单词的首个字母母小写: ${"Hello World"?uncap_first}

所有单词首字母大写：${"hello world"?capitalize}

字符串大写： ${"hello,world"?upper_case}

字符串小写：${"hello,world"?lower_case}

4.3 判断是否以xxx 结尾

${"hello,world"?ends_with("world")?string} `

<#if "hello,world"?ends_with("world")>

hello,world 以字符串 world 结尾

4.4 判断是否以xxx 开头

${"hello,world"?starts_with("hello")?string}

<#if "hello,world"?starts_with("hello")>

hello,world 以字符串 hello 开头

4.5 返回字符串长度

${"hello,world"?length}

4.6 是否包含子串

返回为布尔值，布尔值不能直接输出，必须转换为string

${"hello,world"?contains("llo")?string};

<#if "hello,world"?contains("llo")>

"hello,world" 包含子串 "llo"

4.7 去除首尾空格

字符串：${" hello,world "?trim}

4.8 替换字符串

${"hello,world"?replace("o","0")}

4.9 查询字符串第一次出现的索引位置，如果不存在返回0

${"hello,world"?index_of("o")}

${"hello,world"?index_of("aaa")}

4.10 字符串分割数组

<#assign citys="beijing,tianjin,shanghai"?split(",")/>

<#list citys as city>

${city_index} --> ${city}

4.11 输出单个字母

${"hello"[0]}

【5. sequence】

1. 获取第一个元素:sequence?first

array: ${cityArray?first}

list: ${cityList?first}

set: ${citySet?first}

2. 获取最后一个元素：sequence?last

array: ${cityArray?last}

list: ${cityList?last}

set: ${citySet?last}

3. 返回sequence 的大小sequence?size

array: ${cityArray?size}

list: ${cityList?size}

set: ${citySet?size}

4. 排序：sequence?sort

sequence 元素为基本元素时（能转换为String的元素，非sequence 和 hash 元素）

array:sort,reverse

正 序：<#list cityArray as city>${city},

倒 序：<#list cityArray?reverse as city>${city},

升 序：<#list cityArray?sort as city>${city},

降 序：<#list cityArray?sort?reverse as city>${city},

list:sort,reverse

正 序：<#list cityList as city>${city},

倒 序：<#list cityList?reverse as city>${city},

升 序：<#list cityList?sort as city>${city},

降 序：<#list cityList?sort?reverse as city>${city},

set:sort,reverse

正 序：<#list citySet as city>${city},

倒 序：<#list citySet?reverse as city>${city},

升 序：<#list citySet?sort as city>${city},

降 序：<#list citySet?sort?reverse as city>${city},

sequence 元素为JavaBean时

正 序：

<#list department.employees as employee>

${employee_index} --> ${employee.name} --> ${employee.age} --> ${employee.sex}

逆 序：

<#list department.employees?reverse as employee>

${employee_index} --> ${employee.name} --> ${employee.age} --> ${employee.sex}

按name属性升序：

<#list department.employees?sort_by("name") as employee>

${employee_index} --> ${employee.name} --> ${employee.age} --> ${employee.sex}

按name属性降序:

<#list department.employees?sort_by("name")?reverse as employee>

${employee_index} --> ${employee.name} --> ${employee.age} --> ${employee.sex}

5. 遍历sequence, 包含索引值

array: <#list cityArray as city>

${city_index} --> ${city}

list: <#list cityList as city>

${city_index} --> ${city}

set: <#list citySet as city>

${city_index} --> ${city}

​ 6. 根据索引获取sequence 元素

array: ${cityArray[0]}

list: ${cityList[0]}

set: ${citySet[0]}

【6. map 类型】

1. map长度：${cityMap?size};

2. map的keys:cityMap.keys 返回的是一个sequence,类似于数组，所以不能直接输出，需要遍历

<#assign mapKeys=cityMap?keys/>

<#list mapKeys as mapKey>

${mapKey}

3. map的values: cityMap.values 返回的是一个sequence,类似于数组，所以不能直接输出，需要遍历

<#assign mapValues=cityMap?values/>

<#list mapValues as mapValue>

${mapValue}

4. 遍历map 元素： map 通过key获取value的方法用[]

<#list cityMap?keys as key>

${key_index} --> ${key} --> ${cityMap[key]}

**【7. JavaBean 类型】

1. 获取属性：${department.id} --> ${department.name}

2. 级联属性：${department.employees[0].name} --> ${department.employees[0].age} --> ${department.employees[0].sex}

3. 遍历数组：

<#list department.employees as employee>

${employee_index} --> ${employee.name} --> ${employee.age} --> ${employee.sex}

4. 排序

<#list department.employees?sort_by("name") as employee>

${employee_index} --> ${employee.name} --> ${employee.age} --> ${employee.sex}

三、maven依赖

https://mvnrepository.com/artifact/org.freemarker/freemarker

org.freemarker

freemarker

2.3.31