在模板中定义的变量有三种类型:

引用

1:plain变量:可以在模板的任何地方访问,包括使用include指令插入的模板,使用assign指令创建和替换。
2:局部变量:在宏定义体中有效,使用local指令创建和替换。
3:循环变量:只能存在于指令的嵌套内容,由指令(如list)自动创建;宏的参数是局部变量,而不是循环变量

  

局部变量隐藏(而不是覆盖)同名的plain变量;循环变量隐藏同名的局部变量和plain变量

<#assign x = "plain">
1. ${x} <br>
宏开始<br>
<@test/>
宏结束<br>
6. ${x} <br> <#list ["loop"] as x>
7. ${x} <br>
<#assign x = "plain2"> <#-- replace the plain var -->
8*. ${x} <br> <#-- it still hides the plain var. -->
</#list> 9*. ${x} <br> <#macro test>
2. ${x} <br>
<#local x = "local">
3. ${x} <br> <#list ["loop"] as x>
4. ${x} <br>
</#list>
5. ${x} <br>
</#macro>

  

模板中的变量会隐藏(而不是覆盖)数据模型中同名变量,如果需要访问数据模型中的同名变量,使用特殊变量global,下面的例子假设数据模型中的user的值是Big Joe: 
<#assign user = "Joe Hider"> 
${user}          <#-- prints: Joe Hider --> 
${.globals.user} <#-- prints: Big Joe -->

一.输出

1:判断list记录大于2

<#if (data?size>2)>
size 大于 2
<#else>
size 小于 2
</#if>  

2:插入布尔值:

<#assign foo=false />
${foo?string("yes","no")}   

3:默认值:

<#--<#assign name="liuwentao" />-->
${name?default('xxx')}

或者

<#--<#assign name="liuwentao" />-->
${name!"xxx"}   

4:if_exists :

<#assign name="liuwentao" />
${name?if_exists }

5:日期格式:

${current?string('yyyy-MM-dd HH:mm:ss E')}  

6:数字格式:

<#setting number_format="#">
${data.num}<br>
${data.num?string.number}<br>
${data.num?string.currency}<br>
${data.num?string.percent}<br>

 

 

 

二.逻辑判断

1:if .. elseif .. else :

<#assign name="刘文涛" />  

<#if !name??>
name这个变量不存在
<#elseif name="liuwentao">
name的名字等于 liuwentao
<#elseif name="刘文涛">
name的名字等于 刘文涛
<#else>
name的名字等于 ${name}
</#if>

 空值判断可以写成<#if name??>  

2:switch .. case .. default .. :

<#assign name="刘文涛" />  

<#switch name>
<#case "liuwentao">
name的名字等于 liuwentao
<#break>
<#case "刘文涛">
name的名字等于 刘文涛
<#break>
<#default>
name的名字等于 ${name}
</#switch>  

三.循环

1:list :

<#assign topics=data.list2 />  

<#list topics as topic>
${topic_index}. ${topic.title2} <br>
</#list>  

四. Macro(宏)

1:基本用法 : 
宏是和某个变量关联的模板片断,以便在模板中通过用户定义指令使用该变量

1.1:定义宏

<#macro greet>
<font size="+2">Hello Joe!</font>
</#macro>  

1.2:调用宏

<@greet></@greet>

或者

<@greet/>

调用宏时,与使用FreeMarker的其他指令类似, 只是使用@替代FTL标记中的#

2:带参数的宏 
宏的参数是局部变量,只能在宏定义中有效 
2.1:带一个参数的宏

<#macro greet person>
<font size="+2">Hello ${person}!</font>
</#macro> <@greet person="刘文涛"/>   

2.2:带多个参数的宏

<#macro greet person color>
<font size="+2" color="${color}">Hello ${person}!</font>
</#macro> <@greet person="刘文涛" color="blue"/>

2.3: 带参数缺省值的宏

<#macro greet person color="blue">
<font size="+2" color="${color}">Hello ${person}!</font>
</#macro>
<@greet person="刘文涛" color="yellow"/> <br>
<@greet person="刘文涛"/>

 

3:在宏里嵌套内容

3.1:<#nested> 指令  

