FreeMarker设计指南(4)

最新推荐文章于 2016-08-31 11:30:15 发布

我行我速

最新推荐文章于 2016-08-31 11:30:15 发布

阅读量273

点赞数

分类专栏： Java

本文链接：https://blog.csdn.net/king201210/article/details/10445245

版权

Java 专栏收录该内容

54 篇文章 0 订阅

订阅专栏

操作符优先顺序

操作符组	操作符
后缀	[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 number_format="currency"/>

<#assign answer=42/>

${answer}

${answer?string}  <#-- the same as ${answer} -->

${answer?string.number}

${answer?string.currency}

${answer?string.percent}

输出结果是：

$42.00

$42.00

$42.00

4,200%

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

${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}

${lastUpdated?string("EEE, MMM d, ''yy")}

${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")}

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

2003-04-08 21:24:44 Pacific Daylight Time

Tue, Apr 8, '03

Tuesday, April 08, 2003, 09:24:44 PM (PDT)

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

<#assign foo=true/>

${foo?string("yes", "no")}

输出结果是：

yes

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

Ø mX：小数部分最小X位

Ø MX：小数部分最大X位

Ø 例子：

           <#-- If the language is US English the output is: -->

<#assign x=2.582/>

<#assign y=4/>

#{x; M2}   <#-- 2.58 -->

#{y; M2}   <#-- 4    -->

#{x; m1}   <#-- 2.6 -->

#{y; m1}   <#-- 4.0 -->

#{x; m1M2} <#-- 2.58 -->

#{y; m1M2} <#-- 4.0  -->

4、杂项

（1）用户定义指令

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

l 基本用法

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

<#macro greet>

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

</#macro>

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

<@greet></@greet>

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

<@greet/>

l 参数

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

<#macro greet person>

  <font size="+2">Hello ${person}!</font>

</#macro>

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

<@greet person="Fred"/> and <@greet person="Batman"/>

输出结果是：

  <font size="+2">Hello Fred!</font>

 and   <font size="+2">Hello Batman!</font>

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

<@greet person=Fred/>

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

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

<#macro greet person color>

  <font size="+2" color="${color}">Hello ${person}!</font>

</#macro>

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

<@greet person="Fred" color="black"/>

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

<@greet color="black" person="Fred"/>

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

<@greet person="Fred" color="black" background="green"/>

<@greet person="Fred"/>

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

<#macro greet person color="black">

  <font size="+2" color="${color}">Hello ${person}!</font>

</#macro>

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

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

l 嵌套内容

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

Ø 例子：

<#macro border>

  <table border=4 cellspacing=0 cellpadding=4><tr><td>

    <#nested>

  </tr></td></table>

</#macro>

这样使用该宏变量：

<@border>The bordered text</@border>

输出结果：

  <table border=4 cellspacing=0 cellpadding=4><tr><td>

    The bordered text

  </tr></td></table>

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

<#macro do_thrice>

  <#nested>

  <#nested>

  <#nested>

</#macro>

<@do_thrice>

  Anything.

</@do_thrice>

输出结果：

  Anything.

  Anything.

  Anything.

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

<@border>

  <ul>

  <@do_thrice>

    <li><@greet person="Joe"/>

  </@do_thrice>

  </ul>

</@border>

输出结果：

  <table border=4 cellspacing=0 cellpadding=4><tr><td>

      <ul>

    <li><font size="+2">Hello Joe!</font>

    <li><font size="+2">Hello Joe!</font>

    <li><font size="+2">Hello Joe!</font>

  </ul>

  </tr></td></table>

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

<#macro repeat count>

  <#local y = "test">

  <#list 1..count as x>

    ${y} ${count}/${x}: <#nested>

  </#list>

</#macro>

<@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")}</@repeat>

输出结果：

    test 3/1: ? ? ?

    test 3/2: ? ? ?

    test 3/3: ? ? ?

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

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

Ø 例子：

<#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>

</@repeat>

输出结果：

  1. 0.5

  2. 1

  3. 1.5

  4. 2 Last!

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

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

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

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

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

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