首页 > JAVA框架 > FreeMarker（一）

FreeMarker（一）

2007年7月29日
评论 发表评论
前人关于FreeMarker 的总结
         一宗罪：freemarker的变量必须有值，没有被赋值的变量就会抛出异常，那个黄黄的freemarker出错页面，真是让人看了太难过了。
         freemarker的FAQ上面冠冕堂皇的说，未赋值的变量强制抛错可以杜绝很多潜在的错误，如缺失潜在的变量命名，或者其他变量错误。但是实际的效果是：带来的是非常大的编程麻烦，程序里面几乎所有可能出现空值的变量统统需要加上${xxx?if_exists}，有些循环条件还需要写if判断，这样不但没有杜绝应该杜绝的错误，反而极大增加了编程的麻烦。
         二宗罪：freemarker的map限定key必须是string，其他数据类型竟然无法操作！这一点就不讲了，JavaEye上面已经有人抱怨过了。连Webwork的开发人员Pat Lightboy都在抱怨这一点。
         三宗罪：freemarker为了编程方便把不可序列化的东西往session里面放！
freemarker支持在页面里面直接操作Session，request等，例如${Session[...]}，方便确实很方便，但是一旦需要做群集，就会报错。
         但是这些小错误，个人认为无伤大雅，毕竟WebWork开发小组就是用FreeMaker的,那么我们在项目的时候肯会接触到 .ftl 文件，所以花几个单位时间学习下，还是必要的

 

 
现在来看看FreeMaker有哪些变量
  • Strings: "Foo" or ‘Foo’ or "It’s \"quoted\"" or  r"C:\raw\string" 最后一种用法要注意
  • Numbers: 123.45
  • Booleans: true, false
  • Sequences: ["foo", "bar", 123.45],   1..100
  • Hashes: {"name":"green mouse", "price":150} 这里注意，lookup name必须是String

下面来看看关于 String，Sequence，Hash的操作方法
 
有一种很典型的用法错误<#if ${isBig}>Wow!</#if>,
Interpolations work only in text sections (e.g. <h1>Hello ${name}!</h1>) and in string literals
 (e.g. <#include "/footer/${company}.html">)
you should use the substring built-in; 里面关于String的处理应该是应有尽有了。
 
这里有几个关于Sequence的例子，值得看一下
 
<#assign x = ["red", 16, "blue", "cyan"]>
"blue": ${x?seq_contains("blue")?string("yes", "no")}
"yellow": ${x?seq_contains("yellow")?string("yes", "no")}
16: ${x?seq_contains(16)?string("yes", "no")}
"16": ${x?seq_contains("16")?string("yes", "no")} 
The output will be:
"blue": yes
"yellow": no
16: yes
"16": no 
 
seq_index_of
 
seq_last_index_of 
 
还发现里面居然有排序功能
 
     
 
<#assign ls = ["whale", "Barbara", "zeppelin", "aardvark", "beetroot"]?sort>
<#list ls as i>${i} </#list> 
 
 
     
 
<#assign ls = [
 {"name":"whale", "weight":2000},
 {"name":"Barbara", "weight":53},
 {"name":"zeppelin", "weight":-200},
 {"name":"aardvark", "weight":30},
 {"name":"beetroot", "weight":0.3}
]>
Order by name:
<#list ls?sort_by("name") as i>
- ${i.name}: ${i.weight}
</#list>
 
Order by weight:
<#list ls?sort_by("weight") as i>
- ${i.name}: ${i.weight}
</#list> 
 
 
最后还有一个函数非常之实用
 
<#assign seq = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j']>
 
<#list seq?chunk(4) as row>
 <#list row as cell>${cell} </#list>
</#list>
 
<#list seq?chunk(4, ‘-’) as row>
 <#list row as cell>${cell} </#list>
</#list> 
The output will be:
 
 a b c d
 e f g h
 i j
 
 a b c d
 e f g h
 i j - -
 
 
想想以前写网上商城购物系统的时候，从数据库里出来的数据都要把它们转换成几行几列的样子，算法都是自己写的，这种时代要过去了，呵呵
 
Concatenation: passwords + {"joe":"secret42"}  这个没什么好说的了，就一个Concatenation
 

 
· Arithmetical calculations: (x * 1.5 + 10) / 2 - y % 100 有5个运算符
· Comparison: x == y, x != y, x < y, x > y, x >= y, x <= y, x &lt; y, …etc.  因为FreeMarker无法区分大于号和结尾符>的区别，所以最好用括号括起来
· Logical operations: !registered && (firstVisit || fromEurope)
· Method call: repeat("What", 3)
·  White-space in expressions   FTL ignores superfluous white-space in expressions
·  Operator precedence  下面是运算符的优先权

Operator group

Operators

postfix operators

[subvarName] [subStringRange] . ? (methodParams) expr!default expr! expr??

unary operators

+expr -expr !expr

multiplicative

* / %

additive

+ -

relational

< > <= >= (and quivalents: gt, lt, etc.)

equality

== != (and equivalents: =)

logical AND

&&

logical OR

||

numerical range

..

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)
 
 
<#list 1..8 as x>   注意不要写成 [1..8]
    ${x}<br>
</#list> 
 
/*—————–以下会出错——————–*/
 
<#list ["aa",3,true] as x>
    ${x}<br>
</#list> 
 
<#list ["aa",3,[1,2]] as x>
    ${x}<br>
</#list> 
 
Expecting a string, date or number here, Expression x is instead a freemarker.template.TemplateBooleanModel$2
可见，list中只能是string, date or number
 
/*———————————————-*/
 

JAVA框架

  1. 目前还没有任何评论.
  1. 目前还没有任何 trackbacks 和 pingbacks.