| Blog信息 |
|
blog名称:
日志总数:1304
评论数量:2242
留言数量:5
访问次数:7648213
建立时间:2006年5月29日 |
| |
|
 [FreeMarker]FreeMarker设计指南(3)
软件技术
lhwork 发表于 2006/9/5 18:07:36 |
| 3、模板（1）整体结构l 模板使用FTL（FreeMarker模板语言）编写，是下面各部分的一个组合：? 文本：直接输出? Interpolation：由${和}，或#{和}来限定，计算值替代输出? FTL标记：FreeMarker指令，和HTML标记类似，名字前加#予以区分，不会输出? 注释：由<#--和-->限定，不会输出l 下面是以一个具体模板例子：<html>[BR]<head>[BR] <title>Welcome!</title>[BR]</head>[BR]<body>[BR] <#-- Greet the user with his/her name -->[BR] <h1>Welcome ${user}!</h1>[BR] <p>We have these animals:[BR] <ul>[BR] <#list animals as being>[BR] <li>${being.name} for ${being.price} Euros[BR] </#list>[BR] </ul>[BR]</body>[BR]</html> l [BR]是用于换行的特殊字符序列l 注意事项：? FTL区分大小写，所以list是正确的FTL指令，而List不是；${name}和${NAME}是不同的? Interpolation只能在文本中使用? FTL标记不能位于另一个FTL标记内部，例如：<#if <#include 'foo'>='bar'>...</if>? 注释可以位于FTL标记和Interpolation内部，如下面的例子：<h1>Welcome ${user <#-- The name of user -->}!</h1>[BR]<p>We have these animals:[BR]<ul>[BR]<#list <#-- some comment... --> animals as <#-- again... --> being>[BR]... ? 多余的空白字符会在模板输出时移除（2）指令l 在FreeMarker中，使用FTL标记引用指令l 有三种FTL标记，这和HTML标记是类似的：? 开始标记：<#directivename parameters>? 结束标记：</#directivename>? 空内容指令标记：<#directivename parameters/>l 有两种类型的指令：预定义指令和用户定义指令l 用户定义指令要使用@替换#，如<@mydirective>...</@mydirective>（会在后面讲述）l FTL标记不能够交叉，而应该正确的嵌套，如下面的代码是错误的：<ul><#list animals as being> <li>${being.name} for ${being.price} Euros <#if use = "Big Joe"> (except for you)</#list></#if> <#-- WRONG! --></ul> l 如果使用不存在的指令，FreeMarker不会使用模板输出，而是产生一个错误消息l FreeMarker会忽略FTL标记中的空白字符，如下面的例子：<#list[BR] animals as[BR] being[BR]>[BR]${being.name} for ${being.price} Euros[BR]</#list > l 但是，<、</和指令之间不允许有空白字符（3）表达式l 直接指定值? 字符串n 使用单引号或双引号限定n 如果包含特殊字符需要转义，如下面的例子：${"It's \"quoted\" andthis is a backslash: \\"} ${'It\'s "quoted" andthis is a backslash: \\'} 输出结果是：It's "quoted" andthis is a backslash: \ It's "quoted" andthis is a backslash: \ n 下面是支持的转义序列：转义序列 含义\" 双引号(u0022)\' 单引号(u0027)\\ 反斜杠(u005C)\n 换行(u000A)\r Return (u000D)\t Tab (u0009)\b Backspace (u0008)\f Form feed (u000C)\l <\g >\a &\{ {\xCode 4位16进制Unicode代码n 有一类特殊的字符串称为raw字符串，被认为是纯文本，其中的\和{等不具有特殊含义，该类字符串在引号前面加r，下面是一个例子：${r"${foo}"}${r"C:\foo\bar"} 输出的结果是：${foo}C:\foo\bar ? 数字n 直接输入，不需要引号n 精度数字使用“.”分隔，不能使用分组符号n 目前版本不支持科学计数法，所以“1E3”是错误的n 不能省略小数点前面的0，所以“.5”是错误的n 数字8、+8、08和8.00都是相同的? 布尔值n true和false，不使用引号? 序列n 由逗号分隔的子变量列表，由方括号限定，下面是一个例子：<#list ["winter", "spring", "summer", "autumn"] as x>${x}</#list> 输出的结果是：winterspringsummerautumnn 列表的项目是表达式，所以可以有下面的例子：[2 + 2, [1, 2, 3, 4], "whatnot"]n 可以使用数字范围定义数字序列，例如2..5等同于[2, 3, 4, 5]，但是更有效率，注意数字范围没有方括号n 可以定义反递增的数字范围，如5..2? 散列（hash）n 由逗号分隔的键/值列表，由大括号限定，键和值之间用冒号分隔，下面是一个例子：{"name":"green mouse", "price":150}n 键和值都是表达式，但是键必须是字符串l 获取变量? 顶层变量： ${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头? 从散列中获取数据n 可以使用点语法或方括号语法，假设有下面的数据模型：(root) | +- book | | | +- title = "Breeding green mouses" | | | +- author | | | +- name = "Julia Smith" | | | +- info = "Biologist, 1923-1985, Canada" | +- test = "title" 下面都是等价的：book.author.namebook["author"].namebook.author.["name"]book["author"]["name"]n 使用点语法，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字是任意表达式的结果? 从序列获得数据：和散列的方括号语法语法一样，只是方括号中的表达式值必须是数字；注意：第一个项目的索引是0? 序列片断：使用[startIndex..endIndex]语法，从序列中获得序列片断（也是序列）；startIndex和endIndex是结果为数字的表达式? 特殊变量：FreeMarker内定义变量，使用.variablename语法访问l 字符串操作? Interpolation（或连接操作）n 可以使用${..}（或#{..}）在文本部分插入表达式的值，例如：${"Hello ${user}!"}${"${user}${user}${user}${user}"} n 可以使用+操作符获得同样的结果${"Hello " + user + "!"}${user + user + user + user}n ${..}只能用于文本部分，下面的代码是错误的：<#if ${isBig}>Wow!</#if><#if "${isBig}">Wow!</#if>应该写成：<#if isBig>Wow!</#if>? 子串n 例子（假设user的值为“Big Joe”）：${user[0]}${user[4]}${user[1..4]}结果是（注意第一个字符的索引是0）：BJig J l 序列操作? 连接操作：和字符串一样，使用+，下面是一个例子：<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>- ${user}</#list>输出结果是：- Joe- Fred- Julia- Katel 散列操作? 连接操作：和字符串一样，使用+，如果具有相同的key，右边的值替代左边的值，例如：<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>- Joe is ${ages.Joe}- Fred is ${ages.Fred}- Julia is ${ages.Julia} 输出结果是：- Joe is 30- Fred is 25- Julia is 18 l 算术运算? ＋、－、×、／、％，下面是一个例子：${x * x - 100}${x / 2}${12 % 10}输出结果是（假设x为5）：-752.52 ? 操作符两边必须是数字，因此下面的代码是错误的：${3 * "5"} <#-- WRONG! --> ? 使用+操作符时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串，例如：${3 + "5"} 输出结果是：35? 使用内建的int（后面讲述）获得整数部分，例如：${(x/2)?int}${1.1?int}${1.999?int}${-1.1?int}${-1.999?int}输出结果是（假设x为5）：211-1-1l 比较操作符? 使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等? =和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = "1">会引起错误? Freemarker是精确比较，所以对"x"、"x "和"X"是不相等的? 对数字和日期可以使用<、<=、>和>=，但不能用于字符串? 由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>? 另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=l 逻辑操作符? &&（and）、||（or）、!（not），只能用于布尔值，否则会产生错误? 例子：<#if x < 12 && color = "green"> We have less than 12 things, and they are green.</#if><#if !hot> <#-- here hot must be a boolean --> It's not hot.</#if> l 内建函数? 内建函数的用法类似访问散列的子变量，只是使用“?”替代“.”，下面列出常用的一些函数? 字符串使用的：n html：对字符串进行HTML编码n cap_first：使字符串第一个字母大写n lower_case：将字符串转换成小写n upper_case：将字符串转换成大写n trim：去掉字符串前后的空白字符? 序列使用的：n size：获得序列中元素的数目? 数字使用的：n int：取得数字的整数部分（如-1.9?int的结果是-1）? 例子（假设test保存字符串"Tom & Jerry"）：${test?html}${test?upper_case?html}输出结果是：Tom & JerryTOM & JERRY l 操作符优先顺序操作符组 操作符后缀 [subvarName] [subStringRange] . (methodParams)一元 +expr、-expr、!内建 ?乘法 *、 / 、%加法 +、-关系 <、>、<=、>=（lt、lte、gt、gte）相等 ==（=）、!=逻辑and &&逻辑or ||数字范围 ..（4）Interpolationl 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.0042$42.004,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 TimeTue, Apr 8, '03Tuesday, April 08, 2003, 09:24:44 PM (PDT)? 插入布尔值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：<#assign foo=true/>${foo?string("yes", "no")}输出结果是：yesl 数字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 --> |
|
|
回复:FreeMarker设计指南(3)
软件技术
xcvsd(游客)发表评论于2006/9/15 16:51:04 |
| 在学校图书馆
坐我对面的女孩
一种偶然
她不知道
我坐在她对面
以一种真实的欲望盯着她
从头到脚
胜过一本诗集
但她柔顺的头发略显干涩、枯黄
让我怀疑她某方面是否缺乏营养
她白晰的大腿略显红肿
让我怀疑她是否患一种与性有关的病
她丰满的胸部微微下垂
让我怀疑她是否是个产后的妇女
一个女孩
一个在校就读的女孩
是铁的事实还是这个时代的惯性
让我破天荒地羞辱了她
摘自：《成人文学》
|
|
» 1 »
|