标签:style blog http color io 使用 java ar strong
,先来一打小白兔;
用程序语言编写的程序就是模板,模板也被成为FTL(代表FreeMarker模板语言)。
模板是由如下部分混合而成的:
FTL区分大小写;
FTL标签不可以在其他FTL标签和插值中使用,下面这样写是错的;
<#if <#include ‘foo‘>=‘bar‘>...</#if>
注释可以放在FTL标签和插值中间;
标签分为两种:
指令有两种类型:预定义指令和用户自定义指令。对于用户自定义的指令使用@来代替#;
${expression}
这里是给已经了解FreeMarker的人或有经验的程序员的一个提醒:
转义
${"It‘s \"quoted\" and this is a blackslash: \\"}
输出:
It‘s "quoted" and this is a blackslash: \
转义序列表:
在1-4位的16进制码。下面这个示例中都是在字符串中放置版权符号“\xA9 1999-2001”,“\x0A9 1999-2001”,“\x00A9 1999-2001”;
一种特殊的字符串就是原生字符串。在原生字符串中,反斜杠和${没有特殊的含义,它们被视为普通的字符。为了表明字符串是原生字符串,在开始的引号或单引号之前放置字母r;
${r"${foo}"}
${r"C:\foo\bar"}
将会打印:
${foo}
C:\foo\bar
<ul>
<li>转义:${"It‘s \"quoted\" and this is a blackslash: \\"}</li>
<li>版权符号:${"\xA9 1999-2000"}</li>
<li>原生字符串:${r"${foo}"}</li>
</ul>
输出:
科学记数法暂不支持使用(1E3就是错误的)。不能在小数点之前不写0(.5也是错误的);
直接写true或false就表示一个布尔值了;
指定一个文字的序列,使用逗号来分隔其中的每个子变量,然后把整个列表放到方括号中。
<#list ["winter", "spring", "summer", "autumn"] as x>
${x}
</#list>
将会打印出:
winter
spring
summer
autumn
列表中的项目是表达式,那么也可以这样做:[2+2, [1,2,3,4], “whatnot”],其中第一个子变量是数字4,第二个子变量是一个序列,第三个子变量是字符串“whatnot”。
也可以用start..end定义存储数字范围的序列,这里start和end是处理数字值表达式,比如2..5和[2, 3, 4, 5]是相同的,但是使用前者会更有效率(内存占用少而且速度快)。可以看出前者也没有使用方括号,这样也可以用来定义递减的数字范围,比如5..2。(此外,还可以省略end,只需5..即可,到无穷大)。
/FreeMarker-hello-web/src/main/webapp/WEB-INF/ftl/3/list.ftl
<#assign season=["summer", "winter", "spring", "autumn"]>
<p>
<#list season as s>
${s},
</#list>
</p>
<p>
<#list season[2..] as x>
${x},
</#list>
</p>
输出:
summer, winter, spring, autumn,
spring, autumn,
键和值成对出现并以冒号分隔。{“name”:“green mouse”,“price”:150};
book.author.name来读取到auther的name;
如果我们想指定同一个表达式的子变量,那么还有另外一种语法格式:book[“title”]。
下面这些示例它们含义都是相等的:book.author.name, book["author"].name, book.author.["name"], book["author"]["name"]
。
当使用点式语法时,顶层变量名的命名也是相同的限制(命名时只能使用字母,数字,下划线,$,@等),而使用方括号语法形式时就没有这样的限制,它可以是任意的表达式。(为了FreeMarker支持XML,如果变量名是*(星号)或者**,那么就应该使用方括号语法格式)。
animals[0].name
特殊变量是由FreeMarker引擎本身定义的,为了使用它们,可以按照如下语法形式来进行:.variable_name;
user[0],假设user是”Big Joe“,那么
${user[0]}
${user[4]}
将会打印:
B
J
可以使用切分序列的方式来获取一定范围内的字符,比如user[1..4]和{user[4..]},然而这种使用方法已经被废弃了,作为它的替代,可以使用内建函数substring。
/FreeMarker-hello-web/src/main/webapp/WEB-INF/ftl/3/string.ftl
<ul>
<li>读取一个字符:${user[0]}</li>
<li>读取一定范围的字符:${user[1..5]}</li>
<li>这种操作已经废弃了,现在使用内建函数substring,${user?substring(1, 5)}</li>
</ul>
输出:
?读取一个字符:B
?读取一定范围的字符:ig Jo
?这种操作已经废弃了,现在使用内建函数substring,ig J
序列的连接可以使用+号来进行:
<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
\- ${user}
</#list>
要注意不要在很多重复连接时使用序列连接操作,比如在循环中往序列上追加项目,通过这种方式进行的许多重复连接最终产生的序列读取的速度会变慢;
使用[firstindex..lastindex]可以获取序列中的一部分,这里的firstindex和lastindex表达式的结果是数字,如果seq存储序列“a”,“b”,“c”,“d”,“f”,那么表达式seq[1..4]将会是含有“b”,“c”,“d”,“e”的序列。
/FreeMarker-hello-web/src/main/webapp/WEB-INF/ftl/3/list.ftl
<h3>序列的操作</h3>
<ul>
<li>+连接:
<#list ["sumer", "winter"]+["spring", "autumn"] as x>
${x}.
</#list>
</li>
<li>序列切分:
<#list season[2..3] as x>
${x},
</#list>
</li>
</ul>
可以使用+号连接哈希表
<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
求模(求余): %
测试两个值相等使用=(或者==,二者是完全等同的)
内建函数以?形式提供变量的不同形式或者其他信息。
例如得到字符串的大写形式:user?upper_case;
字符串使用的内建函数:
序列使用的内建函数:
数字使用的内建函数:
示例:
${test?html}
${test?upper_case?html}
输出是:
Tom & Jerry
TOM & JERRY
假设程序员定义了一个可供调用的方法repeat。第一个参数字符串类型,第二个参数是数值类型。
${repeat("What", 3)}
打印出:
WhatWhatWhat
要注意这个操作是FreeMarker2.3.7版本以后才有的(用来代替内建函数default,exists和if_exists);
unsafe_expr!default_expr或 unsafe_expr! 或 (unsafe_expr)!default_expr 或 (unsafe_expr)!
${mouse!"No mouse."}
<#assign mouse="Jerry">
${mouse!"No mouse."}
将会输出:
No mouse.
Jerry
默认值可以是任何类型的表达式,也可以不必是字符串。
hits!0;
colors!["red", "green", "blue"]
默认值表达式的复杂程序没有严格限制,你可以这么来写:
cargo.weight!(item.weight * itemCount+10)
如果默认值被忽略了,那么结果将会是空串,空序列或空哈希表。
(${mouse!})
<#assign mouse = "Jerry">
(${mouse!})
输出为:
()
(Jerry)
在不是顶层变量时,默认的操作符可以有两种方式:
product.color!"red"
当color不存在时(返回“red”)将会被处理,但是如果连product都不存在时将不会处理,也就是说这种写法product必须存在,否则模板就会报错。
(product.color)!"red"
这种写法,如果product不存在或者product存在而color不存在,都能显示默认值“red”而不会报错。
默认值操作也可以作用于序列,比如:
<#assign seq = [‘a‘, ‘b‘]>
${seq[0]!‘-‘}
${seq[1]!‘-‘}
${seq[2]!‘-‘}
${seq[3]!‘-‘}
输出为:
a
b
\-
\-
unsafe_expr??或者(unsafe_expr)??
<#if mouse??>
Mouse found
<#else>
No mouse found
</#if>
Creating mouse...
<#assign mouse = "Jerry">
<#if mouse??>
Mouse found
<#else>
No mouse found
</#if>
输出为:
No mouse found
Creating mouse...
Mouse found
FTL忽略表达式中的多余空格。
标签:style blog http color io 使用 java ar strong
原文地址:http://www.cnblogs.com/yejq/p/3971117.html