FreeMarker模板引擎

FreeMarker 是一款模板引擎：即一种基于模板和要改变的数据，并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件

freemarker模板文件通常都是以ftl作为扩展名，也可以为html、xml、jsp等

在resources下创建templates，此目录为freemarker的默认缓存目录

在templates下创建模板文件 01-basic.ftl，模板中的插值表达式最终会被freemarker替换成具体的数据

freemarker作为springmvc一种视图格式，默认情况下SpringMVC支持freemarker视图格式

基础语法种类

1、注释，即<#-- -->，介于其之间的内容会被freemarker忽略

<#--我是一个freemarker注释-->

2、插值（Interpolation）：即 ${..} 部分,freemarker会用真实的值代替$ {..}

Hello ${name}

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

<# >FTL指令</#>

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

<#--freemarker中的普通文本-->

我是一个普通的文本

集合指令

list <#list></list>

@GetMapping("/list")

public String list(Model model){

//------------------------------------

Student stu1 = new Student();

stu1.setName("小强");

stu1.setAge(18);

stu1.setMoney(1000.86f);

stu1.setBirthday(new Date());

//小红对象模型数据

Student stu2 = new Student();

stu2.setName("小红");

stu2.setMoney(200.1f);

stu2.setAge(19);

//将两个对象模型数据存放到List集合中

List<Student> stus = new ArrayList<>();

stus.add(stu1);

stus.add(stu2);

//向model中存放List集合数据

model.addAttribute("stus",stus);

<#list stus as stu>

<tr>

<td>${stu_index+1}</td> //通过stu_index获取id,从0开始

<td>${stu.money}</td>

</tr>

</#list>

map集合

//创建Map数据

HashMap<String,Student> stuMap = new HashMap<>();

stuMap.put("stu1",stu1);

stuMap.put("stu2",stu2);

// 3.1 向model中存放Map数据

model.addAttribute("stuMap", stuMap);

取值

输出stu1的学生信息：<br/>

姓名：${stuMap['stu1'].name}<br/>

年龄：${stuMap['stu1'].age}<br/>

遍历

<#list stuMap?keys as key>

<td>${key_index+1}</td>

<td>${stuMap[key].name}</td>

<td>${stuMap[key].age}</td>

<td>${stuMap[key].money}</td>

</#list>

if 指令即判断指令，是常用的FTL指令，freemarker在解析时遇到if会进行判断，条件为真则输出if中间的内容，否则跳过内容不再输出。

指令格式

<#if ></if>

<#list stus as stu>

<#if stu.name='小红'>

<td>${stu_index+1}</td>

<td>${stu.money}</td>

</tr>

</#if>

</#list>

在freemarker中，判断是否相等，=与==是一样的

=和！=两边必须是相同类型的值

使用gt代替>

判断某变量是否存在 "??" 用法:variable??,如果该变量存在，返回true，否则返回false

<#if stu??>

缺失变量默认使用"!"

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

1、和到某个集合的大小

${集合名?size}

2、日期格式化

显示年月日: ${today?date}

显示时分秒：${today?time}

显示日期+时间：${today?datetime}

自定义格式化： ${today?string("yyyy年MM月")}

3、内建函数c

model.addAttribute("point", 102920122);

point是数字型，使用${point}会显示这个数字的值，每三位使用逗号分隔。

如果不想显示为每三位分隔的数字，可以使用c函数将数字型转成字符串输出

${point?c}

4、将json字符串转成对象

用到了 assign标签，assign的作用是定义一个变量。

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

<#assign data=text?eval />

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