Velocity 学习基本点
在VTL中有三种类型的references：变量(variables)、属性(properties)、方法(methods).
变量:
格式要求同java。
属性
$customer.Address
$purchase.Total
方法
? $customer.getAddress()
? $purchase.getTotal()
? $page.setTitle( “My Home Page” )
? $person.setAttributes( [“Strange”, “Weird”, “Excited”] )
reference的正是格式如下：
? ${mudSlinger}??????? 变量
? ${customer.Address}??? 属性
? ${purchase.getTotal()}??? 方法
$!{email},$!email
在VTL中使用$2.5这样的货币标识是没有问题得的，VTL不会将它错认为是一个reference，因为VTL中的reference总是以一个大写或者小写的字母开始。
Escaping valid VTL reference
VTL中使用“\”作为逃逸符。
例如：
? #set( $email = “foo” )
? $email
? \$email
? \\$email
? \\\$email
将render为：
? foo
? $email
? \foo
? \\$email
如果email变量没有被定义则
? $email
? \$email
? \\$email
? \\\$email
将被render为：
? $email
? \$email
? \\$email
? \\\$email
注意：VTL中未被定义的变量将被认为是一个字符串，所以以下例子：
? #set( $foo = “gibbous” )
? $moon = $foo
的输出结果是：
$moon = gibbous
Directives
Reference允许设计者使用动态的内容，而directive使得你可以应用java代码来控制你的显示逻辑，从而达到你所期望的显示效果。
? #set
? #set directive被用于设置一个reference的值。例如：
??? #set ( $primate = “monkey” )
??? #set ( $customer.Behavior = $primate )
赋值左侧的（LHS）必须是一个变量或者属性reference。右侧（RHS）可以是以下类型中一种：
l? 变量reference
l? String literal
l? 属性reference
l? 方法reference
l? number literal
l? ArrayList
下面是应用各种类型的RHS的例子：
? ＃set ( $monkey = $bill ) ##变量reference
? ＃set ( $monkey.Friend = “monica” ) ##String literal
? ＃set ( $monkey.Blame = $whitehouse.Leak )##属性reference
? ＃set ( $monkey.Plan = $spindoctor.weave($web) )##方法reference
? ＃set ( $monkey.Number = 123 )##Number literal
? ＃set ( $monkey.Say = [“Not”, $my, “fault”] )##ArrayList
注意：最后一个例子的取值方法为：$monkey.Say.get(0)
RHS也可以是一个简单的算术表达式：
? #set ( $value = $foo + 1 )
? #set ( $value = $bar -1 )
#set ( $value = $foo * $bar )
#set ( $value = $foo / $bar )
如果你的RHS是一个null，VTL的处理将比较特殊：它将指向一个已经存在的reference，这对初学者来讲可能是比较费解的。例如：
? #set ( $resut = $query.criteria(“name”) )
? The result of the first query is $result
? #set ( $resut = $query.criteria(“address”) )
? The result of the second query is $result
如果$query.criteria(“name”)返回一个“bill”，而$query.criteria(“address”)返回的是null，则显示的结果如下：
? The result of the first query is bill
? The result of the first query is bill
看看下面的例子：
? #set( $criteria = ["name", "address"] )
#foreach( $criterion in $criteria )
#set( $result = $query.criteria($criterion) )
? #if( $result )
? Query was successful
???? #end
#end
在上面的例子中，程序将不能智能的根据$result的值决定查询是否成功。在$result被#set后（added to the context），它不能被设置回null（removed from the context）。打印的结果将显示两次查询结果都成功了，但是实际上有一个查询是失败的。
为了解决以上问题我们可以通过预先定义的方式：
? #set( $criteria = [“name”, “address”] )
? #foreach( $criterion in $criteria )
??? #set( $result = false )
??? #set( $result = $query.criteria( $criterion ) )
??? #if( $result )
????? Query was successful
??? #end
? #end
? String Literals
? 当你使用#set directive，String literal封闭在一对双引号内。
??? #set ( $directoryRoot = “www” )
??? #set ( $templateName = “index.vm” )
??? #set ( $template = “$directoryRoot/$tempateName” )
??? $template
? 上面这段代码的输出结果为：www/index.vm
? 但是，当string literal被封装在单引号内时，它将不被解析：
??? #set ( $foo = “bar” )
??? $foo
??? #set ( $blargh = ‘$foo’ )
? 结果：
??? bar
??? $foo
这里需要注意一点：Velocity context仅仅能够包含对象，所以当我们说“boolean”时实际上代表的时一个Boolean对象。
注意这里的Velocity的数字是作为Integer来比较的――其他类型的对象将使得条件为false，但是与java不同它使用“＝＝”来比较两个值，而且velocity要求等号两边的值类型相同。
include: #include script element允许模板设计者引入本地文件
parse: #parse script element允许模板设计者一个包含VTL的本地文件。
当将一个reference作为参数传递给Velocimacro时，请注意reference作为参数时是以名字的形式传递的。这就意味着参数的值在每次Velocimacro内执行时才会被产生。这个特性使得你可以将一个方法调用作为参数传递给Velocimacro，而每次Velocimacro执行时都是通过这个方法调用产生不同的值来执行的。例如：
? #macro ( callme $a )
??? $a $a $a
? #end
? #callme( $foo.bar() )
执行的结果是：reference $foo的bar（）方法被执行了三次。
如果你不需要这样的特性可以通过以下方法：
? #set ( $myval = $foo.bar() )
? #callme ( $myval )?
