本文共 8017 字，大约阅读时间需要 26 分钟。
首先，先建议查看此文档
FTL指令常用标签及语法 注意：使用freemaker，要求所有标签必须闭合，否则会导致freemaker无法解析。
freemaker注释:<#-- 注释内容 -->格式部分,不会输出
?? 判断左侧的变量是否丢失，相当于java中的null的判断，或者这个变量是否未定义。
?has_content 非常像??，但是它同时也会对空字符串或空list或空map进行判断。
! 用来给变量一个默认值，例如color!”no color”
?if_exists 是??的老写法，现在不推荐使用。
---------------------------------- 基础语法 ----------------------------------
FTL指令常用标签及语法注意：使用freemaker，要求所有标签必须闭合，否则会导致freemaker无法解析。freemaker注释:<#-- 注释内容 -->格式部分,不会输出---------------------------------- 基础语法 ----------------------------------1、字符输出${emp.name?if_exists} // 变量存在，输出该变量，否则不输出${emp.name!} // 变量存在，输出该变量，否则不输出${emp.name?default("xxx")} // 变量不存在，取默认值xxx ${emp.name!"xxx"} // 变量不存在，取默认值xxx常用内部函数：${"123456"?html} // 对字符串进行HTML编码，对html中特殊字符进行转义${"str"?cap_first} // 使字符串第一个字母大写 ${"Str"?lower_case} // 将字符串转换成小写 ${"Str"?upper_case} // 将字符串转换成大写${"str"?trim} // 去掉字符串前后的空白字符字符串的两种拼接方式拼接：${"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.04、申明变量<#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 name in namespacehash> capture this 5、比较运算符表达式中支持的比较运算符有如下几个:= 或 == ：判断两个值是否相等.!= ：判断两个值是否不等.> 或 gt ：判断左边值是否大于右边值>= 或 gte ：判断左边值是否大于等于右边值< 或 lt ：判断左边值是否小于右边值<= 或 lte ：判断左边值是否小于等于右边值6、算术运算符FreeMarker表达式中完全支持算术运算,FreeMarker支持的算术运算符包括:+, - , * , / , % 注意：（1）、运算符两边必须是数字（2）、使用+运算符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串再连接,如:${3 + "5"},结果是:357、逻辑运算符逻辑运算符有如下几个:逻辑与:&&逻辑或:||逻辑非:!逻辑运算符只能作用于布尔值,否则将产生错误8、FreeMarker中的运算符优先级如下(由高到低排列):①、一元运算符:!②、内建函数:?③、乘除法:*, / , %④、加减法:- , +⑤、比较:> , < , >= , <= (lt , lte , gt , gte)⑥、相等:== , = , !=⑦、逻辑与:&&⑧、逻辑或:||⑨、数字范围:..实际上,我们在开发过程中应该使用括号来严格区分,这样的可读性好,出错少9、if 逻辑判断（注意：elseif 不加空格）<#if condition>...<#elseif condition2>...<#elseif condition3>...<#else>... if 空值判断// 当 photoList 不为空时<#if photoList??>... 值得注意的是,${..}只能用于文本部分,不能用于表达式,下面的代码是错误的:<#if ${isBig}>Wow! <#if "${isBig}">Wow! // 正确写法<#if isBig>Wow! 10、switch (条件可为数字，可为字符串)<#switch value> <#case refValue1> ....<#break> <#case refValue2> ....<#break> <#case refValueN> ....<#break> <#default> .... 11、集合 & 循环// 遍历集合:<#list empList! as emp> ${emp.name!} // 可以这样遍历集合:<#list 0..(empList!?size-1) as i> ${empList[i].name!} // 与jstl循环类似,也可以访问循环的状态。empList?size // 取集合的长度emp_index: // int类型，当前对象的索引值 emp_has_next: // boolean类型，是否存在下一个对象// 使用<#break>跳出循环<#if emp_index = 0><#break> // 集合长度判断 <#if empList?size != 0> // 判断=的时候,注意只要一个=符号,而不是==<#assign l=0..100/> // 定义一个int区间的0~100的集合，数字范围也支持反递增,如100..2<#list 0..100 as i> // 等效于java for(int i=0; i <= 100; i++) ${i} // 截取子集合：empList[3..5] //返回empList集合的子集合,子集合中的元素是empList集合中的第4-6个元素// 创建集合：<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x>// 集合连接运算,将两个集合连接成一个新的集合<#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as x>// 除此之外,集合元素也可以是表达式,例子如下:[2 + 2, [1, 2, 3, 4], "whatnot"]/ seq_contains：判断序列中的元素是否存在<#assign x = ["red", 16, "blue", "cyan"]> ${x?seq_contains("blue")?string("yes", "no")} // yes${x?seq_contains("yellow")?string("yes", "no")} // no${x?seq_contains(16)?string("yes", "no")} // yes${x?seq_contains("16")?string("yes", "no")} // no// seq_index_of：第一次出现的索引<#assign x = ["red", 16, "blue", "cyan", "blue"]> ${x?seq_index_of("blue")} // 2// sort_by：排序（升序）<#list movies?sort_by("showtime") as movie> // sort_by：排序（降序）<#list movies?sort_by("showtime")?reverse as movie> // 具体介绍：// 不排序的情况：<#list movies as moive> ${moive.name} //要是排序，则用<#list movies?sort as movie> ${movie.name} // 这是按元素的首字母排序。若要按list中对象元素的某一属性排序的话，则用<#list moives?sort_by(["name"]) as movie> ${movie.name} //这个是按list中对象元素的[name]属性排序的，是升序，如果需要降序的话，如下所示：<#list movies?sort_by(["name"])?reverse as movie> ${movie.name} 12、Map对象// 创建map<#assign scores = {"语文":86,"数学":78}>// Map连接运算符<#assign scores = {"语文":86,"数学":78} + {"数学":87,"Java":93}>// Map元素输出emp.name // 全部使用点语法emp["name"] // 使用方括号13、FreeMarker支持如下转义字符:\" ：双引号(u0022)\' ：单引号(u0027)\\ ：反斜杠(u005C)\n ：换行(u000A)\r ：回车(u000D)\t ：Tab(u0009)\b ：退格键(u0008)\f ：Form feed(u000C)\l ：<\g ：>\a ：&\{ ：{\xCode ：直接通过4位的16进制数来指定Unicode码,输出该unicode码对应的字符.如果某段文本中包含大量的特殊符号,FreeMarker提供了另一种特殊格式:可以在指定字符串内容的引号前增加r标记,在r标记后的文件将会直接输出.看如下代码:${r"${foo}"} // 输出 ${foo}${r"C:/foo/bar"} // 输出 C:/foo/bar14、include指令// include指令的作用类似于JSP的包含指令:<#include "/test.ftl" encoding="UTF-8" parse=true>// 在上面的语法格式中,两个参数的解释如下:encoding="GBK" // 编码格式parse=true // 是否作为ftl语法解析,默认是true，false就是以文本方式引入,注意:在ftl文件里布尔值都是直接赋值的如parse=true,而不是parse="true"15、import指令// 类似于jsp里的import,它导入文件，然后就可以在当前文件里使用被导入文件里的宏组件<#import "/libs/mylib.ftl" as my>// 上面的代码将导入/lib/common.ftl模板文件中的所有变量,交将这些变量放置在一个名为com的Map对象中，"my"在freemarker里被称作namespace16、compress 压缩// 用来压缩空白空间和空白的行 <#compress> ... <#t> // 去掉左右空白和回车换行 <#lt>// 去掉左边空白和回车换行 <#rt>// 去掉右边空白和回车换行 <#nt>// 取消上面的效果17、escape,noescape 对字符串进行HTML编码// escape指令导致body区的插值都会被自动加上escape表达式,但不会影响字符串内的插值,只会影响到body内出现的插值,使用escape指令的语法格式如下:<#escape x as x?html> First name: ${firstName} <#noescape>Last name: ${lastName} Maiden name: ${maidenName} // 相同表达式First name: ${firstName?html} Last name: ${lastName} Maiden name: ${maidenName?html}---------------------------------- 高级语法 ----------------------------------1、global全局赋值语法<#global name=value> <#global name1=value1 name2=value2 ... nameN=valueN> <#global name> capture this // 利用这个语法给变量赋值，那么这个变量在所有的namespace中是可见的，如果这个变量被当前的assign语法覆盖如<#global x=2><#assign x=1>在当前页面里x=2将被隐藏，或者通过${.globals.x} 来访问2、setting 语法// 用来设置整个系统的一个环境 locale // zh_CN 中文环境number_format boolean_format date_format , time_format , datetime_format time_zone classic_compatible// 例1：<#setting number_format="percent"/> // 设置数字默认输出方式('percent',百分比)// 例2：// 假如当前是匈牙利的设置，然后修改成美国${1.2} // 输出1,2<#setting locale="en_US"> ${1.2} // 输出1.2,因为匈牙利是采用", "作为十进制的分隔符，美国是用". "3、macro宏指令例子1：<#-- 定义宏 --><#macro test foo bar="Bar" baaz=-1> Text: ${foo}, ${bar}, ${baaz} <#-- 使用宏 --><@test foo="a" bar="b" baaz=5*5/> // 输出：Text: a, b, 25<@test foo="a" bar="b"/> // 输出：Text: a, b, -1<@test foo="a" baaz=5*5-2/> // 输出：Text: a, Bar, 23<@test foo="a"/> // 输出：Text: a, Bar, -1例子2：<#-- 定义一个循环输出的宏 --><#macro list title items> ${title} <#list items as x> *${x} <#-- 使用宏 --><@list items=["mouse", "elephant", "python"] title="Animals"/>// 输出Animals *mouse *elephant *python例子3：<#-- 嵌套宏 --><#macro border> | hahaha |
转载地址：http://mwgti.baihongyu.com/