FreeMarker设计指南(4)

操作符优先顺序<?xml:namespace prefix = o />

操作符组	操作符
后缀	[subvarName] [subStringRange] . (methodParams)
一元	+expr、-expr、!
内建	?
乘法	*、 / 、%
加法	+、-
关系	<、>、<=、>=（lt、lte、gt、gte）
相等	==（=）、!=
逻辑and	&&
逻辑or	\|\|
数字范围	..

操作符组

操作符

后缀

[subvarName] [subStringRange] . (methodParams)

一元

+expr、-expr、!

内建

乘法

*、 / 、%

加法

+、-

关系

<、>、<=、>=（lt、lte、gt、gte）

相等

==（=）、!=

逻辑and

逻辑or

数字范围

（4）Interpolation

l Interpolation有两种类型：

Ø 通用Interpolation：${expr}

Ø 数字Interpolation：#{expr}或#{expr; format}

l 注意：Interpolation只能用于文本部分

l 通用Interpolation

Ø 插入字符串值：直接输出表达式结果

Ø 插入数字值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

输出结果是：

Ø 插入日期值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个使用格式模式的例子：

输出的结果类似下面的格式：

Ø 插入布尔值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

输出结果是：

l 数字Interpolation的#{expr; format}形式可以用来格式化数字，format可以是：

Ø mX：小数部分最小X位

Ø MX：小数部分最大X位

Ø 例子：

4、杂项

（1）用户定义指令

l 宏和变换器变量是两种不同类型的用户定义指令，它们之间的区别是宏是在模板中使用macro指令定义，而变换器是在模板外由程序定义，这里只介绍宏

l 基本用法

Ø 宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子：

Ø 作为用户定义指令使用宏变量时，使用@替代FTL标记中的#

Ø 如果没有体内容，也可以使用：

l 参数

Ø 在macro指令中可以在宏变量之后定义参数，如：

Ø 可以这样使用这个宏变量：

输出结果是：

Ø 宏的参数是FTL表达式，所以下面的代码具有不同的意思：

Ø 这意味着将Fred变量的值传给person参数，该值不仅是字符串，还可以是其它类型，甚至是复杂的表达式

Ø 宏可以有多参数，下面是一个例子：

Ø 可以这样使用该宏变量：

Ø 其中参数的次序是无关的，因此下面是等价的：

Ø 只能使用在macro指令中定义的参数，并且对所有参数赋值，所以下面的代码是错误的：

Ø 可以在定义参数时指定缺省值，如：

Ø 这样<@greet person="Fred"/>就正确了

Ø 宏的参数是局部变量，只能在宏定义中有效

l 嵌套内容

Ø 用户定义指令可以有嵌套内容，使用<#nested>指令执行指令开始和结束标记之间的模板片断

Ø 例子：

这样使用该宏变量：

输出结果：

Ø <#nested>指令可以被多次调用，例如：

输出结果：

Ø 嵌套内容可以是有效的FTL，下面是一个有些复杂的例子：

输出结果：

Ø 宏定义中的局部变量对嵌套内容是不可见的，例如：

输出结果：

l 在宏定义中使用循环变量

Ø 用户定义指令可以有循环变量，通常用于重复嵌套内容，基本用法是：作为nested指令的参数传递循环变量的实际值，而在调用用户定义指令时，在<@…>开始标记的参数后面指定循环变量的名字

Ø 例子：

输出结果：

Ø 指定的循环变量的数目和用户定义指令开始标记指定的不同不会有问题

n 调用时少指定循环变量，则多指定的值不可见

n 调用时多指定循环变量，多余的循环变量不会被创建

阅读(608) | 评论(0) | 转发(0) |

上一篇：FreeMarker设计指南(3)

下一篇：FreeMarker设计指南(5)

秒客网

FreeMarker设计指南(4)

相关文章