<#macro table>
<table border=4 cellspacing=0 cellpadding=4>
<tr>
<td>第一次使用:<#nested></td>
</tr>
<tr>
<td>第二次使用:<#nested></td>
</tr>
</table>
</#macro> <@table>这些内容显示在哪里...</@table>

  

3.2:嵌套内容可以是有效的FTL

<#macro greet person color="blue">
<font size="+2" color="${color}">Hello ${person}!</font>
</#macro> <#macro table>
<table border=4 cellspacing=0 cellpadding=4>
<tr>
<td>第一次使用:<#nested></td>
</tr>
<tr>
<td>第二次使用:<#nested></td>
</tr>
</table>
</#macro> <@table><@greet person="刘文涛"/></@table>

  

4:循环变量

4.1:基本用法

<#macro repeat count>
<#list 1..count as x>
<#nested>
</#list>
</#macro> <@repeat count=4>
freemarker...
</@repeat>

  

4.2:nestted指令也可以有循环变量

<#macro repeat count>
<#nested 2, 3, true>
</#macro> <@repeat count=4 ; c, halfc, last>
${c}. ${halfc} <#if last> Last!</#if> <br>
</@repeat>

 

这里count是宏的参数,c, halfc,last则为循环变量

下面的写法是不对的:

<#macro repeat count>
<#nested 2, 3, true>
</#macro> <@repeat count=4 ; c, halfc, last>
${count}| ${c}. ${halfc} <#if last> Last!</#if> <br>
</@repeat>

因为:宏的参数是局部变量,而不是循环变量

再看一个复杂一点例子:

<#macro repeat count>
<#list 1..count as x>
<#nested x, x/2, x==count>
</#list>
</#macro> <@repeat count=4 ; c, halfc, last>
${c}. ${halfc} <#if last> Last!</#if> <br>
</@repeat>

循环变量和宏标记指定的不同不会有问题,如果调用时少指定了循环变量,那么多余的值不可见。调用时多指定了循环变量,多余的循环变量不会被创建:

五.命名空间 
通常情况,只使用一个名字空间,称为主名字空间,但为了创建可重用的宏、变换器或其它变量的集合(通常称库),必须使用多名字空间,其目的是防止同名冲突。

1:创建库(假设保存在lib/my_test.ftl中)

<#macro copyright date>
<p>Copyright (C) ${date} Julia Smith. All rights reserved.
<br>Email: ${mail}</p>
</#macro>
<#assign mail="liuwentao@lib.com">

2:使用import指令导入库到模板中

Freemarker会为导入的库创建新的名字空间,并可以通过import指令中指定的散列变量访问库中的变量

<#import "/lib/my_test.ftl" as my>
<#assign mail="wentao@outer.com">
<@my.copyright date="1999-2002"/>
${my.mail}
${mail}

输出结果:

<p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.
<br>Email: liuwentao@lib.com</p>
liuwentao@lib.com
wentao@outer.com

可以看到例子中使用的两个同名变量并没有冲突,因为它们位于不同的名字空间。

3:还可以使用assign指令在导入的名字空间中创建或替代变量

<#import "/lib/my_test.ftl" as my>
${my.mail}
<#assign mail="wentao@outer.com" in my>
${my.mail}

输出结果:

liuwentao@lib.com
wentao@outer.com   

4:数据模型中的变量任何地方都可见,也包括不同的名字空间 
下面是修改的库: 

<#macro copyright date>
<p>Copyright (C) ${date} ${user}. All rights reserved.</p>
</#macro>
<#assign mail = "${user}@acme.com">

假设数据模型中的user变量的值是liuwentao,则下面的代码: 

<#import "/lib/my_test.ftl" as my>  

<@my.copyright date="1999-2002"/>
${my.mail}

  输出结果: 

<p>Copyright (C) 1999-2002 liuwentao. All rights reserved.</p>liuwentao@acme.com

  

我遇到的问题

1: html 转义

<tr>
<td>姓名:</td>
<td><strong>${item.realName!?html}</strong></td>
</tr>

  

指定变量

<#assign categoryId =data.categoryId/>    

调用静态方法

<#assign category=statics["com.koolearn.eclass.product.ProductFactory"].getProductCategory(categoryId) />

  

