国产99精品,成人久久久精品乱码一区二区三区,国产三线在线

阿姆斯壮 — Fri, 11 Mar 2005 03:08:00 GMT

用户定义指��o�Q��用@�W�合来调�?BR>有两�U�不同的�c�d��Q�Macro(�?和transform(传递器)�Q�Macro是在模板中��用macro指��o定义�Q�而transform是在模板外由�E�序定义(基本上都是基于Java�?�Q�这里通过Macro来介�l�自定义指��o�?BR>例一�Q?BR><#macro greet>
Hello Joe!

使用�Q?lt;@greet></@greet> �?<@greet/>
�l�果�Q?lt;font size="+2">Hello Joe!

参数�Q�在macro指��o中可以在宏变量之后定义参�?BR>例二�Q?BR><#macro greet person>
Hello ${person}!

使用�Q?lt;@greet person="Fred"/> and <@greet person="Batman"/>
�l�果�Q?Hello Fred! and Hello Batman!

macro可以有多个参敎ͼ�参数的次序是无关的，在macro指��o中只能��用定义的参数�Q��ƈ且必��d��所有参数赋��|��可以在定义参数时指定�~�省��|��

<#macro greet person color="black">
<font size="+2" color="${color}">Hello ${person}!font>
#macro>

在自定义指��o嵌套内容�Q�模板片断中使用<#nested>指��o

<#macro border>
  <table border=4 cellspacing=0 cellpadding=4>
    <#nested>
  tr>td>table>
#macro>

使用�Q?lt;@border>The bordered text</@border>
�l�果�Q?/P>

<table border=4 cellspacing=0 cellpadding=4>
><td>The bordered text
tr>td>table>

<#nested>指��o可以被多�ơ调用：

<#macro do_thrice>
  <#nested>
  <#nested>
  <#nested>
#macro>

使用�Q?BR><@do_thrice>Anything.</@do_thrice>
�l�果�Q?BR>Anything.
Anything.
Anything.

注意�Q�嵌套内�Ҏ��无法讉K��到macro中的局部变量的�?BR>例如�Q?/P>

<#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("?")}>

�l�果�Q?BR>test 3/1: ? ? ?
test 3/2: ? ? ?
test 3/3: ? ? ?

下面是一个嵌套��用自定义指��o的例子：

<@border>
  <ul>
  <@do_thrice>
    <li><@greet person="Joe"/>
  @do_thrice>
  ul>
@border>

�l�果�Q?/P>

<table border=4 cellspacing=0 cellpadding=4>
>
<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�?STRONG>使用循环变量�Q�作为nested指��o的参��C��递��@环变量的实际��|��而在调用用户定义指��o�Ӟ��?lt;@�?gt;开始标记的参数后面指定循环变量的名字：

<#macro repeat count>
  <#list 1..count as x>
    <#nested x, x/2, x==count>
  >
#macro>
<@repeat count=4 ; c, halfc, last>
  ${c}. ${halfc}<#if last> Last!#if>
/@repeat

�l�果�Q?BR>1. 0.5
2. 1
3. 1.5
4. 2 Last!

注意�Q��@环变量和用户定义指��o开始标记指定的数目可以不同�Q�调用时��指定��@环变量，则多指定的��g��可见�Q�调用时多指定��@环变量，多余的��@环变量不会被创徏�?BR>
模板中的变量�Q�有三种�c�d��Q?BR>1.) plain(全局)变量�Q�可以在模板的�Q何地方访问，包括使用include指��o插入的模板，使用assign指��o创徏和替�?BR>2.) 局部变�?/STRONG>�Q�在macro中有效，使用local指��o创徏和替�?BR>3.) 循环变量�Q�只能存在于指��o的嵌套内容，由指�?如list)自动创徏�Q�宏的参数是局部变量，而不是��@环变�?/P>

用assign指��o创徏和替换的例子�Q?/P>

<#assign x = 1> <#-- create variable x -->
${x}
<#assign x = x + 3> <#-- replace variable x -->
${x}

�l�果�Q?BR>1
4

局部变量隐�?而不是覆�?同名的plain变量�Q��@环变量隐藏同名的局部变量和plain变量�Q�下面是一个例子：

<#assign x = "plain">
1. ${x}  <#-- we see the plain var. here -->
<@test/>
6. ${x}  <#-- the value of plain var. was not changed -->
<#list ["loop"] as x>
    7. ${x}  <#-- now the loop var. hides the plain var. -->
    <#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here -->
    8. ${x}  <#-- it still hides the plain var. -->
#list>
9. ${x}  <#-- the new value of plain var. -->

