Freemarker快速入门_freemark <#assign formatdate = statics['com.exampl-优快云博客

本文链接：https://blog.youkuaiyun.com/kimdaydayup/article/details/143251766

Freemarker概述

Freemarker是一个模板引擎技术

技术选型对比

技术	说明
Jsp	Jsp为 Servlet 专用，不能单独进行使用
Velocity	Velocity从2010年更新完 2.0 版本后，7年没有更新。Spring Boot 官方在 1.4 版本后对此也不在支持
thmeleaf	新技术，功能较为强大，但是执行的效率比较低
freemarker	性能好，强大的模板语言、轻量

环境搭建

测试工程搭建

创建一个 freemarker-demo 的测试工程专门用于freemarker的功能测试与模板的测试。

<dependencies>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
  </dependency>
  <!-- lombok -->
  <dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
  </dependency>
  <!-- apache 对 java io 的封装工具库 -->
  <dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-io</artifactId>
    <version>1.3.2</version>
  </dependency>
</dependencies>

server:
  port: 8881 #服务端口
spring:
  application:
    name: test-freemarker #指定服务名
  freemarker:
    cache: false  #关闭模板缓存，方便测试
    settings:
      template_update_delay: 0 #检查模板更新延迟时间，设置为0表示立即检查，如果时间大于0会有缓存不方便进行模板测试
    suffix: .ftl               #指定Freemarker模板文件的后缀名

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

快速入门

在resources下创建templates，此目录为freemarker的默认模板存放目录。

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

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

Freemarker指令语法

基础语法种类

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

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

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

Hello ${name}

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

<# >FTL指令</#>

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

<#--freemarker中的普通文本-->
  我是一个普通的文本

FTL指令

集合指令-List

指令格式

<#list></#list>

<#list stus as stu>
  <tr>
    <td>${stu_index+1}</td>
    <td>${stu.name}</td>
    <td>${stu.age}</td>
    <td>${stu.money}</td>
  </tr>
</#list>

${k_index}：得到循环的下标，使用方法是在stu后边加"_index"，它的值是从0开始

集合指令-Map
if指令

<#if expression>
<#else>
</#if>

<#--在list集合中判断学生为小红的数据字体显示为红色。-->
<#if stu.name='小红'>
    <tr style="color: red">
        <td>${stu_index}</td>
        <td>${stu.name}</td>
        <td>${stu.age}</td>
        <td>${stu.money}</td>
    </tr>
<#else >
    <tr>
        <td>${stu_index}</td>
        <td>${stu.name}</td>
        <td>${stu.age}</td>
        <td>${stu.money}</td>
    </tr>
</#if>

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

运算符

运算符-数学运算

FreeMarker表达式中完全支持算术运算,FreeMarker支持的算术运算符包括:

①加法： +
②减法： -
③乘法： *
④除法： /
⑤求模 (求余)： %

100+5 运算：  ${100 + 5 }<br/>
100 - 5 * 5运算：${100 - 5 * 5}<br/>
5 / 2运算：${5 / 2}<br/>
12 % 10运算：${12 % 10}<br/>

运算符-比较运算符

比较运算符	说明
=或者==	判断两个值是否相等
!=	判断两个值是否不等
>或者gt	判断左边值是否大于右边值
>=或者gte	判断左边值是否大于等于右边值
<或者lt	判断左边值是否小于右边值
<=或者lte	判断左边值是否小于等于右边值

=和!=可以用于字符串、数值和日期来比较是否相等
=和!=两边必须是相同类型的值,否则会产生错误
字符串 “x” 、"x " 、"X"比较是不等的.因为FreeMarker是精确比较
gt代替>,FreeMarker会把>解释成FTL标签的结束字符,可使用括号避免这种情况,如:<#if (x>y)>

运算符-逻辑运算符
1. 逻辑与：&&
2. 逻辑或：||
3. 逻辑非：!

<#if (10 lt 12 )&&( 10  gt  5 )  >
    (10 lt 12 )&&( 10  gt  5 )  显示为 true
</#if>
<br/>
<br/>
<#if !false>
    false 取反为true
</#if>

空值处理

判断某变量是否存在使用 “??”

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

<#--为防止stus为空报错可以加上判断如下。-->
<#if stus??>
    <#list stus as stu>
        ......
    </#list>
</#if>

缺失变量默认值使用 “!”

使用!要以指定一个默认值，当变量为空时显示默认值

例：${name!‘’}表示如果name为空显示空字符串。

如果是嵌套对象则建议使用（）括起来

例：${(stu.name)!‘’}表示，如果stu或name为空默认显示空字符串。

内建函数

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

集合的大小

${集合名?size}

日期格式化

显示年月日: ${today?date}
显示时分秒：${today?time}
显示日期+时间：${today?datetime}
自定义格式化：${today?string("yyyy年MM月")}

内建函数C

model.addAttribute("point", 102920122);

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

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

${point?c}

将json字符串转成对象

<#--assign的作用是定义一个变量。-->
<#assign text="{'bank':'工商银行','account':'10101920201920212'}" />
<#assign data=text?eval />
开户行：${data.bank}  账号：${data.account}