<#assign util=statics["com.koolearn.security.base.utils.KoolearnStringUtils"] />
${util.subStrUnicode(item.content!?html,data.width!20,true)}   

1.常用的函数

fm的函数调用语法是变量名后面跟一个问号,再写上方法名,如:${test?upper_case} 
如果要调用2个以上的内置方法,则连续写,如:${test?upper_case?html}

引用
 
html : 将特殊html标记进行转换,如<转换成<
cap_first : 首字母大写
lower_case : 转换成小写
upper_case :转换成大写
trim : 剪掉前后空白
size :得到序列、数组的元素个数
int :获得小数的整数部分
substring (from, toExclusive):取子串
contains :和java同
ends_with : 以…结尾 吗
starts_with : 以…开头吗
last_index_of : 最后的索引所在位置
length : 字符串长度
matches :是否 匹配 一个正则

  

replace :  替换

${"this is a car acarus"?replace("car", "bulldozer")}----------->
this is a bulldozer abulldozerus

  

2.删除连续多个变量之间的换行符

设想这样一个应用场景,你想生成一个java方法的代码,方法的参数是多个的,你一定不希望它是一行一个参数吧,那你就需要使用<#t>标签了,它的意思是去掉当前行首尾的空白,注意,换行也当成空白,比如下面的例子:

1 <#t>
2<#t>
3<#lt>
4
5<#rt>
6

  

执行后的结果是:

1 23
4
5 6

<#t>在行里的位置无所谓,类似还有<#lt><#rt>,意思是去掉左侧和右侧的空白。

3.如何判断变量是否存在或对象的属性是否为null 
  用??进行判断,如下:

<#if user??><h1>Welcome ${user}!</h1></#if>   

存在或有值则为true

4.如何输出${xxx} 这样的字符串

jsp el的语法和fm很像,都支持${}这样来输出变量内容,当然jsp本身其实也是一种模板技术,二者本质是一样的,你如果想生成jsp el的代码就会遇到这个问题,不能直接写,否则fm会把它当成fm的东西来解析成它变量了,这时候需要使用<#noparse>标签。

<#noparse>${ccc}</#noparse>

这样fm就不会把它当成变量来解析而是直接输出 ${ccc} 了 

chunk 用法 
<table width="950" border="0" cellspacing="2" cellpadding="0" align="center" class="mb12">
<#list bBookList?chunk(5) as row>
<tr>
<#list row as item>
<td align="center">
<#if item.name??>
<#assign name=util.subString(item.name!,item.shortName!,data.width)/>
<a title='${item.name!}' href="${item.urlDetail!}" target="_blank">
<img src="${item.photoS!}" alt="${item.name!}" width="145" height="110" border="0" class="img_border2">
</a>
<table border="0" cellpadding="0" cellspacing="0">
<tr>
<td height="36" align="center">
<a title='${item.name!}' href="${item.urlDetail!}" target="_blank">
${name}
</a>
</td>
</tr>
</table>
</#if>
</td>
</#list>
</tr>
</#list>
</table>

  

原文地址:http://wentao365.iteye.com/blog/612293

 

