freemarkerftl模板语法和指令

编程

freemarker模板上主要由一下4个部分组成:

1、注释,即<#‐‐和‐‐>,介于其之间的内容会被freemarker忽略;

2、插值(Interpolation):即${..}部分,freemarker会用真实的值代替${..};

3、FTL指令:和HTML标记类似,名字前加#予以区分,Freemarker会解析标签中的表达式或逻辑;

4、文本,仅文本信息,这些不是freemarker的注释、插值、FTL指令的内容会被freemarker忽略解析,直接输出内容。

FTL指令

1. assign指令

此指令用于在页面上定义一个变量

(1)定义简单类型:

<#assign linkman="周先生">联系人:${linkman}

(2)定义对象类型:

<#assign info={"mobile":"13301231212","address":"北京市昌平区王府街"} >电话:${info.mobile}  地址:${info.address}

2. include指令

此指令用于模板文件的嵌套

创建模板文件head.ftl

<h1>郭豪信息网</h1>

我们修改test.ftl,在模板文件中使用include指令引入刚才我们建立的模板

```

<#include "head.ftl">

```

3. if指令

在模板文件上添加

<#if success=true>

你已通过实名认证

<#else>

你未通过实名认证

</#if>

在代码中对str变量赋值

map.put("success", true);

在freemarker的判断中,可以使用= 也可以使用==

4. list指令

需求,实现商品价格表,如下图:

(1)代码中对变量goodsList赋值

List goodsList=new ArrayList();

Map goods1=new HashMap();

goods1.put("name", "苹果");

goods1.put("price", 5.8);

Map goods2=new HashMap();

goods2.put("name", "香蕉");

goods2.put("price", 2.5);

Map goods3=new HashMap();

goods3.put("name", "橘子");

goods3.put("price", 3.2);

goodsList.add(goods1);

goodsList.add(goods2);

goodsList.add(goods3);

map.put("goodsList", goodsList);

(2)在模板文件上添加

----商品价格表----<br>

<#list goodsList as goods>

${goods_index+1} 商品名称: ${goods.name} 价格:${goods.price}<br>

</#list>

如果想在循环中得到索引,使用循环变量+_index就可以得到。

5. 内建函数

内建函数语法格式: 变量+?+函数名称

5.1 获取集合大小

我们使用size函数来实现,代码如下:

共  ${goodsList?size}  条记录

5.2 转换JSON字符串为对象

我们通常需要将json字符串转换为对象,那如何处理呢?看代码

<#assign text="{"bank":"工商银行","account":"10101920201920212"}" />

<#assign data=text?eval />

开户行:${data.bank} 账号:${data.account}

5.3 日期格式化

代码中对变量赋值:

dataModel.put("today", new Date());

在模板文件中加入

当前日期:${today?date} <br>

当前时间:${today?time} <br>

当前日期+时间:${today?datetime} <br>

日期格式化: ${today?string("yyyy年MM月")}

运行效果如下:

5.4 数字转换为字符串

代码中对变量赋值:

map.put("point", 102920122);

修改模板:

累计积分:${point}

页面显示:

我们会发现数字会以每三位一个分隔符显示,有些时候我们不需要这个分隔符,就需要将数字转换为字符串,使用内建函数c

累计积分:${point?c}

页面显示效果如下:

6. 空值处理运算符

如果你在模板中使用了变量但是在代码中没有对变量赋值,那么运行生成时会抛出异常。但是有些时候,有的变量确实是null,怎么解决这个问题呢?

6.1 判断某变量是否存在:“??”

用法为:variable??,如果该变量存在,返回true,否则返回false 

<#if aaa??>

aaa变量存在

<#else>

aaa变量不存在

</#if>

6.2缺失变量默认值:“!”

我们除了可以判断是否为空值,也可以使用!对null值做转换处理

在模板文件中加入

  ${aaa!"-"}

在代码中不对aaa赋值,也不会报错了,当aaa为null则返回!后边的内容-

7. 运算符

7.1 算数运算符

FreeMarker表达式中完全支持算术运算,FreeMarker支持的算术运算符包括:+, - , * , / , %

7.2 逻辑运算符

逻辑运算符有如下几个: 

逻辑与:&&

逻辑或:|| 

逻辑非:! 

逻辑运算符只能作用于布尔值,否则将产生错误 

7.3 比较运算符

表达式中支持的比较运算符有如下几个: 

1 =或者==:判断两个值是否相等.

2 !=:判断两个值是否不等.

3 >或者gt:判断左边值是否大于右边值

4 >=或者gte:判断左边值是否大于等于右边值

5 <或者lt:判断左边值是否小于右边值

6 <=或者lte:判断左边值是否小于等于右边值

注意: =和!=可以用于字符串,数值和日期来比较是否相等,但=和!=两边必须是相同类型的值,否则会产生错误,而且FreeMarker是精确比较,"x","x ","X"是不等的.其它的运行符可以作用于数字和日期,但不能作用于字符串,大部分的时候,使用gt等字母运算符代替>会有更好的效果,因为FreeMarker会把>解释成FTL标签的结束字符,当然,也可以使用括号来避免这种情况,如:

<#if (x>y)> 

以上是 freemarkerftl模板语法和指令 的全部内容, 来源链接: utcz.com/z/511096.html

回到顶部