freemarker ftl java_FreeMarker学习1(Ftl)

一个ftl标记不能放在另外一个ftl标记里面，但是注释标记能够放在ftl标记里面。

系统预定义指令采用#>

用户自定义指令采用@>

hash片段可以采用： products[10..19] or products[5..] 的格式。

序列也可以做加法计算：passwords + {"joe":"secret42"}

缺省值: name!"unknown" 或者 (user.name)!"unknown" 或者 name! 或者 (user.name)!

null值检查: name?? or (user.name)??

转义列表：

Escape sequence

Meaning

\"

Quotation mark (u0022)

\'

Apostrophe (a.k.a. apostrophe-quote) (u0027)

\\

Back slash (u005C)

\n

Line feed (u000A)

\r

Carriage return (u000D)

\t

Horizontal tabulation (a.k.a. tab) (u0009)

\b

Backspace (u0008)

\f

Form feed (u000C)

\l

Less-than sign: <

\g

Greater-than sign: >

\a

Ampersand: &

\{

Curly bracket: {

\xCode

Character given with its hexadecimal Unicode code (UCS code)

如果想打印${，则需要将{转义，可以写成"$\{user}"，或者可以用生字符(r指令)：$(r "${xx}"}

序列构成：${x}#list>

不同的对象可以存放在一个序列里面，比如：[2 + 2, [1, 2, 3, 4], "whatnot"]. 第一个是数字，第二个是序列，第三个是字符串。

可用采用start..end的方式来定义一个数字序列，start可以小于end，同时，end也可以省略。

hash取值支持一下四种模式：book.author.name, book["author"].name, book.author.["name"], book["author"]["name"].

特殊变量是指freemaker引擎本身定义的变量。访问时，以.variable_name的语法访问。

变量表达式支持嵌套模式，比如：${"Hello ${user}!"}。

变量表达式在指令中的使用情况：

变量表达式可以在指令中，用“”的方式存在，不如：.

但是不允许下面的方式存在： Wow!#if>, 正确写法是：Wow!#if>.

而且 Wow!#if>写法也不正确，因为"${isBig}"返回的是字符串，不是boolean类型。

字符串中取字符或字符串采用以下语法：${user[0]},${user[0..2]} ${user[4..]},${user?string(4)}

序列操作：

加法： 但要注意串联之后的读取速度变慢。

子序列：seq[1..4]

序列和hash的串联都只能用于两个相加，不能有多个相加的模式，hash相加，如果两个相加的hash存在相同的key，则后面会覆盖前面的。

在使用>=或者>时，需要注意一些问题，因为freemaker会将>解释成标记的关闭符，为了解决这个问题，需要在表达式加上括号，比如： y)>. 或者使用 > and &lt符号来代替。

无值变量(包括无该变量，null，返回void，无属性等)：unsafe_expr!default_expr or unsafe_expr! or (unsafe_expr)!default_expr or (unsafe_expr)!缺省值可以是任何类型，不一定是数字，比如：hits!0 或者 colors!["red", "green", "blue"].

如果缺省值忽略，那么将会默认为空串、空序列或者空hash，因为freemarker支持多类型的值。不过要让默认值为0或false，则不能省略缺省值。

非顶层变量的无值处理：

product.color!"red"：只处理product不为空，color为空的缺省值处理，如果product为空，则freemaker会抛出异常。(product.color)!"red"：则会处理product为空，color为空，或者没有color属性的无值情况。

无值变量的判断操作：unsafe_expr?? or (unsafe_expr)??

判断变量是否是无值。

普通变量插入方式: ${expression},${3+5);数字变量插入方式: #{expression} or #{expression; format}：过期。

变量只能用于文本区或者是字符串里面，比如：

Hello ${name}!

以及

数字值的插入：根据缺省的number_format输出，以及可以通过setting来达到设置数字格式的目的，也可以通过内置函数string来改变输出格式。

日期类型的格式设置：date_format,time_format和datetime_format定义宏：

不带参数：...#macro>，引用   带参数：...#macro>，引用，带有参数的宏，调用是参数的值必须和参数的个数相同。当然也可以在宏定义时给参数一些默认值。比如：

宏里面的嵌套内容：

#macro>

在宏的定义body中加入指令。嵌套的内容可以是任何正确的ftl块。

宏的本地变量在嵌套内容中是不可见的。

宏定义时，指令相当于调用定义的内容，而使用宏时，nest body相当于定义。

#list>

#macro>

${c}. ${halfc} Last!#if>

@repeat>

定义变量：

在模板中定义的变量将会隐藏(不是更改)数据模型根下面的同名的变量。

模板中的3种类型变量：

1：plain variables，能够在模板中的任何地方访问，一个模板include另外一个模板，也可以访问被包含模板的变量。可以通过assign或者macro指令产生或替换变量。

如果要访问数据模型中的变量，则可以通过.global来访问：   

${user}         

${.globals.user}

2：Local variables，宏定义body中用local指令创建或者替换。

3：Loop variables:由list指令产生。namespaces:

${my.mail}

设置命名空间里面的变量：

命名空间与数据模型：命名空间的ftl可以访问数据模型的变量。同样命名空间的变量也会隐藏数据模型中同名的变量。

空白问题：

1：White-space stripping，默认为enabled，清除ftl标记带来的空白以及缩进。处理模板的空白。

2：t, rt, lt指令。3：ftl的参数strip_text.

用compress directive或者transform来处理输出。

...#compress>：消除空白行。

.../@compress将输出压缩为一行。

可替换语法：

freemarker可用"["代替"