FreeMarker FTL标签

川长思鸟来 2022-05-26 04:12 244阅读 0赞

> **FreeMarker Template Language（FTL）属于简单、专用的语言。**

*  [FreeMarker 中文官方参考手册][FreeMarker]

FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成:  
1,文本:直接输出的部分  
2,注释:<\#-- … -->格式部分,不会输出  
3,插值:即$\{…\}或\#\{…\}格式的部分,将使用数据模型中的部分替代输出  
4,FTL指令:FreeMarker指定,和HTML标记类似,名字前加\#予以区分,不会输出

注意：使用freemaker，要求所有标签必须闭合，否则会导致freemaker无法解析。

## 基础语法 ##

### 1、字符输出 ###

> emp是POJO,name是POJO的属性

${emp.name?if_exists}　　　　　　// 变量存在，输出该变量，否则不输出
    ${emp.name!}　　　　　　　　　　  // 变量存在，输出该变量，否则不输出
    
    ${emp.name?default("xxx")}     // 变量不存在，取默认值xxx 
    ${emp.name!"xxx"}    　　　　　　// 变量不存在，取默认值xxx

**常用内部函数**

${"123<br>456"?html}    　　// 对字符串进行HTML编码，对html中特殊字符进行转义
    ${"str"?cap_first}    　　  // 使字符串第一个字母大写 
    ${"Str"?lower_case}        // 将字符串转换成小写 
    ${"Str"?upper_case}        // 将字符串转换成大写
    ${"str"?trim}              // 去掉字符串前后的空白字符

注意：[FreeMarker的html转义，可以防止跨站脚本攻击等问题][FreeMarker_html]

**字符串的两种拼接方式拼接**

${"hello${emp.name!}"}     // 输出hello+变量名
    ${"hello"+emp.name!}       // 使用+号来连接，输出hello+变量名

可以通过如下语法来截取子串:

<#assign str = "abcdefghijklmn"/>
    
    // 方法1
    ${str?substring(0,4)}  // 输出abcd
    
    // 方法2
    ${str[0]}${str[4]}    // 结果是ae
    ${str[1..4]}    　　　 // 结果是bcde
    
    // 返回指定字符的索引
    ${str?index_of("n")}

### 2、日期输出 ###

${emp.date?string('yyyy-MM-dd')} //日期格式

### 3、数字输出(以数字20为例) ###

${emp.name?string.number}    　// 输出20
    ${emp.name?string.currency}    // ￥20.00 
    ${emp.name?string.percent}     // 20%
    ${1.222?int} 　　　　　　　　　　 // 将小数转为int，输出1
    
    <#setting number_format="percent"/>    // 设置数字默认输出方式('percent',百分比)
    <#assign answer=42/>    　　　　　　　　 // 声明变量 answer 42
    #{answer}    　　　　　　　　 // 输出 4,200%
    ${answer?string}    　　　　 // 输出 4,200%
    ${answer?string.number} 　　// 输出 42
    ${answer?string.currency}  // 输出 ￥42.00
    ${answer?string.percent} 　// 输出 4,200%
    #{answer}    　　　　　　　　// 输出 42

数字格式化插值可采用\#\{expr;format\}形式来格式化数字,其中format可以是:  
mX:小数部分最小X位  
MX:小数部分最大X位

如下面的例子:
    <#assign x=2.582/>
    <#assign y=4/>
    #{x; M2}    // 输出2.58
    #{y; M2}    // 输出4
    #{x; m2}    // 输出2.58
    #{y; m2}    // 输出4.0
    #{x; m1M2}  // 输出2.58
    #{x; m1M2}  // 输出4.0

### 4、申明变量 ###

<#assign foo=false/> // 声明变量,插入布尔值进行显示,注意不要用引号
    ${foo?string("yes","no")} // 当为true时输出"yes",否则输出"no"

申明变量的几种方式

<#assign name=value> 
    <#assign name1=value1 name2=value2 ... nameN=valueN> 
    <#assign same as above... in namespacehash>
    
    <#assign name> 
    capture this 
    </#assign>
    
    <#assign name in namespacehash> 
    capture this 
    </#assign>

### 5、比较运算符 ###

表达式中支持的比较运算符有如下几个:  
= 或 == ：判断两个值是否相等.  
!= ：判断两个值是否不等.

> 或 gt ：判断左边值是否大于右边值  
> = 或 gte ：判断左边值是否大于等于右边值  
> < 或 lt ：判断左边值是否小于右边值  
> <= 或 lte ：判断左边值是否小于等于右边值

### 6、算术运算符 ###

FreeMarker表达式中完全支持算术运算,  
FreeMarker支持的算术运算符包括:+, - , \* , / , %  
注意：  
（1）、运算符两边必须是数字  
（2）、使用+运算符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串再连接,如:$\{3 + “5”\},结果是:35

### 7、逻辑运算符 ###

逻辑运算符有如下几个:  
逻辑与:&&  
逻辑或:||  
逻辑非:!  
逻辑运算符只能作用于布尔值,否则将产生错误

### 8、FreeMarker中的运算符优先级如下(由高到低排列): ###

①、一元运算符:!  
②、内建函数:?  
③、乘除法:\*, / , %  
④、加减法:- , +  
⑤、比较:> , < , >= , <= (lt , lte , gt , gte)  
⑥、相等:== , = , !=  
⑦、逻辑与:&&  
⑧、逻辑或:||  
⑨、数字范围:…  
实际上,我们在开发过程中应该使用括号来严格区分,这样的可读性好,出错少

--------------------

参考文档：

1.  https://blog.csdn.net/pengpengpeng85/article/details/52070602

[FreeMarker]: http://freemarker.foofun.cn/toc.html
[FreeMarker_html]: https://blog.csdn.net/chen413203144/article/details/79504686