freemarker学习笔记的更多相关文章

  1. Java模板引擎之Freemarker 学习笔记 一

    什么是Freemarker Freemarker是模板引擎,不是Web框架,只是视图层的组件,官网是 https://freemarker.apache.org/ Freemarker原理 数据模型+ ...

  2. [原创]java WEB学习笔记58:Struts2学习之路---Result 详解 type属性,通配符映射

    本博客的目的:①总结自己的学习过程,相当于学习笔记 ②将自己的经验分享给大家,相互学习,互相交流,不可商用 内容难免出现问题,欢迎指正,交流,探讨,可以留言,也可以通过以下方式联系. 本人互联网技术爱 ...

  3. jfinal框架教程-学习笔记

    jfinal框架教程-学习笔记 JFinal  是基于 Java  语言的极速  WEB  + ORM  开发框架,其核心设计目标是开发迅速.代码量少.学习简单.功能强大.轻量级.易扩展.Restfu ...

  4. Struts2学习笔记⑧

    今天是Struts2学习笔记的最后一篇文章了.用什么做结尾呢,这两天其实还学了很多东西,没有记录下,今天就查漏补缺一下. 文件上传与下载.FreeMarker以及昨天没做完的例子 文件上传与下载 文件 ...

  5. Spring实战第六章学习笔记————渲染Web视图

    Spring实战第六章学习笔记----渲染Web视图 理解视图解析 在之前所编写的控制器方法都没有直接产生浏览器所需的HTML.这些方法只是将一些数据传入到模型中然后再将模型传递给一个用来渲染的视图. ...

  6. Java架构师之路 Spring学习笔记(一) Spring介绍

    前言 这是一篇原创的Spring学习笔记.主要记录我学习Spring4.0的过程.本人有四年的Java Web开发经验,最近在面试中遇到面试官总会问一些简单但我不会的Java问题,让我觉得有必要重新审 ...

  7. springboot 学习笔记(二)

    springboot 学习笔记(二) 快速创建一个springboot工程,并引入所需要的依赖 1.利用Spring initializr 来创建一个springboot项目,登陆http://sta ...

  8. Spring框架学习笔记(3)——SpringMVC框架

    SpringMVC框架是基于Spring框架,可以让我们更为方便的进行Web的开发,实现前后端分离 思路和原理 我们之前仿照SpringMVC定义了一个自定义MVC框架,两者的思路其实都是一样的. 建 ...

  9. springboot学习笔记:9.springboot+mybatis+通用mapper+多数据源

    本文承接上一篇文章:springboot学习笔记:8. springboot+druid+mysql+mybatis+通用mapper+pagehelper+mybatis-generator+fre ...

随机推荐

  1. P3357 最长k可重线段集问题 网络流

    P3357 最长k可重线段集问题 题目描述 给定平面 x-O-yx−O−y 上 nn 个开线段组成的集合 II,和一个正整数 kk .试设计一个算法,从开线段集合 II 中选取出开线段集合 S\sub ...

  2. BZOJ4283: 魔法少女伊莉雅(最短路径图+最短路径树)

    题面 传送门 题解 太长了不想写了→_→ 题解 //minamoto #include<bits/stdc++.h> #define R register #define inf 0x3f ...

  3. MySql环境变量配置

    配置环境变量 前面步骤完成后安装好MySQL,为MySQL配置环境变量.MySQL默认安装在C:\Program Files下. 1)新建MYSQL_HOME变量,并配置:C:\Program Fil ...

  4. centos7安装配置sql server 2017 linux教程

    一.安装教程 https://docs.microsoft.com/zh-cn/sql/linux/quickstart-install-connect-docker https://docs.mic ...

  5. github常用项目汇总

    1.smartTable(智能表格) android自动生成表格框架 使用方法:在github中搜索smartTable 进入项目后,查看开源项目的介绍和使用方法即可.

  6. 通过源码看原理之 selenium

    # selenium的历史1. selenium1.x:这个时候的selenium,使用的是JavaScript注入技术与浏览器打交道,需要Selenium RC启动一个Server,将操作Web元素 ...

  7. 2018徐州网络赛 - Trace

    题意:n个左下角为原点右上角在第一象限的矩形不断覆盖,求最后形成的图形的周长 x和y是独立的,分别维护两棵线段树,一棵表示x坐标下最大的y值,另一棵表示y坐标下最大的x值 从覆盖的角度来考虑,如果逆序 ...

  8. 在微信移动端input file拍照或从相册选择照片后会自动刷新页面退回到一开始网站进入的页面

    <input type="file" accept="image/*"/> 调用打开摄像头后,聚焦后拍照,点击确认,这时页面会出现刷新动作,然后回退 ...

  9. centos 6.6 设备 xxx 似乎不存在, 初始化操作将被延迟

    2019-04-02 问题描述: centos 6.6开启虚拟机之后,网卡服务不能正常启动,报错信息为:设备 xxx(网卡名称)似乎不存在, 初始化操作将被延迟 解决办法: 清空70-persiste ...

  10. 剑指offer——面试题30:包含min函数的栈

    #include"iostream" #include"stdio.h" using namespace std; ; ; template<typena ...