<#macro test>
  2. ${x}  <#-- we still see the plain var. here -->
  <#local x = "local">
  3. ${x}  <#-- now the local var. hides it -->
  <#list ["loop"] as x>
    4. ${x}  <#-- now the loop var. hides the local var. -->
  #list>
  5. ${x}  <#-- now we see the local var. again -->
#macro>

�l�果�Q?BR>1. plain
2. plain
3. local
    4. loop
5. local
6. plain
    7. loop
    8. loop
9. plain2

内部循环变量隐藏同名的外部��@环变量，例如�Q?/P>

<#list ["loop 1"] as x>
  ${x}
  <#list ["loop 2"] as x>
    ${x}
    <#list ["loop 3"] as x>
      ${x}
    #list>
    ${x}
  #list>
  ${x}
#list>

�l�果�Q?BR>loop 1
    loop 2
      loop 3
    loop 2
loop 1

模板中的变量会隐藏（而不是覆盖）数据模型中同名变量，如果需要访问数据模型中的同名变量，使用�Ҏ��变量global�Q�下面的例子假设数据模型中的user的值是Big Joe�Q?/P>

<#assign user = "Joe Hider">
${user}          <#-- prints: Joe Hider -->
${.globals.user} <#-- prints: Big Joe -->

命名(namespaces)�I�间�Q�通常情况�Q�只使用一个命名空��_��U�Cؓ��d��名空�?main namespace)�Q�但你是不会意识到这些的�Q��ؓ了创建可重用的macro、transforms或其它变量的集合(通常�U�库)�Q�必��M��用多命名�I�间�Q��ؓ了防止同名冲�H��?/P>
首先创徏一个库(假设保存在lib/my_test.ftl�?�Q?/P>

<#macro copyright date>
  <p>Copyright (C) ${date} Julia Smith. All rights reserved.
  <br>Email: ${mail}p>
#macro>
<#assign mail = "jsmith@acme.com">

使用import指��o导入库到模板中，Freemarker会�ؓ导入的库创徏新的命名�I�间�Q��ƈ可以通过import指��o中指定的hash(散列)变量讉K��库中的变量：

<#import "/lib/my_test.ftl" as my>
<#assign mail="fred@acme.com">
<@my.copyright date="1999-2002"/>
${my.mail}
${mail}

�l�果�Q?/P>

<p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.
  <br>Email: jsmith@acme.comp>
jsmith@acme.com
fred@acme.com

上面的例子中使用的两个同名变量�ƈ没有冲突�Q�因为它们位于不同的命名�I�间

可以使用assign指��o在导入的命名�I�间中创建或替代变量�Q?/P>

<#import "/lib/my_test.ftl" as my>
${my.mail}
<#assign mail="jsmith@other.com" in my>
${my.mail}

�l�果�Q?BR>jsmith@acme.com
jsmith@other.com

数据模型中的变量��M��地方都可见，也包括不同的命名�I�间�Q�下面修改了刚才创徏的库�Q?/P>

<#macro copyright date>
  <p>Copyright (C) ${date} ${user}. All rights reserved.p>
#macro>
<#assign mail = "${user}@acme.com">

假设数据模型中的user变量的值是Fred�Q?/P>

<#import "/lib/my_test.ftl" as my>
<@my.copyright date="1999-2002"/>
${my.mail}

�l�果�Q?BR>
Copyright (C) 1999-2002 Fred. All rights reserved.

Fred@acme.com

参考：
            FreeMarker in sourceforge.net

阿姆斯壮 2005-03-11 11:08 发表评论

阿姆斯壮 — Fri, 11 Mar 2005 03:00:00 GMT

FreeMarker是一个用Java�~�写的模板引擎，主要用来生成HTML Web��面�Q�特别是��Z��MVC模式的应用程序。虽然FreeMarker��h��一些编�E�的能力�Q�但不像PHP�Q�通常由Java�E�序准备要显�C�的数据�Q�由FreeMarker模板生成��面�?nbsp; FreeMarker可以作�ؓWeb应用框架一个组�Ӟ��但它与容器无养I��在非Web应用�E�序环境也能工作的很好�?FreeMarker适合作�ؓMVC的视囄��Ӟ��q�能在模板中使用JSP标记库�?/P>

<html>
<head>
  <title>Welcome!title>
head>
<body>
  <h1>Welcome ${user}!h1>
  <p>Our latest product:
  <a href="${latestProduct.url}">${latestProduct.name}a>!
body>
html>

上面的例子中�Q�在��单的HTML中加入了一些由${…}包围的特定FreeMarker的指令，�q�个文�g��q��为模板了。而user、latestProduct.url和latestProduct.name来自于数据模型，由Java�E�序提供�Q�模板设计者就不用兛_��数据从哪来的�?/P>
FreeMarker模板中可以包括下面四�U�特定部分：
一.) 文本�Q�直接输�?BR>�?) FTL标记(FreeMarker模板语言标记)�Q�类��g��HTML标记�Q�名字前�?(有些以@开始，用户自定义标�?予以区分�Q�不会输出�?BR>字符�?/STRONG>�Q?使用单引��h��双引号限定；如果包含�Ҏ��字符需要�{义符�Q?{"It's \"quoted\" andthis is a backslash: \\"}
有一�cȝ��D�的字符�?${r"C:\foo\bar"}�Q�输出结构�ؓ�Q�C:\foo\bar�Q�在引号前面加r被认为是�U�文本�?
数字�Q�直接输入，不需要引受��?{08}, ${+8}, ${8.00} and ${8} 都是相同�?
布尔�?/STRONG>�Q�true和false�Q�不使用引号
Sequences(序列)�Q�由逗号分隔的变量列表，由方括号限定�Q�类似java中的一�l�数�l�：

<#list ["winter", "spring", "summer", "autumn"] as x>
${x}
#list>

输出�l�果�Q?BR>winter
spring
summer
autumn

例二�Q�[2 + 2, [1, 2, 3, 4], "whatnot"]
例三�Q?..5�Q�等同于[2, 3, 4, 5]�Q?..2�Q�等同于[5,4,3,2]。注意方括号是不需要的�?BR>
Hashes(散列)�Q�由逗号分隔的键-值列表，由大括号限定�Q�键和��g��间用冒号分隔�Q�{"name":"green mouse", "price":150}�Q�键和值都是表辑ּ��Q�但是键必须是字�W�串�?/P>
获取变量�Q?{variable}�Q�变量名只能是字母、数字、下划线�?、@�?的组合，且不能以数字开头。下列表辑ּ�是等��L��Q?BR>book.author.name
book["author"].name
book.author.["name"]
book["author"]["name"]

获取Sequence(序列)片断�Q��用[startindex..endindex]�Q�例如：seq中存储了"a", "b", "c", "d","e"�Q�那么seq[1..2]包含了b和c两个倹{�?BR>
可以使用.variablename语法讉K��FreeMarker内置变量�?/P>
字符串操�?/STRONG>
{"Hello ${user}!"} <==> ${"Hello " + user + "!"}
${"${user}${user}${user}${user}"} <==> ${user + user + user + user}

${…}只能在文本中使用�Q�下面是错误的代码：
<#if ${isBig}>Wow!
<#if "${isBig}">Wow! //此处的代码也是错误的�Q�因为if指��o需要的是boolean�Q�实际的却是个字�W�串

子字�W�串的操作，假设user的��gؓ"Big Joe"�Q?BR>${user[0]}${user[4]} <==> BJ
${user[1..4]} <==> ig J

Sequences(序列)操作

<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
- ${user}
#list>

�l�果�Q?BR>- Joe
- Fred
- Julia
- Kate

Hashes(散列)操作

<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
- Joe is ${ages.Joe}
- Fred is ${ages.Fred}
- Julia is ${ages.Julia}

�l�果�Q?BR>- Joe is 30
- Fred is 25
- Julia is 18

��术�q�算

<#-- x的��D��定�ؓ5 -->
${x * x - 100}
${x / 2}
${12 % 10}

�l�果�Q?BR>-75
2.5
2

注意�Q?操作�W�两边必��L��数字�Q��?+"�Ӟ��如果一�Ҏ��数字�Q�一�Ҏ��字符�Ԍ��׃��自动��数字�{换�ؓ字符丌Ӏ?BR>
使用内徏的指令int获得整数部分�Q?/P>

${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.1?int}
${-1.999?int}

�l�果�Q?BR>2
1
1
-1
-1

比较操作�W?/STRONG>�Q?lt;#if expression>...
1.)使用=�Q�或==�Q�完全相�{�）��试两个值是否相�{�，使用!= ��试两个值是否不相等
2.)=�?=两边必须是相同类型的��|��否则会��生错误，例如<#if 1 = "1">会引起错�?BR>3.)Freemarker是精��比较，所�?x"�?x "�?X"是不相等�?BR>4.)�Ҏ��字和日期可以使用<�?lt;=�?gt;�?gt;=�Q�但不能用于字符�?BR>5.)�׃��Freemarker会将>解释成FTL标记的结束字�W�，所以对�?gt;�?gt;=可以使用括号来避免这�U�情况，例如<#if (x > y)>�Q�另一�U�替代的�Ҏ��是，使用lt、lte、gt和gte来替�?lt;�?lt;=�?gt;�?gt;=

逻辑操作�W?/STRONG>�Q?amp;&(and)、||(or)�?(not)�Q�只能用于布��|��否则会��生错�?BR><#if x < 12 && color = "green">
We have less than 12 things, and they are green.

<#if !hot> <#-- here hot must be a boolean -->
It's not hot.

内置函数�Q�用法类��D��问hash(散列)的子变量�Q�只是��??"替代"."�Q�例如：user?upper_case
下面列出常用的一些函敎ͼ�
对于字符�?/U>
html�Q�对字符串进行HTML�~�码
cap_first�Q��字符串第一个字母大�?BR>lower_case�Q�将字符串�{换成��写
trim�Q�去掉字�W�串前后的空白字�W?BR>对于Sequences(序列)
size�Q�获得序列中元素的数�?BR>对于数字
int�Q�取得数字的整数部分�Q�如-1.9?int的结果是-1�Q?BR>
例一�Q?/P>

<#-- test的��gؓTom & Jerry -->
${test?html}
${test?upper_case?html}

�l�果�Q?BR>Tom & Jerry
TOM & JERRY

例二�Q?/P>

<#-- seasons的��gؓ"winter", "spring", "summer", "autumn" -->
${seasons?size}
${seasons[1]?cap_first} <#-- left side can by any expression -->
${"horse"?cap_first}

�l�果�Q?BR>4
Spring
Horse

�Ҏ��的调�?/STRONG>
${repeat("What", 3)}
${repeat(repeat("x", 2), 3) + repeat("What", 4)?upper_case}
�l�果�Q?BR>WhatWhatWhat
xxxxxxWHATWHATWHATWHAT

操作�W�优先顺�?/STRONG>
后缀            [subvarName] [subStringRange] . (methodParams)
一�?nbsp;           +expr�?expr�?
内徏           ?
乘法          *�?/ �?
加法          +�?
关系         <�?gt;�?lt;=�?gt;=�Q�lt、lte、gt、gte�Q?BR>相等            =�?=
逻辑            &&
逻辑          ||
数字范围      ..

�?) Interpolation�Q�由${...}�?{...}两种�c�d��Q�输��|��可以定义输出的格�?BR>例一�Q?/P>

<#setting number_format="currency"/>
<#assign answer=42/>
${answer}
${answer?string}  <#-- the same as ${answer} -->
${answer?string.number}
${answer?string.currency}
${answer?string.percent}

�l�果�Q?BR>$42.00
$42.00
42
$42.00
4,200%

例二�Q?/P>

${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')'")}

�l�果�Q?BR>2003-04-08 21:24:44 Pacific Daylight Time
Tue, Apr 8, '03
Tuesday, April 08, 2003, 09:24:44 PM (PDT)

例三�Q?/P>

<#assign foo=true/>
${foo?string("yes", "no")}

�l�果�Q?BR>yes

例四�Q?/P>

<#-- x is 2.582 and y is 4 -->
#{x; M2}   <#-- 2.58 -->
#{y; M2}   <#-- 4    -->
#{x; m1}   <#-- 2.6 -->
#{y; m1}   <#-- 4.0 -->
#{x; m1M2} <#-- 2.58 -->
#{y; m1M2} <#-- 4.0  -->

说明�Q�mX�Q�小数部分最��X位；MX�Q�小数部分最大X位�?/P>
�?) 注释�Q?lt;#--�?->

下面是一个常用的模板例子�Q?/P>

<p>We have these animals:
<table border=1>
  ><th>Name<th>Price
  <#list animals as being>
  <tr>
    <td>
      <#if being.size = "large"><b>#if>
      ${being.name}
      <#if being.size="large">b>#if>
    <td>${being.price} Euros
  #list>
table>
<#include "/copyright_footer.html">

注意�?/STRONG>�Q?BR>1.) FreeMarker是区分大��写的；
2.) FTL标记不能位于另一个FTL标记内部�Q�例如：<#if <#include 'foo'>='bar'>...�Q?BR>3.) ${…}只能在文本中使用�Q?BR>4.) 多余的空白字�W�会在模板输出时去除�Q?BR>5.) 如果使用的指令不存在�Q�会产生一个错误消息�?/P>

参考：
              FreeMarker in sourceforge.net

阿姆斯壮 2005-03-11 11:00 发表评论